Antimatter

POST/api/studio/filmSigned in session

Holds the shots' and the music's total whole, writes the plan with a chat model billed to the account (its cost in x-antimatter-cost-micros), then makes the shots and the music as one render plan under that hold. Any refusal before the plan stands releases the hold and nothing is made. The browser lays the cut once every take has landed. Same origin only.

Request body

application/json, required

Request body fields
Field	Type	What it is
idearequired	string	The idea, a sentence or a paragraph. At most 4000 characters.
shotsrequired	integer	From 1 to 12.
secondsrequired	number	Seconds a shot, held to the model's own lengths.
modelrequired	string	The video model every shot is made on: one that makes a shot from words alone.
style	string	At most 500 characters.
aspectrequired	string	One of "16:9", "9:16", "1:1".
musicrequired	object	Made by a priced music model ({kind: model, model}), the person's own file ({kind: own}) or none.
music.kindrequired	string	One of "model", "own", "none".
music.model	string
project_id	string	The account's id of the film it is made in, stp_ followed by hex (POST only).

Example

{
  "idea": "string",
  "shots": 1,
  "seconds": 0,
  "model": "antimatter/auto",
  "aspect": "16:9",
  "music": {
    "kind": "model",
    "model": "antimatter/auto"
  }
}

Answer 201

The plan as written and the render plan making it.

Fields of the 201 answer
Field	Type	What it is
object	string	One of "studio.film".
title	string
shots	array of object
shots[].title	string
shots[].prompt	string
shots[].camera	string or null
shots[].look	string or null
shots[].seconds	number
shots[].model	string or null
shots[].voiceover	string
music_prompt	string or null
music_seconds	number
writing_micros	integer	Billed micro USD of the writing, every attempt counted.
writer_model	string
writer_name	string
plan	object
plan.id	string
plan.object	string	One of "studio.plan".
plan.project_id	string
plan.status	string	One of "running", "completed", "cancelled".
plan.quote_micros	integer	The total the balance was checked against.
plan.micros	integer	Settled shots' charges plus running shots' holds.
plan.counts	object
plan.shots	array of object
plan.shots[].id	string
plan.shots[].object	string	One of "studio.shot".
plan.shots[].index	integer
plan.shots[].title	string or null
plan.shots[].model	string
plan.shots[].status	string	One of "waiting", "starting", "running", "completed", "failed", "cancelled".
plan.shots[].micros	integer	The quote while it waits, the job's hold while it runs, the charge once done.
plan.shots[].job_id	string or null
plan.shots[].job	object or null	The shot's job, as /api/studio/jobs answers it.
plan.shots[].error	object or null
plan.shots[].error.code	string
plan.shots[].error.message	string
plan.shots[].created_at	integer
plan.shots[].started_at	integer or null
plan.shots[].finished_at	integer or null
plan.created_at	integer
plan.finished_at	integer or null
music_index	integer or null	The plan's index of the music.

Errors

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