FLUX 3 Video API: Anleitung und fertiges Python-Skript

👁 116 Aufrufe

FLUX 3 Video bietet keine Endkunden-App mit klassischem Abomodell - Black Forest Labs vertreibt das Modell primär über APIs. Das klingt technischer, als es ist: Sie benötigen lediglich einen API-Schlüssel, wenige Dollar Guthaben und ein kurzes Skript. Wir stellen Ihnen im Folgenden drei Wege vor (fal.ai, OpenRouter, BFL-API), liefern ein getestetes Python-Skript und zeigen die wichtigsten Prompting-Regeln für saubere Kamerafahrten und Beschriftungen. Unseren vollständigen Test und Vergleich finden Sie in unserer Übersicht zu FLUX 3 Video.

Die EUR-Beträge sind unverbindliche Umrechnungen der veröffentlichten USD-Preise zum EZB-Referenzkurs vom 2026-10-12: 1 EUR = 1.1181 USD. Es handelt sich nicht um bestätigte örtliche Endpreise einschließlich Steuern. Anbieter und Bank können andere Kurse oder Gebühren berechnen. ECB.

API-Anbieter im Vergleich: fal.ai, OpenRouter oder BFL

Preise mit Stand vom 11. Oktober 2026. Wir haben im Test 6 Clips über OpenRouter und 3 über fal.ai generiert - detaillierte Ergebnisse zeigen wir im Artikel Was FLUX 3 Video leistet. Unser Skript setzt auf fal.ai, da der Dienst die niedrigsten Preise und einen schnellen Entwurfsmodus bietet.

Schritt für Schritt zum ersten Video

1. Erstellen Sie ein Konto auf fal.ai, laden Sie im Bereich „Billing“ Ihr Guthaben auf und generieren Sie unter „Keys“ einen API-Schlüssel.
2. Installieren Sie das benötigte Paket: pip install requests.
3. Laden Sie das Skript flux3_wideo.py herunter (vollständiger Code siehe unten).
4. Hinterlegen Sie Ihren API-Schlüssel als Umgebungsvariable. In der PowerShell: $env:FAL_KEY="ihr_schluessel", im macOS-/Linux-Terminal: export FAL_KEY="ihr_schluessel".
5. Erstellen Sie einen Entwurf: python flux3_wideo.py "Szenenbeschreibung" --szkic. Das Skript zeigt vorab die geschätzten Kosten und bittet um Bestätigung.
6. Wenn der Entwurf passt, führen Sie denselben Befehl ohne das Flag --szkic aus - Sie erhalten die finale Qualität in 720p oder via --rozdz 1080p in voller Full-HD-Auflösung.
7. Um ein bestehendes Foto zu animieren, ergänzen Sie --obraz https://beispiel.de/bild.jpg. Das Ausgangsbild muss über eine öffentliche URL erreichbar sein.

Praxistest des Skripts

Wir haben das Skript am 11. Oktober 2026 in einem leeren Arbeitsverzeichnis im Entwurfsmodus mit folgendem Befehl ausgeführt:

python flux3_wideo.py "A red and cream tram passes along a rainy Krakow street at dusk, reflections of shop lights on the wet cobblestones, people with umbrellas wait at the stop. A sign on the tram stop reads "PLAC WOLNICA". Static camera, realistic. Sound: rain, tram bell, wheels on rails." --szkic --plik tramwaj_szkic.mp4 --tak

Das Resultat: Eine MP4-Datei mit 4,8 MB, 5 Sekunden Länge, 1280×704 Pixeln, inklusive Ton nach 37 Sekunden Rechenzeit. Eine rot-cremefarbene Straßenbahn fährt durchs Bild, Personen mit Regenschirmen warten an der Haltestelle, die Lichter spiegeln sich im nassen Pflaster. Die getestete Haltestellenaufschrift PLAC WOLNICA („Wolnica-Platz“) ist im Entwurfsmodus allerdings unlesbar, da das Schild im Gesamtbild zu klein ausfällt. Wenn Text exakt lesbar sein soll, muss er als dominantes Hauptelement im Prompt definiert werden.

Das fertige Python-Skript

Download: flux3_wideo.py (91 Zeilen). Der API-Schlüssel wird sicher aus den Umgebungsvariablen geladen, vor dem Absenden erfolgt eine Kostenabfrage, bei kurzen Netzwerkabbrüchen wird automatisch wiederholt und das fertige Video als MP4 gespeichert.

"""flux3_wideo.py - Video mit FLUX 3 Video ueber fal.ai generieren (11.10.2026)

Voraussetzungen: Python 3.9+ und das requests-Paket (pip install requests).
API-Schluessel: Umgebungsvariable FAL_KEY (fal.ai -> Dashboard -> Keys). Nicht im Code speichern.

Beispiele:
  python flux3_wideo.py "A red tram passes through a rainy street at dusk" --szkic
  python flux3_wideo.py "The camera slowly dollies forward..." --obraz https://domain.de/bild.jpg --czas 6
  python flux3_wideo.py "..." --czas 10 --rozdz 1080p --proporcje 9:16 --bez-dzwieku

Kosten (fal.ai Preisliste vom 11.10.2026): 0,085 USD pro Sekunde in voller Qualitaet, 0,03 USD pro Sekunde im Draft-Modus.
Das Skript berechnet die Kosten vorab und bittet um Bestaetigung (ueberspringen mit --tak).
"""
import argparse, os, sys, time, pathlib
import requests

STAWKA = {'pelna': 0.085, 'szkic': 0.03}  # USD pro Sekunde, fal.ai, Stand 11.10.2026


def main():
    a = argparse.ArgumentParser(description='FLUX 3 Video ueber fal.ai')
    a.add_argument('prompt', help='Prompt auf Englisch; Zitate oder Textfragmente in Anfuehrungszeichen')
    a.add_argument('--obraz', help='URL des Startbildes (fuer Image-to-Video)')
    a.add_argument('--czas', type=int, default=5, help='Dauer in Sekunden, 5-20 (Standard: 5)')
    a.add_argument('--rozdz', default='720p', choices=['720p', '1080p'])
    a.add_argument('--proporcje', default='16:9', help='16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 2:1 oder auto')
    a.add_argument('--szkic', action='store_true', help='Draft-Modus: schneller und guenstiger zum Testen')
    a.add_argument('--bez-dzwieku', action='store_true', help='Ohne Tonspur generieren')
    a.add_argument('--plik', default='', help='Dateiname des Ausgabevideos (Standard: flux3_<zeit>.mp4)')
    a.add_argument('--tak', action='store_true', help='Kostenabfrage ohne Rueckfrage bestaetigen')
    x = a.parse_args()

    klucz = os.environ.get('FAL_KEY')
    if not klucz:
        sys.exit('Fehler: Variable FAL_KEY nicht gesetzt. Setzen Sie diese z. B. in PowerShell via $env:FAL_KEY="..."')
    if not 5 <= x.czas <= 20:
        sys.exit('Die Dauer muss zwischen 5 und 20 Sekunden liegen.')

    tryb = 'image-to-video' if x.obraz else 'text-to-video'
    endpoint = f'blackforestlabs/flux-3/{tryb}' + ('/draft' if x.szkic else '')
    body = {'prompt': x.prompt, 'duration': x.czas, 'aspect_ratio': x.proporcje, 'generate_audio': not x.bez_dzwieku}
    if x.obraz:
        body['image_url'] = x.obraz
    if not x.szkic:
        body['resolution'] = x.rozdz  # Draft wird immer in 720p ausgegeben

    koszt = x.czas * STAWKA['szkic' if x.szkic else 'pelna']
    print(f'Modell: {endpoint}nDauer: {x.czas} s, geschaetzte Kosten: {koszt:.3f} USD')
    if not x.tak and input('Ausfuehren? [j/N] ').strip().lower() != 'j':
        sys.exit('Abgebrochen.')

    H = {'Authorization': 'Key ' + klucz, 'Content-Type': 'application/json'}
    r = requests.post('https://queue.fal.run/' + endpoint, headers=H, json=body, timeout=120)
    if r.status_code >= 300:
        sys.exit(f'Fehler {r.status_code}: {r.text[:400]}')
    zad = r.json()
    print('Auftrag uebermittelt, warte auf Generierung...')

    t0 = time.time()
    while True:
        time.sleep(8)
        try:
            s = requests.get(zad['status_url'], headers=H, timeout=60).json()
        except requests.RequestException:
            continue  # Temporaere Netzwerkstoerung - weiterer Versuch
        stan = s.get('status')
        print(f'  {int(time.time() - t0)} s: {stan}')
        if stan == 'COMPLETED':
            break
        if stan not in ('IN_QUEUE', 'IN_PROGRESS'):
            sys.exit(f'Generierung fehlgeschlagen: {s}')
        if time.time() - t0 > 1800:
            sys.exit('Kein Ergebnis nach 30 Minuten. Manuelle Pruefung via: ' + zad['response_url'])

    for _ in range(6):
        try:
            wynik = requests.get(zad['response_url'], headers=H, timeout=90).json()
            break
        except requests.RequestException:
            time.sleep(10)
    else:
        sys.exit('Download des Ergebnisses fehlgeschlagen. URL: ' + zad['response_url'])

    url = wynik['video']['url']
    plik = pathlib.Path(x.plik or f'flux3_{int(time.time())}.mp4')
    plik.write_bytes(requests.get(url, timeout=300).content)
    print(f'Fertiggestellt in {int(time.time() - t0)} s: {plik.resolve()} ({plik.stat().st_size // 1024} KB)')


if __name__ == '__main__':
    main()

Prompts für FLUX 3 Video optimieren

• Prompts auf Englisch verfassen: Formulieren Sie die Szene grundlegend auf Englisch. Gesprochene Sätze oder Aufschriften können Sie gezielt einbinden, etwa: She says clearly in German: "...". Wir haben das im Test auch mit polnischer Sprachausgabe erfolgreich geprüft.
• Audio explizit definieren: Hängen Sie Audioanweisungen mit dem Signalwort „Sound:“ an. Wichtig: Bei unserem Test mit einer Espressomaschine erzeugte das Modell nur Vogelgezwitscher statt des Pumpengeräusches. Spezifische Produktsounds schneidet man im Zweifel besser in der Postproduktion nach.
• Text groß im Bild platzieren: Beschreiben Sie Schilder dominant im Vordergrund („the chalkboard clearly shows exactly two lines of text“). Kleine Details im Hintergrund verschwimmen schnell.
• Kamerabewegung präzise vorgeben: Verwenden Sie klare Anweisungen in einem Satz wie „The camera slowly dollies forward“, „180-degree orbit at a constant speed“ oder „static camera“. Orbit-Fahrten meistert FLUX 3 ohne störende Objektverzerrungen.
• Szenenwechsel strukturieren: Trennen Sie Schnitte mit „Hard cut. Shot 2:“ und wiederholen Sie die Kernmerkmale von Personen oder Objekten für jede Einstellung.
• Negative Prompts am Ende anfügen: Schließen Sie unerwünschte Elemente ab mit „no subtitles, no on-screen text, no music“.
• Seitenverhältnis manuell fixieren: Bei Image-to-Video sollten Sie das Seitenverhältnis explizit festlegen, da die Einstellung „auto“ in unserem Test ein Bildmotiv ungewollt beschnitten hat.

Skript-Parameter im Überblick

Kostenvergleich für Videoclips

Die Tonspur verursacht bei den Anbietern keine Zusatzkosten. Für unsere Testserie fielen über fal.ai und OpenRouter Gesamtkosten von 5,46 EUR (6,10 USD) für 9 Videoclips an.

Typische Fehlermeldungen und Lösungen

• „Variable FAL_KEY nicht gesetzt“: Die Umgebungsvariable wurde in einem anderen Terminalfenster deklariert. Hinterlegen Sie den Schlüssel in derselben Sitzung, in der Sie das Skript aufrufen.
• HTTP-Fehler 401 oder 403: Der API-Schlüssel ist ungültig oder besitzt unzureichende Berechtigungen. Erstellen Sie im fal.ai-Dashboard einen neuen Schlüssel.
• Guthabenfehler (Insufficient Balance): Das Prepaid-Konto ist leer. Laden Sie unter „Billing“ weiteres Guthaben auf.
• Startbild wird nicht geladen: Die hinterlegte Bild-URL muss frei ohne Login erreichbar sein und auf eine Datei im Format PNG, JPEG oder WebP verweisen.
• Verbindungsabbruch während des Downloads: Das Skript versucht den Abruf mehrfach erneut. Falls das fehlschlägt, wird die temporäre Resultat-URL in der Konsole ausgegeben, sodass Sie die Datei manuell sichern können, ohne erneut zu bezahlen.

Häufig gestellte Fragen (FAQ)

Lässt sich FLUX 3 Video auch ohne Programmierkenntnisse nutzen?

Ja. Sowohl fal.ai als auch OpenRouter stellen webbasierte Playground-Oberflächen bereit, in denen Prompts direkt per Formular übermittelt werden können. Das Skript empfiehlt sich vor allem für reproduzierbare Tests, Serienproduktionen und automatisierte Arbeitsabläufe.

Können Clips über 20 Sekunden Länge erstellt werden?

Über das Verlängern bestehender Szenen: fal.ai bietet hierfür den Endpunkt extend-video, der die letzten Frames eines Clips als Startpunkt für weitere 5 bis 15 Sekunden nutzt. Bei der BFL-API liegt der Preis hierfür bei 0,3667 EUR (0,41 USD) pro Sekunde in 720p.

Ist die kommerzielle Nutzung der Videos erlaubt?

Das hängt von den Nutzungsbedingungen von Black Forest Labs sowie des jeweiligen API-Resellers ab. Prüfen Sie vor dem produktiven Einsatz in Werbekampagnen stets die aktuellen Lizenzbedingungen des genutzten Endpunkts.

Praktische Beispiele mit Prompts: Was FLUX 3 Video leistet. Der Vergleich mit anderen Modellen: FLUX 3 vs. Wan 3.0 vs. Seedance 2.5. Weitere Tools: KI-Videogeneratoren im Überblick.

// weiterlesenTicket-Routing mit Strands Decider 2B: Python-AnleitungAnleitungenVidu Q4 Image-to-Video: Bild zu Video Anleitung & PromptsAnleitungenWan 3.0: Bild zu Video - Test, Kosten und SkriptKI-Werkzeuge