Antimatter

POST/v1/studio/projects/{id}/plansAPI key

The quoted total is held whole in one conditional step, so either the whole batch is held and the plan starts or nothing is held or made (402 plan_unfunded when the balance falls short). Each shot then runs as its own job whose hold moves out of the plan's, a few at a time per account, the rest waiting for a slot; what is left of the plan's hold is released when it closes. A balance only, never the free allowance; a freeze and the monthly cap apply, checked again as each shot starts. A 404 while video and sound jobs are switched off. An API key with the chat scope (a write or a spend). Rate limited per key at the key's own requests a minute, in a window of its own. An agent's key is refused (403 policy_violation). Every /v1/studio door is a 404 while video and sound jobs are switched off.

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 201

The plan, running.

Fields of the 201 answer
Field	Type	What it is
id	string
object	string	One of "studio.plan".
project_id	string
status	string	One of "running", "completed", "cancelled".
quote_micros	integer	The total the balance was checked against.
micros	integer	Settled shots' charges plus running shots' holds.
counts	object
shots	array of object
shots[].id	string
shots[].object	string	One of "studio.shot".
shots[].index	integer
shots[].title	string or null
shots[].model	string
shots[].status	string	One of "waiting", "starting", "running", "completed", "failed", "cancelled".
shots[].micros	integer	The quote while it waits, the job's hold while it runs, the charge once done.
shots[].job_id	string or null
shots[].job	object or null	The shot's job, as /api/studio/jobs answers it.
shots[].error	object or null
shots[].error.code	string
shots[].error.message	string
shots[].created_at	integer
shots[].started_at	integer or null
shots[].finished_at	integer or null
created_at	integer
finished_at	integer or null

Errors

400OpenAI shaped error.
401OpenAI shaped error.
402OpenAI shaped error.
403OpenAI 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.

Try it

The same call with curl

curl -X POST https://useantimatter.com/v1/studio/projects/{id}/plans \
  -H "Authorization: Bearer $ANTIMATTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"shots":[{"kind":"video","model":"antimatter/auto","prompt":"Say hello in five words."}],"pictures":["string"]}'