FLUX 3 Video
FLUX 3 Video Generation
- Asynchronous processing mode, returns a task ID for subsequent queries
- Unified entry: text-to-video / image-to-video / video continuation / draft two-step
- Output H.264 + AAC with synced audio, duration 5~20 seconds
- Resolution hd / fhd, seven aspect ratios
POST
Authorization
string
required
Generation Modes
flux-3-video is a unified entry: mode is inferred from fields, or set explicitly with mode.
mode values: t2v / i2v / v2v / draft_enhance, or official spellings text-to-video / image-continuation / video-continuation. Explicit mode has highest priority.
Image-to-video keyframe semantics
Order inimage_urls is semantic — do not sort or dedupe:
Request Parameters
string
required
Fixed value:
flux-3-videostring
required
Prompt. Must not be sent when using
draft_from_task_id (rejected if present).integer
default:"5"
Duration in seconds, integer 5~20, default
5For video continuation, the delivered duration may be shorter than requested (e.g. request 5s, get 4s). The request is pre-charged for the requested seconds and the difference is refunded after completion; final amount is query
cost. Text/image-to-video do not show this gap.string
default:"hd"
Resolution
hd(default; also accepts720p)fhd(also accepts1080p)
hd ~1280×704 at 16:9; fhd ~1920×1088.string
default:"auto"
Aspect ratioOptions:
21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16, or auto (default; chosen automatically from the prompt and assets)string[]
Image-to-video keyframes, 1~10, public http(s) URL or base64
string
Input video for continuation (mp4, public URL or base64)
string[]
Same as
video_url; uses the first item (compat)boolean
default:"true"
Generate synced audio, default
true. false yields silent video (no discount)boolean
default:"false"
Draft mode: ~1/3 price low-quality preview; only with
resolution: hdstring
Draft → final: ID of your successful draft task
- Only
resolutionmay change; prompt, duration, images, video cannot - Charged at full final price; draft fee is not credited
- Mutually exclusive with
draft:true
integer
default:"2"
Moderation tolerance 0~4, default
2 (higher = more permissive)Do not confuse with FLUX.2 images (05) or Kontext (06).
string
Explicit mode (optional); see Generation Modes
Draft Mode
Two-step workflow when iterating is expensive:Create draft
Draft to final
Request Examples
Text-to-video (portrait)
Image-to-video (start + end frame)
Video continuation
Silent video
Constraints
Common submit errors (usually not charged)
Moderation failures end as
failed with full refund.
Capability Coverage
Response
integer
Status code; 200 on success
array
Response data array
Query resultsVideo generation is async. Poll Get Task Status.Recommended interval 5~10 seconds; client timeout 15 minutes (20s fhd is slower). Measured ~60s for
t2v + hd + 5s.On success use result.videos[0].url; assets are mirrored to the platform CDN. cost is the final charge. Failures are fully refunded.