Skip to main content
POST

Autorisierung

string
erforderlich
Alle Endpunkte erfordern eine Bearer-Token-AuthentifizierungHolen Sie Ihren API-Key von der API-Key-Verwaltungsseite:

Generierungsmodi

flux-3-video ist ein einheitlicher Einstieg: Der Modus wird aus den Feldern abgeleitet oder explizit mit mode gesetzt. mode-Werte: t2v / i2v / v2v / draft_enhance oder offizielle Schreibweisen text-to-video / image-continuation / video-continuation. Explizites mode hat höchste Priorität.

Image-to-Video-Keyframe-Semantik

Die Reihenfolge in image_urls ist semantisch — nicht sortieren oder deduplizieren:

Anfrageparameter

string
erforderlich
Fester Wert: flux-3-video
string
erforderlich
Prompt. Darf nicht gesendet werden, wenn draft_from_task_id verwendet wird (wird abgelehnt).
integer
Standard:"5"
Dauer in Sekunden, Ganzzahl 5~20, Standard 5
duration: "auto" wird nicht unterstützt (Abrechnung braucht eine feste Sekundenzahl). Weglassen, "auto" oder Nicht-Ganzzahlen → als 5 Sekunden behandelt, ohne Fehler und ohne adaptive Länge.
Bei Videofortsetzung kann die gelieferte Dauer kürzer sein als angefordert (z. B. Anfrage 5 s, Ergebnis 4 s). Die angeforderten Sekunden werden vorab belastet und die Differenz nach Abschluss erstattet; Endbetrag ist Query-cost. Text/Image-to-Video zeigen diese Lücke nicht.
string
Standard:"hd"
Auflösung
  • hd (Standard; akzeptiert auch 720p)
  • fhd (akzeptiert auch 1080p)
Gemessen: hd ~1280×704 bei 16:9; fhd ~1920×1088.
Draft-Modus (draft:true) erlaubt nur hd.
string
Standard:"auto"
SeitenverhältnisOptionen: 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 oder auto (Standard; wird aus Prompt und Assets automatisch gewählt)
string[]
Image-to-Video-Keyframes, 1~10, öffentliche http(s)-URL oder Base64
string
Eingabevideo für Fortsetzung (mp4, öffentliche URL oder Base64)
string[]
Wie video_url; verwendet das erste Element (Kompatibilität)
boolean
Standard:"true"
Synchrones Audio erzeugen, Standard true. false ergibt stummes Video (kein Rabatt)
boolean
Standard:"false"
Draft-Modus: ~1/3 Preis niedrige Vorschauqualität; nur mit resolution: hd
string
Draft → Final: ID Ihrer erfolgreichen Draft-Aufgabe
  • Nur resolution darf geändert werden; Prompt, Dauer, Bilder, Video nicht
  • Zum vollen Finalpreis abgerechnet; Draft-Gebühr wird nicht angerechnet
  • Gegenseitig ausschließend mit draft:true
integer
Standard:"2"
Moderations-Toleranz 0~4, Standard 2 (höher = permissiver)
Nicht mit FLUX.2-Bildern (05) oder Kontext (06) verwechseln.
string
Expliziter Modus (optional); siehe Generierungsmodi

Draft-Modus

Zweistufiger Workflow, wenn Iteration teuer ist:

Draft erstellen

Draft zu Final

Beim Übergang vom Draft zum Final wird in voller Qualität mit den gespeicherten Draft-Parametern (Modus / Prompt / Seed / Assets) gerendert. Fortsetzungs-Drafts finalisieren zu Fortsetzungs-Finalpreisen.

Anfragebeispiele

Text-to-Video (Hochformat)

Image-to-Video (Start + Endframe)

Videofortsetzung

Stummes Video

Einschränkungen

Häufige Submit-Fehler (meist nicht berechnet)

Moderationsfehler enden als failed mit voller Rückerstattung.

Funktionsabdeckung

Response

integer
Statuscode; 200 bei Erfolg
array
Antwortdaten-Array
Ergebnisse abfragenDie Videogenerierung ist asynchron. Abfragen Sie Aufgabenstatus abrufen.Empfohlenes Intervall 5~10 Sekunden; Client-Timeout 15 Minuten (20 s fhd ist langsamer). Gemessen ~60 s für t2v + hd + 5 s.Bei Erfolg result.videos[0].url verwenden; Assets werden auf das Plattform-CDN gespiegelt. cost ist der Endbetrag. Bei Fehlern volle Rückerstattung.