Wie verwende ich die FLUX.3 Video API? Text-zu-Video, Bild-zu-Video und Video-Fortsetzung – Anleitung auf Chinesisch

TL;DR

• FLUX.3 Video ist ein Videomodell von Black Forest Labs. Auf HiAPI gibt es nur einen Modellnamen flux-3, der Text-zu-Video, Bild-zu-Video (1–10 Keyframes) und Video-Fortsetzung unterstützt. Einzelne Clips dauern 5–20 Sekunden und enthalten standardmäßig synchronen Ton. Modellseite öffnen und direkt online generieren – neue Nutzer erhalten bei der Registrierung 200 Credits.
• Abrechnung pro Sekunde: 720p kostet $0.25 pro Sekunde, 1080p $0.42 pro Sekunde; der Draft-Vorschaumodus kostet nur $0.09 pro Sekunde. Eine 5-sekündige Draft-Vorschau kostet $0.45.
• Beim Prompt-Tuning unbedingt zuerst draft: true aktivieren: Nur prompt ist ein Pflichtfeld, auch ohne weitere Parameter wird zum regulären Tarif abgerechnet.

Ergebnis zuerst ansehen

Beispiel auf der Modellseite, 720p, 5 Sekunden, mit Ton:

A silent maglev train glides through a vast solar-panel field at golden hour, reflective silver body catching warm directional light, low tracking shot alongside the train, distant maintenance drones crossing the sky, cinematic composition, rich cohesive color grade, premium commercial finish, subtle film grain, high dynamic range, smooth natural motion, stable cinematic camera movement, consistent lighting across frames

Mit diesem Prompt generieren → (5 Sekunden, 720p)

Beispiel auf der Modellseite von flux-3, 720p, 5 Sekunden, mit Ton. Zum regulären Tarif $1.25, als Draft-Vorschau $0.45.

Preise

Modus	720p / Sekunde	1080p / Sekunde
Reguläre Generierung (Text-zu-Video, Bild-zu-Video)	$0.25	$0.42
Draft-Vorschau	$0.09	Nicht unterstützt
Video-Fortsetzung (start_video übergeben)	$0.59	$0.76
Draft + Video-Fortsetzung	$0.18	Nicht unterstützt

Aktueller HiAPI-Preis, geprüft am 15. Oktober 2026. Ob Ton ein- oder ausgeschaltet ist, beeinflusst den Preis nicht.

Dauer	Draft 720p	Regulär 720p	Regulär 1080p
5 Sekunden	$0.45	$1.25	$2.10
10 Sekunden	$0.90	$2.50	$4.20
20 Sekunden	$1.80	$5.00	$8.40

Empfohlener Ablauf: Mit Draft Prompt und Bewegung abstimmen (ab $0.45 pro Clip), dann das Finale im regulären Tarif in 720p oder 1080p ausgeben.

curl: zuerst einen Draft ausführen

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3",
    "input": {
      "prompt": "Ein Papierflieger gleitet durch ein sonnendurchflutetes Büro, Zeitlupe, Kamera folgt",
      "duration": 5,
      "aspect_ratio": "16:9",
      "draft": true
    }
  }'

5 Sekunden Draft, $0.45. Nach der Rückgabe der taskId das Ergebnis abfragen:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Sobald status den Wert success hat, das Video unter output[0].url herunterladen – der Ton ist bereits in derselben MP4-Datei enthalten.

Python: Senden, Polling, Herunterladen

# pip install requests；zuerst export HIAPI_KEY=dein Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(timeout_s=900, **params):
    body = {"model": "flux-3", "input": params}
    # Beim erneuten Senden derselben Aufgabe denselben Idempotency-Key mitgeben, um doppelte Abbuchung zu vermeiden
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# Nach dem Finalisieren reguläres 1080p ausgeben
url = generate(
    prompt="Ein Papierflieger gleitet durch ein sonnendurchflutetes Büro, Zeitlupe, Kamera folgt",
    duration=8, resolution="1080p", aspect_ratio="16:9",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Dieser Clip mit 8 Sekunden in 1080p kostet $3.36.

Bild-zu-Video: 1 Startbild oder bis zu 10 Keyframes

In input images hinzufügen (nicht image_urls); die Anzahl der Bilder bestimmt die Verwendung:

• 1 Bild: Startbild.
• 2 Bilder: Startbild + Endbild, das Modell ergänzt den Übergang dazwischen.
• 3–10 Bilder: Keyframe-Storyboard, gleichmäßig über das gesamte Video verteilt.

{
  "model": "flux-3",
  "input": {
    "prompt": "Sanfter Übergang vom Sonnenaufgang zu einer neonbeleuchteten nächtlichen Stadt, stabile Kamera",
    "images": [
      "https://your-cdn.example.com/start.webp",
      "https://your-cdn.example.com/end.webp"
    ],
    "resolution": "1080p",
    "duration": 8
  }
}

Bilder werden in PNG, JPEG und WebP unterstützt. Bild-zu-Video kostet dasselbe wie Text-zu-Video.

Video-Fortsetzung: an ein vorhandenes Video anschließen

start_video übergeben, und das Modell generiert ab dem Ende dieses Videos weiter:

{
  "model": "flux-3",
  "input": {
    "prompt": "Die Kamera fährt weiter vorwärts, der Zug fährt in einen hellen Bergtunnel ein",
    "start_video": "https://your-cdn.example.com/source.mp4",
    "duration": 5,
    "draft": true
  }
}

• start_video unterstützt nur MP4, maximal 15 Sekunden und maximal 50 MB.
• images und start_video dürfen nicht gleichzeitig übergeben werden.
• Die Fortsetzung ist teurer pro Sekunde: 720p kostet $0.59 pro Sekunde, Draft-Fortsetzung $0.18 pro Sekunde.

Parameterübersicht

Parameter	Werte	Beschreibung
prompt	Zeichenkette, erforderlich	Szene, Bewegung, Kameraführung, Dialog und Ton werden hier beschrieben
duration	Ganzzahl von 5–20, Standard 5	Einheit Sekunden
resolution	720p / 1080p, Standard 720p	Draft nur in 720p möglich; Draft mit 1080p wird abgelehnt
aspect_ratio	auto 21:9 2:1 16:9 4:3 1:1 3:4 9:16, Standard auto
draft	Standard false	Günstiger Vorschaumodus
generate_audio	Standard true	Deaktiviert gibt stummes Video aus, Preis bleibt gleich
images	Maximal 10 Bilder	Bild-zu-Video
start_video	MP4-Adresse	Video-Fortsetzung

Hinweise vor dem Produktivbetrieb

• Callbacks statt Polling verwenden: Auf der obersten Ebene der Anfrage (gleiche Ebene wie input) "callback": {"url": "https://deine-domain/hiapi/callback"} hinzufügen und per taskId deduplizieren.
• Rechtzeitig speichern: output[0].url ist ein temporärer Link – nach Erhalt sofort im eigenen Speicher ablegen.
• Bei Wiederholungen Idempotenzschlüssel mitgeben: Im Request-Header Idempotency-Key setzen; dieselbe Kennung erstellt die Aufgabe nur einmal und bucht nicht doppelt ab.
• Automatische Rückerstattung bei Fehlschlag: Abgerechnet wird nur erfolgreich generierte Videoausgabe.

Häufige Fragen

Wie lang kann ein Clip maximal sein?

20 Sekunden. Für längere Videos mit der Video-Fortsetzung weiter generieren.

Kann der Ton deaktiviert werden? Wird es dadurch günstiger?

Ja, mit generate_audio: false. Der Preis hängt nur von Auflösung, Draft und Fortsetzung ab; das Deaktivieren des Tons wird nicht günstiger.

Wie groß ist der Unterschied zwischen Draft und regulärem Tarif?

Bei 720p $0.09 gegenüber $0.25 pro Sekunde – Draft ist rund 64 % günstiger und auch schneller, ideal für Prompt-Tuning.

Warum hat der Modellname keinen Suffix /text-to-video?

FLUX.3 vereint Text-zu-Video, Bild-zu-Video und Fortsetzung in einem einzigen flux-3; unterschieden wird danach, ob images oder start_video übergeben wird.

Wenn Sie zuerst einen Test wagen möchten, auf der Modellseite generieren. Einen Preisvergleich weiterer Videomodelle finden Sie auf der Preisseite.