Skip to main content
POST
Generate video with FLUX 3 Video

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 (a line in quotes is spoken). When extending, describe what happens next, not the source.

aspect_ratio
enum<string>
default:16:9

Aspect ratio for text-to-video. With image or video the picture sets the shape and this is ignored.

Available options:
16:9,
9:16,
1:1,
4:3,
3:4,
21:9,
2:1,
9:21
end_image
string

Optional last frame, used together with image: the video moves from the first frame to this one. Same input forms as image.

generate_audio
boolean
default:true

Generate sound with the video (default true; no price impact). false makes a silent clip.

image
string

Optional first frame for image-to-video; the video starts from it and follows its shape. Provide a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Can't be combined with video.

length_seconds
integer
default:5

Video length in seconds, any whole number from 5 to 20. When extending, the seconds of NEW footage, 5 to 15.

Required range: 5 <= x <= 20
resolution
enum<string>
default:720p

Output resolution: 720p (1280x704 at 16:9), 1080p (1920x1088), 1440p (2560x1440) or 4k (3840x2176). Sets the price per second, see mode_pricing in GET /v1/models.

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

Optional video to EXTEND (MP4 or MOV, 1 second to 2 minutes, up to 100MB). The model continues it from its last frames for length_seconds of new footage guided by prompt, and the result is the source followed by the continuation, at the chosen resolution. Provide a public video URL or an uploaded-file URL from POST /v1/uploads. Can't be combined with image/end_image. Only the new seconds are billed, at the extend rate.

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