Introduction
FLUX 3 Text to video is Black Forest Labs' video model, with its API opening on 4 August 2026. It turns a written prompt into a clip of 5 to 20 seconds with synchronized sound, at 720p or 1080p in seven shapes, and has a fast draft tier for checking a shot at the lowest price.
Choose a mode by starting material
| What you have | Mode |
|---|---|
| a written brief | FLUX 3 Text to video |
| a still to animate, with an optional last frame | FLUX 3 Image to video |
| a clip to continue | FLUX 3 Video extend |
| a clip to enlarge | FLUX 3 Video upscale |
Key features & highlights
Picture and sound together
Sound is generated in the same pass as the picture. Quoted dialogue matched our prompts word for word, and a Sound: line steers ambient noise such as rain or footsteps. Switching sound off costs the same.
Draft tier
Draft is a fast, lower-cost preview, always at 720p. Detail is softer than standard, but it is enough to judge framing, action and mood before the full render.
Billed per second
Price follows length and tier: draft is the lowest, then standard 720p, then standard 1080p. The aspect ratio and the sound setting do not change it, and refused or failed requests are not charged.
Request parameters
| Parameter | Required | Description |
|---|---|---|
prompt | Yes | Up to 5,000 characters. Describe the subject, action, camera, light and sound; add a Sound: line for ambient noise and put spoken words in quotes. at least 1 characters ยท at most 5000 characters |
aspect_ratio | No | One of 16:9 (default), 9:16, 1:1, 4:3, 3:4, 21:9 or 2:1. The shape does not change the price. |
quality | No | standard (default) renders at the resolution you choose; draft is a fast, lower-cost preview that is always 720p. It changes the price: draft is the lowest tier. |
resolution | No | 720p (default) or 1080p. 1080p costs more. |
duration_seconds | No | Length in whole seconds, 5 to 20; 5 by default. Billed per second, so it sets the price together with the tier. |
generate_audio | No | Generate synchronized sound with the picture. On by default; off gives a silent file. Default: |
Pricing
Billed per second of video, by tier: draft is the lowest, then standard 720p, then standard 1080p. Sound on or off costs the same, and the aspect ratio does not change the price. Refused and failed requests are not charged.
| Resolution | Quality: Draft | Quality: Standard |
|---|---|---|
| $0.06 / second | $0.29 / second |
| $0.06 / second | $0.17 / second |
Use cases
Dialogue and mood scenes
One character, one line, a room sound and a slow camera move.
Storyboards
Preview each shot at draft, then re-render the ones you keep.
Social and vertical clips
9:16 and 1:1 are built in, and 21:9 and 2:1 cover wide cinematic frames.
Prompt guide & pro tips
Write it like a shot
Subject and wardrobe, setting, action, camera move, light, then a final line starting with Sound:.
Quote the dialogue
Put spoken words in quotes, in the language you want to hear.
One action per clip
A single clear action and camera move holds together best; large changes in light or place can make the model cut or dissolve.
Draft first
Get the framing right at draft, then run the same prompt at standard.
Keep expectations on content
Only Mild-level looks render; anything stronger is refused and not charged.
API quick start
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-3/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"quality": "standard",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
See the API reference for authentication, the complete schema, polling, and error handling.


























