Skip to main content
POST
Generate video with SeeDance 2.5

SeeDance 2.5 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
aspect_ratio
enum<string>
default:16:9

Output aspect ratio for text-to-video and reference-to-video. Ignored with a start frame (image): the video keeps the frame's shape. With reference_videos, a ratio you send sets the output's shape; leave it out and the model picks one (adaptive). A job the model reads as an edit or an extension of a reference clip keeps that clip's shape instead.

Available options:
16:9,
9:16,
1:1,
4:3,
3:4,
21:9
draft
boolean

Make a 480p draft, priced like any 480p video (150 credits/sec, plus 80/sec of reference-video input). Within 7 days, send its job id as from_draft_job_id to render the same video at 1080p: the same motion, framing and sound, sharper. Leave resolution out.

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.

from_draft_job_id
string

Render the 1080p final of one of your succeeded drafts, within 7 days of it: the draft job's id (a draft made with draft, over MCP or in the Video Workshop). Send it with no other parameters (the draft's own prompt may come along): the final reuses the draft's prompt, inputs, length, aspect ratio, seed and audio setting. Priced as a 1080p video of the draft's length (750 credits/sec) plus the draft's reference-video input at 375/sec; POST /v1/cost quotes it. GET /v1/videos/{id} on the draft says whether it can still be finalized (draft_finalizable), until when (draft_expires_at) and the final's standard price (draft_final_credits).

generate_audio
boolean

Generate audio with the video (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
prompt
string

Text description of the video. Required, except with from_draft_job_id (a final reuses its draft's prompt). Write @handle to cast a character: a BudgetPixel AI influencer or one of your own (GET /v1/characters).

reference_audios
string[]

Optional reference audio clips (up to 10; 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: 10
reference_images
string[]

Optional reference images (up to 30, 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: 30
reference_videos
string[]

Optional reference video clips (up to 10; 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 in addition to the output, by the output resolution: 80/sec at 480p, 160/sec at 720p, 375/sec at 1080p, 750/sec at 4k — estimate via POST /v1/cost. Can't be combined with image/end_image.

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

Output resolution. Pricing varies by resolution — see resolution_pricing in GET /v1/models. 4k is 3840x2160 at 16:9 (2160x3840 at 9:16, 2880x2880 square). A draft (draft) is always 480p and its final 1080p: leave resolution out for both. 1080p and 4K output is H.265 (HEVC) 10-bit; 480p and 720p are H.264.

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

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