API reference · Account
The most rewriting a shot's words could cost
POST/api/studio/direct/refine/quoteSigned in session
The worst case of the rewrite's chat call as dispatch would hold it, billed micro USD; nothing is held and nothing is sent to a model.
Request body
application/json, required
| Field | Type | What it is |
|---|---|---|
| promptrequired | string | The shot's words as the person wrote them. At most 4000 characters. |
| modelrequired | string | The video model the shot will be made with. |
| camera | string or null | The shot's camera move, set apart from the words. One of "push-in", "pull-out", "orbit", "crane-up", "dolly-zoom", "tracking", "handheld", "drone", "whip-pan", "static", null. |
| seconds | number | |
| aspect | string | One of "16:9", "9:16", "1:1". |
| negative | string | What the take should not show. At most 2000 characters. |
Example
{
"prompt": "Say hello in five words.",
"model": "antimatter/auto"
}Answer 200
The worst case.
| Field | Type | What it is |
|---|---|---|
| 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.
- 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.