Skip to main content
POST

Authorization

string
required
All endpoints require Bearer Token authenticationGet your API Key from the API Key Management Page:

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 in image_urls is semantic — do not sort or dedupe:

Request Parameters

string
required
Fixed value: flux-3-video
string
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 5
duration: "auto" is not supported (billing needs a fixed second count). Omit, "auto", or non-integers → treated as 5 seconds without error and without adaptive length.
For 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 accepts 720p)
  • fhd (also accepts 1080p)
Measured: hd ~1280×704 at 16:9; fhd ~1920×1088.
Draft mode (draft:true) only allows hd.
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: hd
string
Draft → final: ID of your successful draft task
  • Only resolution may 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

Draft-to-final re-renders at full quality using the draft’s saved params (mode / prompt / seed / assets). Continuation drafts finalize at continuation final rates.

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.