Skip to main content
POST
Generate video with SeeDance 2.5 Flash

SeeDance 2.5 Flash on BudgetPixel

More examples, prompts and pricing.

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, including the sound you want. With reference videos, say what to do with them: edit or extend a clip, or take its motion or camera work. Write @handle to cast a character: a BudgetPixel AI influencer or one of your own (GET /v1/characters).

aspect_ratio
enum<string>
default:16:9

Aspect ratio for text-to-video. Ignored (adaptive) when a start frame or any reference media sets the frame.

Available options:
16:9,
9:16,
1:1,
4:3,
3:4,
21:9
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 (on unless set to false; no price impact).

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. Can't be combined with reference media.

length_seconds
integer
default:5

Output video length in seconds (4-30).

Required range: 4 <= x <= 30
reference_audios
string[]

Optional reference audio clips (up to 5; each 2-30s, 30s combined; WAV/MP3) that guide sound/voice. Audio-only input is supported. Each item is a public audio URL or an uploaded-file URL from POST /v1/uploads. Free — no input billing. Can't be combined with image/end_image.

Maximum array length: 5
reference_images
string[]

Optional reference images (up to 10, free) that guide identity/style in reference-to-video mode. 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.

Maximum array length: 10
reference_videos
string[]

Optional reference video clips (up to 5; each 2-30s — a clip the prompt edits 4-30s — 30s combined; MP4/MOV, ≤50MB each) for editing, extension, and motion/identity guidance. Each item is a public video URL or an uploaded-file URL from POST /v1/uploads (videos are passed by URL, not inlined). Billed on the INPUT duration (57/sec at 480p, 123/sec at 720p) in addition to the output — estimate via POST /v1/cost. Can't be combined with image/end_image.

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

Output resolution, 480p or 720p (no 1080p: seedance-2.5 has it). Pricing varies by resolution — see resolution_pricing in GET /v1/models.

Available options:
480p,
720p

Response

Job accepted.

characters
object[]

The characters the prompt cast with @handle mentions. Absent when none.

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