POST
Create a drama

Authorizations

Authorization
string
header
required

Provide your API key in the Authorization header using Bearer auth

Headers

Idempotency-Key
string

Body

application/json

Request to create a drama. Provide prompt, script or both.

text_model
string
required

Text model (understand, story, storyboard)

Minimum string length: 1
Example:

"openai/gpt-5.4"

image_model
string
required

Image model (reference images, keyframes, poster)

Minimum string length: 1
Example:

"openai/gpt-image-2"

video_model
string
required

Video model (clips); must support the aspect ratio

Minimum string length: 1
Example:

"bytedance/seedance-1.5-pro"

prompt
string

One-sentence brief (genre, characters, style…)

Maximum string length: 20000
Example:

"重生回到高考前一天的女孩,决定改写全家人的命运"

script
string

Script text: the drama is adapted from it

Maximum string length: 100000
style
string

Visual style, such as "cinematic realism" or "anime"

Maximum string length: 2000
Example:

"都市逆袭,节奏快,暖色调"

aspect_ratio
string

Aspect ratio: 9:16 (default, portrait) or 16:9 (landscape)

Example:

"9:16"

resolution
string

Resolution: 480p / 720p (default) / 1080p

Example:

"720p"

language
string

Language of dialogue: zh / en; detected from the prompt or script when omitted

Example:

"zh"

episodes
integer<int32>

Planned number of episodes (1–100, default 1)

Required range: 1 <= x <= 100
Example:

3

episode_seconds
integer<int32>

Episode length in seconds (30–300, default 60)

Required range: 30 <= x <= 300
Example:

60

image_quality
string

Image quality (when the model supports it)

Example:

"high"

web_research
boolean

Research the web while understanding the brief (when the text model supports it)

auto_confirm
boolean

Continue automatically after each step instead of waiting for confirmation

auto_continue
boolean

Start the next episode automatically when one is completed

budget_usd
number

Budget for episode 1 in USD; the run pauses when it would be exceeded

Required range: x >= 0
Example:

20

end_user
string

End-user identifier

Maximum string length: 128
Example:

"user_42"

metadata
object

Your metadata (up to 16 keys)

Response

OK

A drama (POST /v1/dramas, GET /v1/dramas/{id}).

id
string

ID (drama_ prefix)

Example:

"drama_0192f1c3a7b87c3e9a4f5b6c7d8e9f01"

object
string

Object type

Example:

"drama"

status
enum<string>

Status: draft / producing / completed / archived

Available options:
draft,
producing,
completed,
archived
Example:

"producing"

source
enum<string>

Source: ai (written from the brief) / script (adapted from a script)

Available options:
ai,
script
Example:

"ai"

title
string

Title (available after understand or the outline)

aspect_ratio
string

Aspect ratio

Example:

"9:16"

resolution
string

Resolution

Example:

"720p"

language
string

Language

Example:

"zh"

planned_episodes
integer<int32>

Planned number of episodes

Example:

3

episode_seconds
integer<int32>

Episode length in seconds

Example:

60

models
object

Models used by the drama.

web_research
boolean

Whether the brief is researched on the web

auto_confirm
boolean

Whether each step continues automatically

auto_continue
boolean

Whether the next episode starts automatically

episodes
object[]

Episodes started so far

end_user
string

End-user identifier

metadata
object

Your metadata

created_at
integer<int64>

Creation time (Unix seconds)