Skip to main content
POST
Generate video with SeeDance 2.0

SeeDance 2.0 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. 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. 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 reference_images, reference_videos or a video input — audio can't be the only input, and it can't be combined with image/end_image (start/end frames): to pair a picture with audio, pass the picture in reference_images. Counts toward the 3 audio clips; pass more in reference_audios.

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_audios
string[]

Optional reference audio clips (up to 3 in all, audio included; each 2-15s, 15s combined; WAV/MP3) that guide sound and voice. Must accompany a reference image or video — audio can't be the only input. Each item is a public audio URL or an uploaded-file URL from POST /v1/uploads. Free. Can't be combined with image/end_image.

Maximum array length: 3
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, with or without a video to edit.

Maximum array length: 9
reference_videos
string[]

Optional reference video clips (up to 3 in all — a video to edit counts as one; each 2-15s, 15s combined; MP4/MOV, ≤50MB each) for motion, camera and identity guidance, addressed in the prompt by order as "Video 1", "Video 2" (a video to edit is "Video 1"). 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 at half the output per-second rate in addition to the output — estimate via POST /v1/cost. Can't be combined with image/end_image.

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

Output resolution. Pricing varies by resolution — see resolution_pricing in GET /v1/models. 4K output is H.265 (HEVC) 10-bit; 480p, 720p and 1080p are H.264.

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 and the video is "Video 1"; you may also pass reference_images (up to 9), up to 2 more reference_videos (15s in all with this one) and up to 3 audio clips (audio plus reference_audios) 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.

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