So verwenden Sie die FLUX 3 Video-API
Eine Schritt-für-Schritt-Anleitung zur FLUX 3 Video-API mit Node.js, Python und cURL: einen text zu video-Auftrag absenden, den Status abfragen oder einen Webhook empfangen und anschließend die video herunterladen. Das folgende Beispiel kostet $0,79.
- Endpunkte
- 2
- Text zu Video · Bild zu Video
- Beispielanfrage
- $0,79
- Text zu Video
- Sprachen
- 3
- Node.js · Python · cURL
- Fehlgeschlagene Aufträge
- $0
- automatisch erstattet
API-Schlüssel abrufen
Erstellen Sie ein Konto, laden Sie Guthaben auf und erstellen Sie im Dashboard unter „API-Schlüssel“ einen Schlüssel. Speichern Sie ihn als CHEAPERGEN_API_KEY auf Ihrem Server. Jede Anfrage sendet ihn als Bearer-Token.
Wählen Sie einen FLUX 3 Video-Endpunkt
Jede Aufgabe hat einen eigenen Endpunkt. Alle erwarten einen JSON-Body und geben eine Generierung zurück, deren Status Sie abfragen können.
| Aufgabe | Endpunkt | Erforderlich | Ab |
|---|---|---|---|
| Text zu Video | bfl/flux-3-video/text-to-video | prompt | $0,1564 pro Sekunde |
| Bild zu Video | bfl/flux-3-video/image-to-video | prompt, image_url | $0,1564 pro Sekunde |
Einen text zu video-Auftrag absenden
Dieses Programm übermittelt den Auftrag, fragt alle 3 Sekunden bis zum Abschluss den Status ab und gibt die video-URL aus. Ersetzen Sie Prompt und Einstellungen durch Ihre eigenen.
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/bfl/flux-3-video/text-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Ein Heißluftballon schwebt bei Sonnenaufgang über Kappadokien. Der Brenner dröhnt, die Kamera steigt neben dem Korb auf.",
"aspect_ratio": "16:9",
"duration": 5
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);Wichtige Parameter festlegen
Die Einstellungen für bfl/flux-3-video/text-to-video und ihre Auswirkungen auf den Preis.
| Parameter | Typ · Standardwert | Beschreibung | Preisauswirkung |
|---|---|---|---|
| aspect_ratio | string (enum) · 16:9 | Ausgabeformat des Bildes. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 2:1 | Ja |
| duration | integer · 5 | Länge des generierten Clips in Sekunden (5–20 s). Abrechnung pro Sekunde. | Abrechnung pro Sekunde |
| generate_audio | boolean · true | Generieren Sie synchronisierten Ton, Atmosphäre und Dialog. Ohne Aufpreis. | Keine |
Weitere FLUX 3 Video-Endpunkte verwenden dieselbe Struktur, aber jeweils eigene Eingabefelder:
POST /api/v1/run/bfl/flux-3-video/image-to-video
{
"prompt": "Langsame Fahrt nach vorn, während sich die Blume von der Knospe zur vollen Blüte öffnet",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"duration": 5
}Ergebnis abrufen
Ein Auftrag wechselt von queued zu running und anschließend zu succeeded, failed oder canceled. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url; dann senden wir Ihnen das Ergebnis per POST. Laden Sie die Ausgabe herunter und speichern Sie sie selbst.
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "bfl/flux-3-video",
"endpoint": "bfl/flux-3-video/text-to-video",
"mode": "text-to-video",
"status": "succeeded",
"input": {
"prompt": "Ein Heißluftballon schwebt bei Sonnenaufgang über Kappadokien. Der Brenner dröhnt, die Kamera steigt neben dem Korb auf.",
"aspect_ratio": "16:9",
"duration": 5
},
"output": {
"video": {
"url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
"content_type": "video/mp4",
"duration": 5,
"width": 1280,
"height": 720
}
},
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": false,
"official_usd": 0.264,
"list_price_source": "reference",
"list_price_label": "fal API",
"saved_usd": 0.0385
},
"source": "api",
"created_at": "2026-10-15T09:21:04Z",
"started_at": "2026-10-15T09:21:06Z",
"completed_at": "2026-10-15T09:22:31Z"
}Preis vor der Ausführung abfragen
Der Angebotsendpunkt ist kostenlos und erfordert keinen Schlüssel. Er gibt den Preis, Preis von fal API und Ihren Rabatt genau für die übermittelten Eingaben zurück.
curl -X POST https://cheapergen.com/api/v1/quote/bfl/flux-3-video/text-to-video \
-H "Content-Type: application/json" \
-d '{"prompt":"Ein Heißluftballon schwebt bei Sonnenaufgang über Kappadokien. Der Brenner dröhnt, die Kamera steigt neben dem Korb auf.","aspect_ratio":"16:9","duration":5}'| Status | Code | Bedeutung |
|---|---|---|
| 400 | invalid_request | Ein Parameter fehlt oder liegt außerhalb des zulässigen Bereichs – die Meldung nennt ihn. |
| 401 | unauthorized | API-Schlüssel fehlt, ist fehlerhaft formatiert oder wurde widerrufen. |
| 402 | insufficient_balance | Ihr Guthaben reicht nicht für den angebotenen Preis. Laden Sie es auf oder aktivieren Sie die automatische Aufladung. |
| 429 | rate_limited | Zu viele Anfragen oder gleichzeitig laufende Generierungen. Warten Sie kurz und versuchen Sie es erneut. |
| 502 | upstream_error | Die Verarbeitung durch das Modell ist fehlgeschlagen. Der reservierte Betrag wird erstattet; Sie können es erneut versuchen. |
| 503 | model_unavailable | Derzeit ist kein geeigneter Verarbeitungsweg verfügbar. Versuchen Sie es später erneut oder wählen Sie ein anderes Modell. |
FAQ