Antimatter

POST/api/studio/projects/{id}/plans/quoteSigned in session

One total and each shot at its worst case, markup on, and whether the balance covers it; nothing is made or held. A 404 while video and sound jobs are switched off. The signed in account.

Parameters

Path and query parameters
Field	Type	What it is
id (path)required	string	The project's id, stp_ followed by hex.

Request body

application/json, required

Request body fields
Field	Type	What it is
shotsrequired	array of object
shots[].kindrequired	string	A clip, a sound, or a still: a picture for a shot to start from. One of "video", "sound", "still".
shots[].modelrequired	string
shots[].promptrequired	string
shots[].seconds	number
shots[].resolution	string
shots[].aspect_ratio	string
shots[].audio	boolean
shots[].image	string	The starting picture for a model whose input is image: an https URL, or a data:image/png, jpeg or webp base64 URL of at most 5242880 bytes decoded.
shots[].image_asset	string	A picture the account stored (sa_ followed by hex) to start from instead of image; sent to the provider as a data URL, never as a link to the store. For a talking still, a motion control, an upscale of a picture (enlarge) or a fill (inpaint), the still it starts from, which the provider fetches through a signed link on this origin that lapses after 30 minutes; an upscale or a fill is held from the still's own size, read from the file on the server.
shots[].references	array of string	Reference pictures a model keeps a subject from (a character's), or a still is made from, as many as the model takes (its references in the model list): each an https URL, a data:image URL, or a stored picture (sa_ followed by hex) sent as a data URL.
shots[].end_image	string	The last frame, for a model whose endFrame is true: a picture as references takes one.
shots[].negative_prompt	string
shots[].seed	integer
shots[].lyrics	string
shots[].camera	string or null	A camera move phrased into a video's prompt on the server. One of "push-in", "pull-out", "orbit", "crane-up", "dolly-zoom", "tracking", "handheld", "drone", "whip-pan", "static", null.
shots[].title	string
pictures	array of string	Starting pictures as data:image URLs, sent once: a shot's image may say picture:<index> to name one.

Example

{
  "shots": [
    {
      "kind": "video",
      "model": "antimatter/auto",
      "prompt": "Say hello in five words."
    }
  ],
  "pictures": [
    "string"
  ]
}

Answer 200

The quote.

Fields of the 200 answer
Field	Type	What it is
object	string	One of "studio.plan.quote".
total_micros	integer	Every shot at its worst case, a dearer provider of the same model included, markup on.
shots	array of object
shots[].index	integer
shots[].model	string
shots[].micros	integer
funded	boolean	Whether the balance covers the whole total now and the account ever deposited.
deposited	boolean	Whether the account ever deposited: only a deposited balance pays for a plan, never the free allowance.
balance_micros	integer

Errors

400OpenAI shaped error.
401OpenAI shaped error.
404OpenAI shaped error.
429OpenAI shaped error.

Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.