Skip to main content
POST
Generate video with SeeDance 2.0

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
prompt
string
required

Text description of the video.

aspect_ratio
enum<string>
default:16:9

Aspect ratio. Ignored when an input image or video already sets the frame.

Available options:
16:9,
9:16,
1:1,
4:3,
3:4,
21:9
audio
string

Optional reference audio (MP3/WAV/OGG) for the generated video. Provide a public audio URL or an uploaded-file URL from POST /v1/uploads (passed by URL, not inlined). Must accompany an image (image or reference_images) or a video input — audio can't be the only input.

end_image
string

Optional end frame, used together with image (the start frame) to interpolate the video between the two frames. Same input forms as image.

generate_audio
boolean

Generate audio with the video.

image
string

Optional start frame for image-to-video. Provide a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Omit for text-to-video.

length_seconds
integer
default:5

Video length in seconds (4–15).

Required range: 4 <= x <= 15
reference_images
string[]

Optional reference images that guide the generated video. Each item is a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Can't be combined with image/end_image (start/end frames). Up to 9 on their own (reference-images-to-video); may also accompany a video to guide a video-edit, in which case up to 6 are used.

Maximum array length: 9
resolution
enum<string>
default:720p

Output resolution. Pricing varies by resolution — see resolution_pricing in GET /v1/models.

Available options:
480p,
720p,
1080p,
4k
video
string

Optional input video for video-to-video editing (2-15s, ≤100MB). Provide a public video URL or an uploaded-file URL from POST /v1/uploads (videos are passed by URL, not inlined). When set, the request runs in video-edit mode; you may also pass reference_images (up to 6) and/or an audio track to guide the edit. Not combinable with image/end_image. Billed on the INPUT duration at half the output per-second rate in addition to the output — estimate via POST /v1/cost.

Response

Job accepted.

id
string

Opaque job id — use it to poll status.

message
string
model
string
status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout