black-forest-labs/flux-3/text-to-video
black-forest-labs/flux-3/text-to-video
FLUX 3 Text-to-Video generates cinematic 5-20 second videos from text prompts, with coherent motion, cinematic composition, optional synchronized audio, and 720P / 1080P output for creative videos, social content, ads, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Examples
Parameters
| Name | Type | Default | Constraints | Description |
|---|---|---|---|---|
| prompt *Prompt | textarea | — | ≤ 5000 chars | The text prompt describing the video you want to generate. |
| aspect_ratioAspect Ratio | select | 9:16 | 21:9 | 2:1 | 16:9 | 4:3 | 1:1 | 3:4 | 9:16 | The aspect ratio of the generated media. |
| resolutionResolution | select | 720p | 720p | 1080p | Resolution of the generated video. |
| durationDuration | slider | 5 | 5 ~ 20 · step 1 | Video length in seconds (5-20). |
| generate_audioGenerate Audio | boolean | true | — | Whether to generate audio for the video. |
Output fields
| Field | Type | Description |
|---|---|---|
| videos | array<string> |
API
Call this model through one unified REST API. Get a key on the API Keys page.
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/black-forest-labs/flux-3/text-to-video" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "A cinematic tracking shot of a neon-lit street market in Tokyo at night during light rain, reflections shimmering on the pavement, pedestrians with transparent umbrellas moving naturally through the scene, steam rising from food stalls, subtle camera dolly forward, realistic motion, atmospheric lighting, high detail, immersive urban ambience",
"aspect_ratio": "9:16",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/black-forest-labs/flux-3/text-to-video",
headers=HEADERS,
json={
"input": {
"prompt": "A cinematic tracking shot of a neon-lit street market in Tokyo at night during light rain, reflections shimmering on the pavement, pedestrians with transparent umbrellas moving naturally through the scene, steam rising from food stalls, subtle camera dolly forward, realistic motion, atmospheric lighting, high detail, immersive urban ambience",
"aspect_ratio": "9:16",
"resolution": "720p",
"duration": 5,
"generate_audio": True
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 1800s server-side.
deadline = time.time() + 1860
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/black-forest-labs/flux-3/text-to-video", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"prompt": "A cinematic tracking shot of a neon-lit street market in Tokyo at night during light rain, reflections shimmering on the pavement, pedestrians with transparent umbrellas moving naturally through the scene, steam rising from food stalls, subtle camera dolly forward, realistic motion, atmospheric lighting, high detail, immersive urban ambience",
"aspect_ratio": "9:16",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 1800s server-side.
const deadline = Date.now() + 1860 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);Documentation
black-forest-labs/flux-3/text-to-video
black-forest-labs/flux-3/text-to-video
FLUX 3 Text-to-Video generates cinematic 5-20 second videos from text prompts, with coherent motion, cinematic composition, optional synchronized audio, and 720P / 1080P output for creative videos, social content, ads, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Parameters
| Parameter | Type | Required | Default | Limits / description |
|---|---|---|---|---|
prompt | string | Yes | — | max 5000 chars; The text prompt describing the video you want to generate. |
aspect_ratio | string | No | "9:16" | 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16; The aspect ratio of the generated media. |
resolution | string | No | "720p" | 720p, 1080p; Resolution of the generated video. |
duration | integer | No | 5 | 5–20; step 1; Video length in seconds (5-20). |
generate_audio | boolean | No | true | Whether to generate audio for the video. |
Pricing
| Mode | USD / second | Credits / second | USD / 5 seconds |
|---|---|---|---|
| 720p | $0.17 | 17 | $0.85 |
| 1080p | $0.29 | 29 | $1.45 |
Price = rate × min(ceil(duration), 20). duration is an integer from 5 to 20; default 5. generate_audio does not change the price.
WaveSpeed standard list price; USD 1 = 100 credits. Account discounts are separate.
API
curl -X POST https://www.namifusion.com/api/v1/marketplace/run/black-forest-labs/flux-3/text-to-video \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"input": {
"prompt": "A cinematic tracking shot of a neon-lit street market in Tokyo at night during light rain, reflections shimmering on the pavement, pedestrians with transparent umbrellas moving naturally through the scene, steam rising from food stalls, subtle camera dolly forward, realistic motion, atmospheric lighting, high detail, immersive urban ambience",
"aspect_ratio": "9:16",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}
}'
curl 'https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID' \
-H "Authorization: Bearer $API_KEY"
Submit returns task_uuid. Poll until completed or failed. Successful output: output.videos (URL array). This API is asynchronous and returns URLs.
Related models
xAI Grok Imagine Video v1.5 Text to Video
Generate 1-15 second videos from text prompts at 480p, 720p, or 1080p.
MiniMax H3 Text to Video
MiniMax H3 Text to Video generates coherent 2K videos from text prompts, with flexible 4-15 second duration and six selectable aspect ratios for cinematic scenes, creative videos, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
ltx-2.5/text-to-video
LTX 2.5 Text-to-Video generates high-fidelity synchronized audio-video content from text prompts, with flexible duration and 720P / 1080P / 2K / 4K output for cinematic videos, social content, ads, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Kling Omni Video O3 Standard Text-To-Video
Kling Omni Video O3 is Kuaishou's advanced unified multi-modal video model with MVL (Multi-modal Visual Language) technology. Text-to-Video mode generates cinematic videos from text prompts with subject consistency, natural physics simulation, and precise semantic understanding. Supports audio generation. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.
Kling 3.0
Kling 3.0 delivers high-quality text-to-video generation with smooth motion, cinematic visuals, accurate prompt adherence, and native audio for ready-to-share clips. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
Kling V2.6 Text to Video API
Kling 2.6 delivers top-tier text-to-video generation with smooth motion, cinematic visuals, strong prompt adherence, and native audio for ready-to-share clips. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
Gemini Omni Flash Text to Video API
Gemini Omni Flash Text to Video creates short AI videos with synchronized audio from text prompts, combining visual generation and audio output for fast multimodal video creation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Seedance 2.0 Mini Text to Video
Seedance 2.0 Mini Text to Video is ByteDance's faster, lower-cost text-to-video model for cinematic multi-shot videos. It generates narrative sequences from text prompts with AI camera control, consistent characters across scenes, 480P / 720P / 1080P / 4K output, 4-15s duration, and flexible aspect ratios. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.