API reference · Account
The most a film from one idea could cost
POST/api/studio/film/quoteSigned in session
The plan's writing, every shot and the music at their worst cases, and whether the balance covers the total now. Titles and captions are free. Nothing is held or made.
Request body
application/json, required
| 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. | string | One of "model", "own", "none". |
| music. | 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 200
The quote.
| Field | Type | What it is |
|---|---|---|
| object | string | One of "studio.film.quote". |
| writing_micros | integer | The plan's writing at its worst case. |
| writer_model | string | |
| writer_name | string | |
| shot_micros | integer | One shot at its worst case, every shot the same. |
| shots | integer | |
| shot_seconds | number | |
| music_micros | integer | 0 for the person's own file or none. |
| music_seconds | number | |
| total_micros | integer | |
| funded | boolean | A deposit was made and the balance covers the total now. |
| deposited | boolean | |
| balance_micros | integer |
Errors
- 400OpenAI shaped error.
- 401OpenAI shaped error.
- 404OpenAI 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.