Black Forest Labs: FLUX.3 Video
FLUX 3 Video erzeugt Clips mit synchronisiertem Dialog, Effekten und Atmosphäre aus Text, festgelegten Bildern oder einem fortzusetzenden Clip. Keyframes, Gestaltung mit mehreren Einstellungen und Draft-Verbesserung helfen, eine kontrollierte Abfolge zu entwickeln und den ausgewählten Take beizubehalten.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
FLUX 3 Video ist das multimodale Modell von Black Forest Labs zur Videogenerierung mit synchronisiertem Audio. Es erstellt Szenen aus einem Textbriefing, entwickelt Bewegung rund um festgelegte Bilder oder setzt einen vorhandenen Clip fort. Gesprochener Text, Effekte und Atmosphäre können gemeinsam mit den Bildern erzeugt werden und unterstützen eine kurze Szene, deren Kamerabewegung, Handlung und Ton als eine Abfolge gestaltet sind.
Beschreiben Sie für Text-zu-Video Motiv, Umgebung, sichtbare Handlung, Kameraverhalten und Ton. Eine nützliche Produktszene kann mit einer weiten Ansicht beginnen, sich einem Materialdetail nähern und mit dem Produkt in Verwendung enden. Briefings für mehrere Einstellungen können jede Einstellung und den Übergang zwischen Kamerawinkeln benennen und dabei Motiv und visuellen Stil über die Abfolge hinweg konsistent halten. Typografie kann in der Szene erscheinen; geben Sie deshalb genaue Wörter und Platzierung an, wenn ein Schild oder Titel wichtig ist. Das Modell deckt Realfilm, Animation, Motion Graphics und stilisierte Darstellungen ab.
Bild-zu-Video verwendet ein bis zehn Keyframe-Bilder. Ein einzelnes Bild legt das Eröffnungsbild fest; ein Paar fixiert Anfang und Ende, während geordnete Bilder mit Zeitstempeln bestimmte Momente im Clip steuern. Diese Bilder werden zu Videobildern und dienen nicht nur als allgemeine Stilreferenzen. Bei drei oder mehr Bildern ohne Zeitstempel verlangt der Hersteller eine ausdrückliche Dauer: Erstes und letztes Bild fixieren die Endpunkte, die anderen werden gleichmässig dazwischen platziert. Bilder mit Zeitstempeln müssen zeitlich geordnet sein; automatische Dauer läuft bis zum aufgerundeten letzten Zeitstempel innerhalb des Maximums von 20 Sekunden. Bereiten Sie Keyframes mit kompatiblen Motiven, Bildausschnitten und visuellen Details vor und beschreiben Sie dann die Bewegung dazwischen. Für eine Produktenthüllung kann das erste Bild das geschlossene Objekt zeigen und das letzte die geöffnete Anordnung; die dazwischenliegende Handlung wird im Prompt festgelegt.
Videofortsetzung knüpft an die letzten Bilder des bereitgestellten Clips an. Der Einführungsworkflow verwendet bis zu vier Sekunden vorhandenes Video und Audio als Kontext für die nächste Handlung und übernimmt Kameraverhalten, Bewegung und Ton über die Nahtstelle hinweg. Wählen Sie ein Quellende, das klar festlegt, wohin Motiv und Kamera sich bewegen, und beschreiben Sie, was danach geschieht. Fortsetzung unterscheidet sich vom Umschreiben einer vorhandenen Einstellung: FLUX Video Edit ist ein separates Bearbeitungsmodell und wird nicht Teil des Generierungsmodells, nur weil beide Video akzeptieren.
Text- und bildgesteuerte Generierung unterstützen Clips von 5 bis 20 Sekunden. Die modusspezifische Übersicht gibt Videofortsetzung einen Ausgabebereich von 5–15 Sekunden. Dauer und Seitenverhältnis lassen sich automatisch wählen; das Briefing kann auch ein unterstütztes Quer-, Quadrat- oder Hochformat angeben, darunter 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 und 9:21. Die Ausgabe hat 24 Bilder pro Sekunde. Wählen Sie die Dauer anhand weniger sichtbarer Handlungen, statt eine ganze Geschichte in eine kurze Generierung zu pressen.
HD-Ausgabe entsteht direkt bei der Generierung; FHD, QHD und UHD stellen dieselbe Szene mit einem Video-Upsampler fertig. Für 16:9 betragen die gelieferten Abmessungen entsprechend 1280 × 704, 1920 × 1088, 2560 × 1440 und 3840 × 2176. Die Abmessungen sind an Vielfachen von 32 ausgerichtet, sodass eine benannte Auflösungsklasse von einer üblichen Ausgabegrösse abweichen kann. Beschneiden Sie das fertige Bild, wenn eine genaue Standardfläche benötigt wird, und bewahren Sie dabei die wichtigen Randinhalte. Höhere Auflösung ist ein Fertigstellungsschritt, keine andere Interpretation der Einstellung.
Natives Audio ist standardmässig aktiviert und lässt sich für einen stummen Clip deaktivieren. Zitieren Sie für Dialog die Zeile, identifizieren Sie den Sprecher und beschreiben Sie die Sprechweise; mehrsprachige Sprachausgabe, Akzente und Lippensynchronisierung gehören zu den Audio-Video-Fähigkeiten des Modells. Verbinden Sie Dialog und Klanghinweise mit dem sichtbaren Ereignis, etwa einem sich schliessenden Deckel oder sich entfernenden Schritten. Prüfen Sie Stimme, Timing und gesprochenen Wortlaut gemeinsam mit dem Bild, statt Ton als eine nach der Generierung ergänzte unabhängige Ebene zu behandeln.
Der Draft-Modus erzeugt eine HD-Vorschau und ein Draft-Bundle. Verbessern Sie das ausgewählte Bundle, um diese Generierung in voller Qualität zu rendern; denselben Prompt als neue Anfrage für ein vollständiges Rendering zu senden, ist eine neue Interpretation und kann einen anderen Take erzeugen. Drafts verwenden nur HD; die Verbesserung kann dagegen die vier Auflösungsklassen auswählen und verwendet standardmässig FHD. Dies ergibt eine praktische Abfolge: zunächst Handlung und Komposition erkunden, dann den gewählten Take in der vorgesehenen Ausgabegrösse fertigstellen.
Der Herstellerworkflow liefert eine Aufgabenkennung, bevor das MP4 fertig ist, und stellt den abgeschlossenen Clip nach Ende der Verarbeitung bereit. Signierte Ergebnisadressen laufen nach ungefähr zwei Stunden ab; bewahren Sie deshalb die tatsächliche Datei auf, sobald die Einstellung ausgewählt ist. Prüfen Sie Keyframe-Übergänge, Schnitte, Typografie, Motivdetails und Audionahtstelle anhand des Briefings. Bewahren Sie für eine längere Abfolge die Referenzen und den Endkontext der gelungenen Einstellung als Eingabe für den nächsten Clip, statt anzunehmen, dass eine kurze Anfrage die gesamte Produktion enthält.
Ailoot Ultra · Video POST /v1/videos black-forest-labs/flux-3-video
black-forest-labs/flux-3-video
black-forest-labs/flux-3-videoEinstieg
FLUX 3 Video erzeugt Clips mit synchronisiertem Dialog, Effekten und Atmosphäre aus Text, festgelegten Bildern oder einem fortzusetzenden Clip. Keyframes, Gestaltung mit mehreren Einstellungen und Draft-Verbesserung helfen, eine kontrollierte Abfolge zu entwickeln und den ausgewählten Take beizubehalten.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Video POST /v1/videos
- Eingabe
text,image- Ausgabe
video- Ausgabeformat
- Originale MP4-Bytes; keine Normalisierung/Transkodierung
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits black-forest-labs/flux-3-video | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits | Standard— |
Feldduration | Typinteger | AnforderungErforderlich | Werte und Limits 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 Minimum: 1 Maximum: 600 | Standard— |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 720p, 1080p | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Standard— |
Feldgenerate_audio | Typboolean | AnforderungOptional | Werte und Limits false, true | Standard— |
Feldframe_images | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 1 Maximale Anzahl Elemente: 2 Eingabeinhalt: Array von Bildobjekten. Jedes Objekt enthält type=image_url, image_url mit url und frame_type. Verwenden Sie eine HTTPS-Bild-URL und setzen Sie frame_type auf first_frame oder last_frame. Jede Bildrolle darf höchstens einmal vorkommen. Exakte Schlüssel: type, image_url, frame_type Bedingungen: Diese Schlüssel beschreiben jedes Bildobjekt; image_url enthält ausschliesslich url. Lassen Sie frame_images bei einer reinen Textanfrage weg. | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits | Standard— |
Feldprevious_job_id | Typstring | AnforderungOptional | Werte und Limits Muster: ^video_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ | Standard— |
Feldcallback_url | Typstring | AnforderungOptional | Werte und Limits Muster: ^https:// | Standard— |
Feldsession_id | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Feldtrace | Typobject | AnforderungOptional | Werte und Limits | Standard— |
Felduser | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Kombinationen von Eingabematerialien
Text zu Video · Eine schriftliche Beschreibung. · Erforderlich: model, prompt, duration
Geben Sie prompt als Text und duration in ganzen Sekunden an. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.
model: Typ: string · black-forest-labs/flux-3-video
prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10'000 · Mindestens ein Zeichen ausser Leerraum erforderlich: Ja
Bild zu Video · Eine schriftliche Beschreibung und ein Bild für das erste Einzelbild. · Erforderlich: model, prompt, duration, frame_images
frame_images ist ein Array. Jedes Bildobjekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame mit einem optionalen last_frame. Jede Bildrolle darf höchstens einmal vorkommen. Geben Sie für jedes Bild eine öffentliche HTTPS-Bild-URL an. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.
Exakte Schlüssel: type, image_url, frame_type
model: Typ: string · black-forest-labs/flux-3-video
prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10'000 · Mindestens ein Zeichen ausser Leerraum erforderlich: Ja
Continue a video · Eine schriftliche Beschreibung und Ihr fertiggestelltes Originalvideo. · Erforderlich: model, prompt, duration, previous_job_id
Setzen Sie previous_job_id auf die öffentliche Video-ID Ihres fertiggestellten Originals. Verwenden Sie dasselbe Modell, Konto und denselben API-Schlüssel. Bewahren Sie die bestehende Aufgabenkennung auf; diese Anfrage erstellt eine separate Fortsetzungsaufgabe. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.
model: Typ: string · black-forest-labs/flux-3-video
prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10'000 · Mindestens ein Zeichen ausser Leerraum erforderlich: Ja
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt, duration |
Parametermaterial_types | Vertragtext, image |
Parameteradditional_properties | Vertragfalse |
Parameteroptional_controls | Vertragresolution, aspect_ratio, generate_audio, frame_images, input_references, previous_job_id, callback_url, session_id, trace, user |
Lebenszyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Gebührenkomponente | Referenzmodus | Abrechnungseinheit | Abrechnungsbedingungen | Gebühr |
|---|---|---|---|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebührenkomponente— | Referenzmodus— | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationText zu Video · Bild zu Video (Einzelbilder) · Referenzpreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponentereference_output_rate | ReferenzmodusText zu Video · Bild zu Video (Einzelbilder) | Abrechnungseinheitpro Ausgabesekunde | Abrechnungsbedingungen— | Gebühr Ausgabe · Referenztarif pro Ausgabevideo-Sekunde · Schätzung nur zum Vergleich $0.34 pro Ausgabesekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponente— | Referenzmodus— | Abrechnungseinheitpro Videosekunde | Abrechnungsbedingungenresolution: 1080p | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.58 pro Videosekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponente— | Referenzmodus— | Abrechnungseinheitpro Videosekunde | Abrechnungsbedingungenresolution: 720p | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.34 pro Videosekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponente— | Referenzmodus— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenEingabe: video_continuation; Auflösung: 1080p | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $1.06 pro Videosekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Gebührenkomponente— | Referenzmodus— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenEingabe: video_continuation; Auflösung: 720p | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.82 pro Videosekunde |
| KonfigurationGeschätzte Erzeugungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Gebührenkomponente— | Referenzmodus— | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $1.7 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Details zum Referenztarif
Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.
Preisreferenzen für Videokonfigurationen
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationVideopreis | AbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben. | Gebühr Ausgabe · Videopreis $0.34 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | Abrechnungsbedingungenresolution: 720p | Gebühr Ausgabe · Videopreis $0.34 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | Abrechnungsbedingungenresolution: 1080p | Gebühr Ausgabe · Videopreis $0.58 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenEingabe: video_continuation; Auflösung: 720p | Gebühr Ausgabe · Videopreis $0.82 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenEingabe: video_continuation; Auflösung: 1080p | Gebühr Ausgabe · Videopreis $1.06 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
Beispielanfragen
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"black-forest-labs/flux-3-video","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · Video
Signierte Inhalts-URLs der Ihnen zugeordneten Ausgaben
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Auftragsstatus prüfen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Bewahren Sie jede tatsächliche, Ihnen zugeordnete Ausgabe und die zurückgegebenen gemessenen Metadaten auf.
Wenn die ursprüngliche Antwort geprüft werden muss
503 result_pending_check + ursprüngliche id + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen
Antwortfelder
| Feld | Typ | Bedeutung |
|---|---|---|
Feldindex | Typinteger | BedeutungBei null beginnende Position dieses Videos in der Ausgabeliste. |
Feldcontent_url | Typstring | BedeutungSignierte HTTPS-URL zum Herunterladen dieses fertiggestellten Videos. |
Feldsha256 | Typstring | null | BedeutungSHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar. |
Feldsize_bytes | Typinteger | null | BedeutungGrösse der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar. |
Feldduration_ms | Typinteger | null | BedeutungGemessene Videodauer in Millisekunden; null, falls nicht verfügbar. |
Feldwidth | Typinteger | null | BedeutungVideobreite in Pixeln; null, falls nicht verfügbar. |
Feldheight | Typinteger | null | BedeutungVideohöhe in Pixeln; null, falls nicht verfügbar. |
Feldvideo_codec | Typstring | null | BedeutungKennung des Videocodecs; null, falls nicht aufgezeichnet. |
Feldhas_audio | Typboolean | null | BedeutungGibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen. |
Feldaudio_codec | Typstring | null | BedeutungKennung des Audiocodecs; null, wenn keine Kennung aufgezeichnet wurde. |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort404 · not_found_error | BedingungDer Videozugriff ist nicht verfügbar oder diese Video-ID wurde nicht gefunden. | Nächster SchrittPrüfen Sie den Videozugriff. Verwenden Sie bei einem bestehenden Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel. |
Antwort401 · authentication_error | BedingungDer API-Schlüssel stimmt nicht mit dem authentifizierten Konto überein. | Nächster SchrittPrüfen Sie vor dem Einreichen Ihren API-Schlüssel und den Kontozugriff. |
Antwort400 · invalid_request_error | BedingungDie Anfrage konnte nicht gelesen werden oder der Downloadindex ist ungültig. | Nächster SchrittKorrigieren Sie den Anfragetext. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat. |
Antwort422 · price_unavailable | BedingungFür die ausgewählte Videokonfiguration lässt sich kein Preis ermitteln. | Nächster SchrittWählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage einreichen. |
Antwort422 · invalid_request_error | BedingungEine Videoeingabe oder eine ursprüngliche Fortsetzungsaufgabe ist ungültig. | Nächster SchrittVerwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die ursprüngliche öffentliche Video-ID Ihres fertiggestellten Videos mit demselben API-Schlüssel. |
Antwort402 · billing_error | BedingungDas verfügbare Guthaben oder die geltenden Limiten erlauben keine Reservierung. | Nächster SchrittPrüfen Sie Ihr verfügbares Guthaben und Ihre Limiten, bevor Sie eine neue Anfrage senden. |
Antwort503 · server_error | BedingungVideoprüfung, Speicher oder Dienstzugriff ist vorübergehend nicht verfügbar. | Nächster SchrittWarten Sie, bis der Dienst verfügbar ist. Falls Sie bereits eine Video-ID besitzen, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Erzeugung zu erstellen. |
Antwort503 · result_pending_check | BedingungDas ursprüngliche Videoergebnis und die Abbuchung müssen geprüft werden. | Nächster SchrittBewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Erzeugungsanfrage. |
Antwort503 · owned_result_unavailable | BedingungDer Download des bestehenden Videos ist vorübergehend nicht verfügbar. | Nächster SchrittPrüfen Sie später dieselbe Videoaufgabe und laden Sie deren bestehende Ausgabe herunter. Eine neue Erzeugung erstellt einen separaten Vorgang. |
Antwort409 · video_not_ready | BedingungDer Videoinhalt wurde nicht veröffentlicht. | Nächster SchrittPrüfen Sie den ursprünglichen Aufgabenstatus. Laden Sie die Ausgabe herunter, nachdem completed gemeldet wird; bei failed befolgen Sie den Hinweis zur Prüfung der Abbuchung. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra black-forest-labs/flux-3-video
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Black Forest Labs: FLUX.3 Video
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·black-forest-labs/flux-3-video:text,image→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·black-forest-labs/flux-3-video:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,previous_job_id,callback_url,session_id,trace,user- Welche Grenzen gelten?
POST /v1/videos·black-forest-labs/flux-3-video:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1