Hailuo 2.3 API-Leitfaden: Text-zu-Video, Bild-zu-Video und die Fast-Version

TL;DR

• Hailuo 2.3 ist ein Videomodell von MiniMax. Auf HiAPI gibt es drei Endpunkte: hailuo-2.3/text-to-video, hailuo-2.3/image-to-video und das günstigere hailuo-2.3-fast/image-to-video.
• Die Abrechnung erfolgt pro Video, nicht pro Sekunde: 6-Sekunden-Videos kosten $0.40, 10-Sekunden-Videos $0.80. Bei Fast Bild-zu-Video sind es $0.27 und $0.46.
• Es gibt nur wenige Eingabeparameter: prompt, duration (String "6" oder "10"), prompt_optimizer und bei Bild-zu-Video zusätzlich eine image_url. Es gibt keine Parameter für Auflösung, Seitenverhältnis oder Seed. Öffne die Modellseite für Text-zu-Video, um es auszuprobieren; neue Konten erhalten 200 kostenlose Credits.

Welchen Endpunkt sollte man verwenden

	Text-zu-Video	Bild-zu-Video	Fast Bild-zu-Video
Modell-ID	hailuo-2.3/text-to-video	hailuo-2.3/image-to-video	hailuo-2.3-fast/image-to-video
Pflichtparameter	prompt	prompt + image_url	prompt + image_url
6-Sekunden-Video	$0.40	$0.40	$0.27
10-Sekunden-Video	$0.80	$0.80	$0.46
Bildeingabe	keine	ein Startbild	ein Startbild

Aktuelle HiAPI-Preise, überprüft am 20. Oktober 2026. Fehlgeschlagene Aufgaben werden nicht berechnet.

Wenn du eine Szene erkundest, beginne mit Text; wenn das erste Bild exakt sein muss (etwa bei einem vorhandenen Produkt oder einer Figur), beginne mit einem Bild. Bei Bild-zu-Video-Szenarien ist Fast ein Drittel günstiger bei identischen Eingaben, daher kannst du zuerst mit Fast einen Entwurf erstellen und erst dann zum Standardmodell wechseln, wenn eine Einstellung mehr Bewegungsdetails benötigt.

Text-zu-Video: echte Ausgabe

Dies ist das Beispiel auf der Modellseite, Dauer 6 Sekunden:

a kung fu master practicing forms in heavy rain, water droplets scattering in slow motion, smooth natural motion, stable cinematic camera movement, consistent lighting across frames, cinematic composition, dramatic directional lighting, rich cohesive color grade, ultra-detailed, premium commercial finish

Mit diesem Prompt generieren →

hailuo-2.3/text-to-video, 6 Sekunden, 1366×768, kein Audio, $0.40.

In den sechs Sekunden führt der Meister nacheinander mehrere Standhaltungen und Armschläge aus, während im Hintergrund der Regen weiter fällt. Die Kamera bleibt stabil. Obwohl die Anfrage kein Feld für das Seitenverhältnis enthält, ist die Ausgabe im Querformat; bei Text-zu-Video kann kein Hochformat angegeben werden.

Bild-zu-Video: echte Ausgabe

Bild-zu-Video behält dein Bild bei und bringt es in Bewegung. Beide folgenden Beispiele verwenden ein 16:9-Startbild und liefern Ergebnisse mit 1364×768.

Startbild:

steam bursts from the locomotive as it slowly starts moving, wheels turning, smooth natural motion, stable cinematic camera movement, consistent lighting across frames, cinematic composition, dramatic directional lighting, rich cohesive color grade, ultra-detailed, premium commercial finish

Mit diesem Prompt generieren →

hailuo-2.3/image-to-video, 6 Sekunden, 1364×768, kein Audio, $0.40.

Bahnhof, Waggons und Sonnenuntergang bleiben so, wie sie im Bild sind. Die Lokomotive zieht vorwärts, und Dampf breitet sich tief über dem Bahnsteig aus.

Derselbe Ansatz mit Fast, eine ruhigere Szene:

boats rocking gently, seagulls gliding through the morning mist, smooth natural motion, stable cinematic camera movement, consistent lighting across frames, cinematic composition, dramatic directional lighting, rich cohesive color grade, ultra-detailed, premium commercial finish

Mit diesem Prompt generieren →

hailuo-2.3-fast/image-to-video, 6 Sekunden, 1364×768, kein Audio, $0.27.

Die Bewegung ist gering: Die Boote wiegen sich sanft, der Nebel driftet langsam, und gegen Ende erscheint eine Möwe. Für eine so ruhige, atmosphärische Einstellung reicht Fast aus.

Schreibe bei Bild-zu-Video in den Prompt, was als Nächstes passiert. Das Modell hat das Bild bereits gesehen, daher fügt „eine schwarze Lokomotive steht am Bahnhof“ keine Informationen hinzu; „Dampf sprüht hervor, während sie sich in Bewegung setzt“ sagt ihm, was es tun soll.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-2.3/text-to-video",
    "input": {
      "prompt": "A glass of iced tea tips over in slow motion, tea splashing across a wooden table, ice cubes tumbling, macro shot",
      "duration": "6",
      "prompt_optimizer": true
    }
  }'

Du erhältst eine taskId. Frage GET https://api.hiapi.ai/v1/tasks/{taskId} ab, bis data.status success ist, und lade dann data.output[0].url herunter. Videos brauchen einige Minuten, nicht Sekunden.

Für Bild-zu-Video änderst du das Modell und fügst ein Bild hinzu:

{
  "model": "hailuo-2.3-fast/image-to-video",
  "input": {
    "prompt": "The cat stretches, hops off the windowsill and walks toward the camera",
    "image_url": "https://your-cdn.example.com/first-frame.jpg",
    "duration": "6"
  }
}

Python: übermitteln, abfragen, herunterladen

# pip install requests; export HIAPI_KEY=your-key first
import os, time, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=900, **inp):
    r = requests.post(API, json={"model": model, "input": inp}, headers=H, timeout=30).json()
    if r.get("code") != 200:
        raise RuntimeError(r)  # a 400 lists every invalid field at once
    task_id = r["data"]["taskId"]  # save this; if your script dies, poll it again instead of resubmitting
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d.get("error"))
        time.sleep(10)
    raise TimeoutError(task_id)

url = generate("hailuo-2.3/image-to-video",
               prompt="Steam bursts from the locomotive as it slowly starts moving, wheels turning",
               image_url="https://your-cdn.example.com/train.jpg",
               duration="10")  # a string, not 10

with open("hailuo.mp4", "wb") as f:
    f.write(requests.get(url, timeout=120).content)

Ausgabelinks verfallen etwa 7 Tage nach Abschluss der Aufgabe, speichere daher die Datei und nicht nur den Link.

Parameter

Feld	Erforderlich	Werte	Beschreibung
prompt	ja	Text	Bewegung und Kamerabewegung beschreiben
image_url	nur Bild-zu-Video	eine öffentliche URL	ein einzelner String, kein Array. jpeg, png oder webp
duration	nein	"6" (Standard) oder "10"	muss ein String sein
prompt_optimizer	nein	true (Standard) / false	erweitert kurze Prompts vor der Generierung

Bewegung und Kamerabewegung werden im Prompt angegeben. Es gibt keine Felder motion_strength, camera_movement, resolution, aspect_ratio oder seed.

Fehler, die dir begegnen werden

Diese Fehler werden bei der Übermittlung als HTTP 400 zurückgegeben, sodass keine Aufgabe erstellt und nichts berechnet wird:

• duration: got number, want string: Du hast 6 übergeben. Übergib "6".
• duration: value must be one of '6', '10': Es gibt nur zwei Dauern.
• image_url: missing required field "image_url": Bild-zu-Video benötigt ein Startbild. Der Feldname ist im Singular image_url.
• additional properties 'resolution' not allowed (oder aspect_ratio, image_urls, seed): Entferne das Feld.

Wenn eine Aufgabe schließlich mit fail endet, lies data.error. Bei Bild-zu-Video ist die häufige Ursache, dass der Server die Bild-URL nicht abrufen kann, etwa bei einem privaten Bucket oder einem abgelaufenen signierten Link.

Häufige Fragen

Wie viel kostet Hailuo 2.3 pro Sekunde?

Es wird nicht pro Sekunde abgerechnet. Du zahlst pro Video: beim Standardmodell $0.40 für 6 Sekunden und $0.80 für 10 Sekunden; bei Fast $0.27 und $0.46. Umgerechnet kostet ein 6-Sekunden-Video mit dem Standardmodell etwa $0.067 pro Sekunde, mit Fast etwa $0.045 pro Sekunde.

Kann ich Hochformat-Videos generieren?

Bei Text-zu-Video nicht, es hat kein Feld für das Seitenverhältnis und liefert Querformat. Auch Bild-zu-Video hat kein Feld für das Seitenverhältnis; die Dokumentation sagt nicht, ob ein Hochformat-Startbild ein Hochformat-Video erzeugt. Teste daher für $0.27 ein 6-sekündiges Fast-Video, bevor du darauf aufbaust.

Sollte ich prompt_optimizer deaktivieren?

Bei kurzen Prompts lass ihn aktiviert. Deaktiviere ihn, wenn du die Formulierung sorgfältig ausgearbeitet hast und möchtest, dass das Modell sie strikt befolgt.

Gibt es Ton?

Die drei Beispielvideos oben haben keine Tonspur, und es gibt kein Feld, mit dem sich Ton aktivieren lässt.

Ist Fast schlechter?

Es hat dieselben Eingaben und ist ein Drittel günstiger. Im Bootsbeispiel oben ist die Bewegung weich und sauber. Bei Einstellungen mit vielen schnellen Bewegungen generiere zunächst je einen 6-Sekunden-Entwurf mit beiden Modellen zum Vergleich und rendere dann die 10-Sekunden-Version.

Weitere Vergleiche von Videomodellen findest du unter Die günstigsten Bild- und Video-APIs auf HiAPI. Wenn du Hailuo ohne Code ausprobieren möchtest, öffne die Modellseite für Bild-zu-Video.