Black Forest Labs
FLUX 3 Max
flux-3-max/keyframes-to-video
Ein Videogenerierungsmodell für Text-zu-Video und Bild-zu-Video, das auf schnelle Ausgabe mit geringer Latenz setzt; laut öffentlichen Benchmarks wird ein 10-Sekunden-Clip in etwa 11–12 Sekunden erzeugt, ideal für kreative Iterationen und Kurzvideo-Material
flux-3-max/keyframes-to-video ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
videoPreise
flux-3-max/keyframes-to-video per second
| Spezifikationen | Einzelpreis |
|---|---|
| 720P | $0.0608 |
| 1080P | $0.1036 |
Positionsübersicht
flux-3-max/keyframes-to-video ist eine keyframe-gesteuerte Bild-zu-Video-Pipeline aus der flux-3-max-Familie: Entwickler geben einen Prompt sowie bis zu 10 Keyframe-Bilder an, verankern diese per Frame-Index an festgelegten Positionen auf einer 24-fps-Zeitachse, und das Modell ergänzt die Bewegungen und Übergänge zwischen den Keyframes und gibt ein Video mit 5 bis 20 Sekunden in 720p oder 1080p aus. Geeignet für Storyboard-Previews, Werbe- und Kurzfilm-Teams, die die Bildfrequenz präzise steuern möchten, aufrufbar über die einheitliche Schnittstelle von HiAPI.ai.
Kernhighlights
- Punktgenaue Steuerung des Bildrhythmus per Keyframe – bis zu 10 Bilder werden per Frame-Index an beliebigen Positionen der Zeitachse platziert, die Zwischenschritte ergänzt das Modell, statt nur ein Startbild vorzugeben.
- Keyframes unterstützen synchrone Audiospur – die Audiogenerierung ist standardmäßig aktiviert und gibt bildsynchronen Ton aus, was die spätere Vertonung reduziert.
- Umschaltbare Inferenzintensität – reasoning_level bietet die Stufen low und high; bei komplexen Szenen erhöht hohe Intensität die Interpretationsqualität, bei einfachen Szenen lässt sich die Latenz senken.
Funktionsbeschreibung
Keyframe-Zeitachsen-Choreografie: Auf Basis von 24 fps wird mit frame_index die Position jedes Keyframes festgelegt; der Frame-Index muss eindeutig sein und darf die Dauer mal 24 nicht überschreiten, wodurch eine abschnittsweise präzise Bildnarration möglich ist.
5 bis 20 Sekunden Dauer und zwei Auflösungen: duration deckt 5 bis 20 Sekunden ab, resolution ist wahlweise 720p oder 1080p; die Abrechnung erfolgt nach Ausgabesekunden, was die Kostenkontrolle nach Cliplänge erleichtert.
Acht Bildformate und automatische Übernahme: aspect_ratio bietet acht Verhältnisse wie 21:9, 16:9, 1:1, 9:16; auto übernimmt das Seitenverhältnis des Eingabebilds, sodass eine Pipeline Quer-, Hoch- und Quadratformate abdeckt.
Prompt und Inferenzintensität im Zusammenspiel: prompt umfasst bis zu 6000 Zeichen und steuert zusammen mit reasoning_level die Interpretationstiefe komplexer Szenen, wobei zwischen Bildqualität und Antwortlatenz abgewogen wird.
Anwendungsfälle
- Storyboarder und Werbeteams: Schlüsselbilder plus Skript – fertige Storyboard-Bilder als Keyframes in die Zeitachse einordnen und eine rhythmisch kontrollierbare animierte Storyboard-Preview erzeugen, für Kundenpräsentationen und Freigaben vor dem Dreh.
- Marken-Kurzfilmproduktion: Produktbilder und Voiceover-Text – Produkt-Standbilder als Keyframes nutzen und mit dem Prompt Kameraführung und Atmosphäre beschreiben, um kurze Clips mit synchronem Ton zu erzeugen, die direkt für Social-Media-Ausspielung und Website-Präsentation verwendet werden.
- Kreativteams: Vergleich mehrerer Keyframe-Varianten – bei gleichem Prompt Keyframe-Kombinationen und Bildformate austauschen und in Stapeln ausgeben, um mehrere Kandidatenvideos für schnelle Iterationsauswahl zu erhalten.
- Hochformat-Content-Creator: 9:16-Keyframe-Sequenzen – im Hochformat und mit kurzer Dauer von 5 bis 10 Sekunden kurze Videoclips erzeugen, als Veröffentlichungsmaterial oder Zwischenasset für den Zweitschnitt.
Einschränkungen und Auswahlhinweise
Diese Pipeline akzeptiert nur Bild-zu-Video-Eingaben und benötigt mindestens ein Keyframe-Bild; für den reinen Textstart sollte die text-to-video-Pipeline derselben Familie gewählt werden. Die Ausgaberesolution ist auf 720p und 1080p beschränkt, die maximale Dauer beträgt 20 Sekunden; längere oder höher auflösende Endprodukte müssen segmentweise generiert und anschließend zusammengefügt werden. Die hohe Inferenzintensität high verursacht höhere Latenz; bei einfach getaktetem Material kann low verwendet werden. Keyframe-Bilder müssen über öffentliche HTTPS-Adressen erreichbar sein; eine fehlerhafte Frame-Index-Planung führt zu einer unerwarteten Anordnung, daher sollte die Zeitachse vor dem Absenden geprüft werden.
Neuigkeiten
Changelog ansehen →- Neues Modell flux-3-max/text-to-video Videogenerierungsmodell jetzt verfügbar
- Preisänderung flux-3-max/image-to-video Preisänderung: Neue Preisgestaltung $0.0608
- Preisänderung Preisanpassung für flux-3-max/text-to-video
Häufige Fragen
Alle Fragen ansehen →-
Welche Eingaben benötigt FLUX 3 Max für die Bild-zu-Video-Generierung?
Erforderlich sind prompt und image_url (Startbild, unterstützt PNG/JPEG/WebP). Optional sind end_image_url als Endbild sowie duration, resolution, aspect_ratio, generate_audio und reasoning_level.
-
Kann die Videodauer eingestellt werden?
Ja. duration akzeptiert ganzzahlige Sekundenwerte von 5–20 in 1-Sekunden-Schritten, Standard sind 5 Sekunden; Bild-zu-Video und Text-zu-Video nutzen dieselbe sekundenbasierte Preisgestaltung. Bestätigen Sie zuerst mit 5 Sekunden, ob das Quellbild stabil ist, und verlängern Sie dann die Dauer.
-
Wodurch wird das Bildformat bestimmt?
aspect_ratio ist standardmäßig auto, und die Ausgabe übernimmt das Seitenverhältnis des ersten Frame-Bildes; alternativ kann man 21:9, 2:1, 16:9, 4:3, 1:1, 3:4 oder 9:16 manuell angeben. Wenn die manuelle Angabe nicht mit dem Bildseitenverhältnis übereinstimmt, kann das Bild beschnitten werden.
-
Wie verwendet man das Endbild?
Übergeben Sie das Startbild an image_url und das Endbild an end_image_url; das Video geht dann vom Startbild zum Endbild über. Schreiben Sie im Prompt nur die dazwischen stattfindenden Veränderungen; je ähnlicher Kamerawinkel und Beleuchtung der beiden Bilder sind, desto flüssiger ist der Übergang.
Generierungsaufgabe erstellen
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.
Idempotency-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.
Body
modelstringPflichtAktueller Festwert: flux-3-max/keyframes-to-video
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für flux-3-max/keyframes-to-video und Route default — siehe Parametertabelle unten.
promptstringPflichtminLength 1maxLength 6000Text-Prompt zur Beschreibung des zu generierenden Videoinhalts, der die Bildkomposition und die inhaltliche Ausrichtung des Videos bestimmt.
durationintegerOptionalStandard: 5min 5max 20Dauer des Ausgabevideos in Sekunden, Wertebereich 5 bis 20, Standardwert 5.
keyframesarrayPflichtminItems 1maxItems 10
Array von Keyframes, die entlang der Video-Timeline platziert werden, maximal 10; jeder Keyframe enthält eine Bildadresse und eine Frame-Nummer, wobei jede Frame-Nummer eindeutig sein muss und die Dauer multipliziert mit 24 nicht überschreiten darf.
Array [ object ]
Array-Elemente
image_urlstringPflichtÖffentliche HTTPS-Adresse des Keyframe-Bildes; unterstützt werden die Formate PNG, JPEG und WebP.
frame_indexintegerPflichtmin 0Frame-Nummer dieses Keyframes auf der 24-fps-Timeline, Maximalwert ist die Dauer multipliziert mit 24, und innerhalb desselben Arrays darf sie nicht doppelt vorkommen.
resolutionstringOptionalStandard: "720p"Auflösung des Ausgabevideos, Standardwert 720p.
720p1080paspect_ratiostringOptionalStandard: "auto"Seitenverhältnis des Ausgabevideos; bei Einstellung auf auto wird das Seitenverhältnis des Eingabebildes übernommen, Standardwert auto.
auto21:92:116:94:31:13:49:16generate_audiobooleanOptionalStandard: trueOb gleichzeitig mit dem Video synchrones Audio generiert wird, standardmäßig aktiviert (true).
reasoning_levelstringOptionalStandard: "high"Steuert den Grad an Reasoning, der bei der Interpretation des Prompts aufgewendet wird; bei Einstellung auf high verbessert sich die Generierung komplexer Szenen, allerdings mit höherer Latenz, Standardwert high.
lowhighcallbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.
urlstringPflichtPflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.
whenstringOptionalStandard: "final"Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.
finalstoragestringOptionalStandard: "temp"Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.
temppersistentAnfragebeispiele
# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-3-max/keyframes-to-video",
"input": {
"prompt": "…",
"duration": 5,
"keyframes": "…",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true,
"reasoning_level": "high"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "flux-3-max/keyframes-to-video",
input: {
"prompt": "…",
"duration": 5,
"keyframes": "…",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true,
"reasoning_level": "high"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "flux-3-max/keyframes-to-video",
"input": {
"prompt": "…",
"duration": 5,
"keyframes": "…",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": True,
"reasoning_level": "high"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Aufgabendetails abrufen
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
queued Eingereiht, noch nicht gestartet.
handling In Verarbeitung.
archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet.
success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben).
fail Endzustand: fehlgeschlagen (error wird zurückgegeben).
Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-Sekunden des Endzustands; vor Abschluss stets 0.
outputarrayOptional
Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).
Array [ object ]
Array-Elemente
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
Antwortbeispiele
Erfolg
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In Bearbeitung (nicht final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fehlgeschlagen
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artikel
Alle Artikel ansehen →-
Tutorial
So rufen Sie kling-4.0/image-to-video auf HiAPI auf: curl, Python und Polling
-
Vergleichstest
Recraft v4.1 Flash 文生图横向对比:Entwickler-Auswahl und Migrationsleitfaden
Mit Kosten von $0,01 pro Bild und reiner Text-zu-Bild-Fähigkeit beurteilen, ob es zu Ihrer Bildgenerierungs-Pipeline passt
-
Tutorial
Kandinsky 6.0 Pro Text-zu-Video auf HiAPI: curl- und Python-Tutorial
Eine anfrageorientierte praktische Demonstration: Aufbau des Aufrufs vom Prompt zum Videoclip, Absenden der Anfrage, Abfragen des Fertigstellungsstatus und Herunterladen des Ergebnisses
-
Tutorial
kandinsky-6.0-pro/image-to-video auf HiAPI: Tutorial mit curl und Python
Eine funktionierende Bild-zu-Video-Anfrage auf HiAPI ausführen: vom Upload des ersten Frames über asynchrones Polling bis zum finalen Download
-
Tutorial
So nutzt du kling-4.0/text-to-video über die HiAPI-API: curl, Python und ein lauffähiges Anforderungsbeispiel
Ein praxisnaher Leitfaden für Entwickler: filmische Prompts, synchrones Audio, asynchrones Polling und Download der Ausgabe
-
Tutorial
So rufen Sie hailuo-2.3-fast/image-to-video über die HiAPI API auf: curl und Python in der Praxis
Die erste lauffähige Anfrage für die schnelle, kostengünstige Bild-zu-Video-Stufe – von der Modell-ID bis zum heruntergeladenen MP4
-
Vergleichstest
hailuo-2.3-fast/image-to-video im Quervergleich: Wie man Bild-zu-Video-Modelle auswählt und worauf bei der Migration zu achten ist
-
Tutorial
So rufen Sie hailuo-2.3/text-to-video über die HiAPI API auf: curl, Python und lauffähige Anfragebeispiele
Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
Grok Imagine 1.5 xAI $0.011 /Sekunde -
HappyHorse 1.0 Alibaba $0.168 /Sekunde -
Wan 3.0 Video Alibaba $0.040 /Sekunde -
Gemini Omni Google -- -
PixVerse V6 PixVerse $0.036 /Sekunde -
Vidu Q4 Preview Vidu $0.051 /Sekunde -
MiniMax H3 MiniMax $0.072 /Sekunde -
LTX 2.5 Fast Lightricks $0.086 /Sekunde -
Creatify Boreal Creatify $0.015 /Sekunde -
Kandinsky 6.0 Pro $1.93 /Video -
Veo 3.1 Lite Google $0.060 /Sekunde -
Veo 3.1 Fast Google $0.170 /Sekunde
Gleicher Anbieter
-
FLUX.2 Black Forest Labs $0.035 /Bild -
FLUX.1 Fill Pro Black Forest Labs $0.071 /Bild -
FLUX 3 Image Black Forest Labs $0.041 /Bild -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /Bild -
FLUX 1.1 Pro Black Forest Labs $0.050 /Bild -
FLUX.1 Kontext Max Black Forest Labs $0.071 /Bild -
FLUX.1 Schnell Black Forest Labs $0.005 /Bild -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /Bild -
FLUX 3 Max Black Forest Labs $0.061 /Sekunde -
FLUX 3 Video Black Forest Labs $0.090 /Sekunde




















