API reference · Account
An idea written as a director's shot plan
POST/api/studio/directSigned in session
One chat call on the signed in account under strict JSON, billed like a chat turn (the free allowance for an account that never deposited, a hold and settlement for one that did), on ANTIMATTER_STUDIO_PLAN_MODEL or the cheapest priced model from a well known lab that declares JSON output. A title and shots, each with words, a camera move, a look, a length and a suggested video model. What it cost is in micros and x-antimatter-cost-micros, refused or not. Open while jobs are off. Same origin only.
Request body
application/json, required
| Field | Type | What it is |
|---|---|---|
| idearequired | string | The idea, a sentence or a paragraph. At most 4000 characters. |
| shots | integer | From 1 to 12. |
| seconds | number | Seconds a shot, when the person has a length in mind. |
| style | string | At most 500 characters. |
| aspect | string | One of "16:9", "9:16", "1:1". |
Example
{
"idea": "string"
}Answer 200
The plan.
| Field | Type | What it is |
|---|---|---|
| title | string | |
| shots | array of object | |
| shots[] | string | |
| shots[] | string | The shot as a video prompt, without its camera move. |
| shots[] | string or null | One of "push-in", "pull-out", "orbit", "crane-up", "dolly-zoom", "tracking", "handheld", "drone", "whip-pan", "static", null. |
| shots[] | string or null | A colour grade the shot takes in the cut. One of "teal-orange", "noir", "bleach", "dusk", "nebula", "film", "vivid", null. |
| shots[] | number | |
| shots[] | string or null | A video model the studio offers now that makes it from words alone. |
| shots[] | string | |
| micros | integer | |
| model | string | |
| modelName | string | The writer's name as a person reads it. |
Errors
- 400OpenAI shaped error.
- 401OpenAI shaped error.
- 402OpenAI shaped error.
- 403OpenAI 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.