black-forest-labs/flux-3/image-to-video
black-forest-labs/flux-3/image-to-video
black-forest-labs/flux-3/image-to-video. Esplora API di modelli per immagini, video e scambio volto. Prova un modello e integralo tramite un’unica API REST.
Modelli correlati
Parametri completi, schema di output e prezzi aggiornati
| Marketplace delle API per modelli IA | Una piattaforma per tutto | Più popolare | Termini | Esplora API di modelli per immagini, video e scambio volto. Prova un modello e integralo tramite un’unica API REST. |
|---|---|---|---|---|
| prompt *Prompt | textarea | — | ≤ 5000 chars | |
| image *Image | image_upload | — | image/* · 1–1 items | |
| aspect_ratioAspect Ratio | select | — | 21:9 | 2:1 | 16:9 | 4:3 | 1:1 | 3:4 | 9:16 | |
| resolutionResolution | select | 720p | 720p | 1080p | |
| durationDuration | slider | 5 | 5 ~ 20 · step 1 | |
| generate_audioGenerate Audio | boolean | true | — |
Parametri completi, schema di output e prezzi aggiornati
| Scopri di più | Una piattaforma per tutto | Esplora API di modelli per immagini, video e scambio volto. Prova un modello e integralo tramite un’unica API REST. |
|---|---|---|
| videos | array<string> |
API
Esplora API di modelli per immagini, video e scambio volto. Prova un modello e integralo tramite un’unica API REST.
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/black-forest-labs/flux-3/image-to-video" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "A cinematic slow push-in on a confident astronaut standing on a rocky alien landscape at sunrise, dust drifting through the air and a distant ringed planet visible in the sky. The subject remains consistent with the reference image while the camera adds subtle motion, the suit fabric and flags gently flutter in the wind, and soft atmospheric lighting creates a dramatic sci-fi mood. High detail, smooth motion, realistic shadows, immersive ambience.",
"image": [
"https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/08/1e37b8c98464.jpeg"
],
"aspect_ratio": "16:9",
"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/image-to-video",
headers=HEADERS,
json={
"input": {
"prompt": "A cinematic slow push-in on a confident astronaut standing on a rocky alien landscape at sunrise, dust drifting through the air and a distant ringed planet visible in the sky. The subject remains consistent with the reference image while the camera adds subtle motion, the suit fabric and flags gently flutter in the wind, and soft atmospheric lighting creates a dramatic sci-fi mood. High detail, smooth motion, realistic shadows, immersive ambience.",
"image": [
"https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/08/1e37b8c98464.jpeg"
],
"aspect_ratio": "16:9",
"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/image-to-video", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"prompt": "A cinematic slow push-in on a confident astronaut standing on a rocky alien landscape at sunrise, dust drifting through the air and a distant ringed planet visible in the sky. The subject remains consistent with the reference image while the camera adds subtle motion, the suit fabric and flags gently flutter in the wind, and soft atmospheric lighting creates a dramatic sci-fi mood. High detail, smooth motion, realistic shadows, immersive ambience.",
"image": [
"https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/08/1e37b8c98464.jpeg"
],
"aspect_ratio": "16:9",
"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);Documentazione API
black-forest-labs/flux-3/image-to-video
black-forest-labs/flux-3/image-to-video
FLUX 3 Image-to-Video animates a required reference image into a 5-20 second video, preserving subject appearance while using prompt control to guide motion, camera movement, visual style, and optional synchronized audio at 720P / 1080P output. 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. |
image | array | Yes | — | 1–1 URLs; URL of the image the video starts from (PNG, JPEG, or WebP).. |
aspect_ratio | string | No | — | 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. |
Image inputs use URL arrays in Nami, including single-image fields. Multi-image edit accepts 1–3 URLs.
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/image-to-video \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"input": {
"prompt": "A cinematic slow push-in on a confident astronaut standing on a rocky alien landscape at sunrise, dust drifting through the air and a distant ringed planet visible in the sky. The subject remains consistent with the reference image while the camera adds subtle motion, the suit fabric and flags gently flutter in the wind, and soft atmospheric lighting creates a dramatic sci-fi mood. High detail, smooth motion, realistic shadows, immersive ambience.",
"image": [
"https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/08/1e37b8c98464.jpeg"
],
"aspect_ratio": "16:9",
"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.
Modelli correlati
xAI Grok Imagine Video v1.5 Image to Video
x-ai/grok-imagine-video-v1.5/image-to-video. Esplora API di modelli per immagini, video e scambio volto. Prova un modello e integralo tramite un’unica API REST.
Vidu Q4 Preview Image to Video
vidu/q4-preview/image-to-video. Esplora API di modelli per immagini, video e scambio volto. Prova un modello e integralo tramite un’unica API REST.
vidu/q3/image-to-video-spicy
vidu/q3/image-to-video-spicy. Esplora API di modelli per immagini, video e scambio volto. Prova un modello e integralo tramite un’unica API REST.
Vidu Q3 Image To Video
vidu/q3/image-to-video. Esplora API di modelli per immagini, video e scambio volto. Prova un modello e integralo tramite un’unica API REST.

MiniMax H3 Spicy Image to Video
minimax/h3/image-to-video-spicy. Esplora API di modelli per immagini, video e scambio volto. Prova un modello e integralo tramite un’unica API REST.
MiniMax H3 Image to Video
minimax/h3/image-to-video. Esplora API di modelli per immagini, video e scambio volto. Prova un modello e integralo tramite un’unica API REST.
ltx-2.5/image-to-video
ltx-2.5/image-to-video. Esplora API di modelli per immagini, video e scambio volto. Prova un modello e integralo tramite un’unica API REST.
ai/ltx-2.3-spicy/image-to-video-lora
lightricks/ltx-2.3-spicy/image-to-video-lora. Esplora API di modelli per immagini, video e scambio volto. Prova un modello e integralo tramite un’unica API REST.