Mit hailuo-2.3-fast/image-to-video auf hiapi Kurzvideos im Batch generieren

Der Erfolg von Kurzvideos hängt von der Iterationsgeschwindigkeit ab. Wenn dein Workflow eine Pipeline für TikTok oder Reels ist, brauchst du keine cineastische 4K-Ausgabe – du brauchst ein Modell, das ein statisches Produktbild in weniger als einer Minute in einen brauchbaren Clip verwandelt, und das kostengünstig genug ist, um Dutzende Varianten durchlaufen zu lassen, bevor du die beste auswählst. Genau hierfür ist hailuo-2.3-fast/image-to-video positioniert: der Fast-Tier-Bruder von hailuo-2.3, dessen Preisgestaltung und Tuning speziell auf hochvolumige, verwerfbare Mehrfachversuch-Workflows ausgerichtet sind.

Dieser Leitfaden zeigt dir, wie du es als Batch-Kurzvideomaschine einsetzt: wie du die Quell-Standbilder auswählst, wie du es über die asynchrone Task-API ansteuerst, wie du die Schema-Details validierst, die dir sonst 400-Fehler einbringen, und wie du über die Wirtschaftlichkeit beim Betrieb im TikTok/Reels-Maßstab nachdenkst.

Was das Modell dir bietet

hailuo-2.3-fast/image-to-video nimmt ein Standbild und einen Prompt entgegen und animiert es zu einem Kurzvideoclip. Es ist auf der Modellseite von hailuo-2.3-fast/image-to-video zu finden und – wie alle Modelle auf hiapi – über den einheitlichen asynchronen /v1/tasks-Endpunkt aufrufbar: Du POSTest einen Task, pollst (oder registrierst einen Callback), bis er abgeschlossen ist, und holst dann das Video von einer kurzlebigen Ausgabe-URL ab.

Zum Zeitpunkt der Erstellung dieses Artikels gegen die Live-API verifiziert:

• Eingabe: ein Bild (image_url) + ein Text-Prompt, der die gewünschte Bewegung beschreibt
• Ausgabe: MP4, feste Dauer 6 s oder 10 s (keine beliebige Länge)
• Preisgestaltung: Pauschalpreis pro Video statt Abrechnung pro Sekunde – 6-Sekunden-Clip $0.27, 10-Sekunden-Clip $0.46
• Bearbeitungszeit: unser Testclip war in etwa 80 Sekunden end-to-end fertig (Einreichung → Erfolg)

Der Pauschalpreis pro Video ist das entscheidende Detail für Batch-Jobs: Ein 6-Sekunden-Versuch kostet dasselbe, egal ob dein Prompt die Bewegung beim ersten Mal trifft oder ob du bereits beim vierten Versuch bist. Zum Fast-Tier-Preis kostet es weniger als ein einzelner Versuch der meisten High-End-Videomodelle, 5–6 Varianten desselben Key Visuals durchlaufen zu lassen, um die mit der flüssigsten Bewegung zu finden. Bevor du ein Batch-Budget aufstellst, prüfe die aktuellen Zahlen auf der Preisseite – Preise ändern sich.

Wenn du eine vollständige Parameterreferenz, längere Daueroptionen oder einen direkten Vergleich mit dem Nicht-Fast-Tier hailuo-2.3 benötigst, lies unser hailuo-2.3-fast/image-to-video API-Integrations-Tutorial – dieser Leitfaden konzentriert sich auf die Batch-/Workflow-Perspektive statt auf die reine API-Referenz.

Workflow: Standbild → Kurzvideoclip

Das Kurzvideo-Muster ist einfach: Ausgehend von einem Standbild, das du bereits hast (Produktfotografie, generierter Hero-Shot, Markenmaterial), lässt du das Modell Bewegung hinzufügen – langsames Hineinfahren, dezente Rotation, wehende Atmosphäre – statt ein Video von Grund auf zu generieren. So bleibt deine visuelle Identität fixiert (gleiches Produkt, gleiches Licht, gleiche Komposition), während du Inhalte erzeugst, die keine statischen Posts sind.

Hier ein realer Durchlauf: ein vertikales (9:16) Standbild eines Sneakers auf einem beleuchteten Sockel, angesteuert mit einem Bewegungsprompt, der langsames Hineinfahren und sanfte Rotation beschreibt.

Das Quell-Standbild und die vollständige Anfrage:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-2.3-fast/image-to-video",
    "input": {
      "prompt": "Slow smooth push-in on a chunky retro basketball sneaker in wolf-gray suede with volt yellow laces, floating above a wet concrete pedestal, subtle rotation revealing the side panel, mist drifting through teal-to-amber rim light, dust particles catching the light, stable cinematic camera movement, premium commercial product-video finish",
      "image_url": "https://static.hiapi.ai/gallery/2026/07/c2e71481d2eb81a7.jpg",
      "duration": "6",
      "prompt_optimizer": true
    }
  }'

Antwort:

{"code":200,"data":{"taskId":"tk-hiapi-01KZ5FJV0TB8EYKDCV58FQ1F2X"},"message":"success"}

Polling bis zur Auflösung:

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

{
  "status": "success",
  "output": [{"type": "video", "url": "https://temp.hiapi.ai/.../result.mp4", "expireAt": 1786421652}]
}

Die output[0].url ist temporär – lade sie sofort herunter und speichere sie in deinem eigenen Storage. Verlinke sie nicht hot und speichere sie nicht in einem Datenbankfeld in der Hoffnung, dass sie eine stabile URL ist.

Eingabe-Schema (gegen die Live-API verifiziert)

Das Schema dieses Modells ist deutlich enger als das, was du von anderen Videomodellen auf der Plattform erwartest – keine Seitenverhältnis-Steuerung, keine Auflösungsstufen, kein Seed.

Feld	Typ	Einschränkung	Pflichtfeld
prompt	string	beschreibt Bewegung/Szene	ja
image_url	string	Singular – eine öffentliche URL, kein Array	ja
duration	string	Enum "6" oder "10" – als String, nicht als Zahl	ja
prompt_optimizer	boolean	erlaubt der Plattform, deinen Prompt umzuschreiben/zu erweitern	nein

Wenn du Annahmen von anderen Modellen übernimmst, gibt es zwei Fallstricke, die dir 400-Fehler einbringen:

1. image_url ist Singular, nicht image_urls. Mehrere andere i2v-Modelle auf hiapi nehmen ein Array von Referenzbildern entgegen; dieses Modell nimmt nur eines. Wenn du ein Array sendest, bekommst du einen Fehler über ein fehlendes Feld statt einer hilfreichen Typkonvertierung.
2. duration muss der String "6" oder "10" sein, nicht die Zahl 6. Das Senden der Zahl 6 liefert duration: got number, want string. Und jeder Wert außerhalb dieser beiden Enum-Werte wird nicht akzeptiert – dieses Tier bietet keine beliebige Dauersteuerung.

Das Senden von aspect_ratio, resolution, seed oder watermark – alles gängige Felder bei den Schwestermodellen – wird direkt abgelehnt mit additional properties ... not allowed. Das Modell übernimmt das Seitenverhältnis vom Eingabebild. Wenn du also eine 9:16-Ausgabe für Reels/TikTok benötigst, schneide oder generiere das Quell-Standbild vor der Einreichung auf 9:16 (genau das haben wir mit dem Sneaker-Standbild oben gemacht).

End-to-End in Python

import requests
import time

API_BASE = "https://api.hiapi.ai/v1/tasks"
API_KEY = "your-api-key"

def make_short_clip(prompt: str, image_url: str, out_path: str, duration: str = "6"):
    resp = requests.post(
        API_BASE,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "hailuo-2.3-fast/image-to-video",
            "input": {
                "prompt": prompt,
                "image_url": image_url,
                "duration": duration,  # must be a string: "6" or "10"
                "prompt_optimizer": True,
            },
        },
        timeout=60,
    )
    resp.raise_for_status()
    task_id = resp.json()["data"]["taskId"]

    while True:
        task = requests.get(f"{API_BASE}/{task_id}",
                             headers={"Authorization": f"Bearer {API_KEY}"},
                             timeout=30).json()["data"]
        if task["status"] == "success":
            break
        if task["status"] == "fail":
            raise RuntimeError(task.get("error"))
        time.sleep(8)

    video_url = task["output"][0]["url"]  # temporary link — download immediately
    video_bytes = requests.get(video_url, timeout=120).content
    with open(out_path, "wb") as f:
        f.write(video_bytes)
    return out_path

Für echte Batch-Läufe – etwa 6 Prompt-Varianten desselben Quell-Standbilds zu testen, um die flüssigste Bewegung auszuwählen – packe diese Funktion in eine Schleife über eine Prompt-Liste und prüfe jeden task_id unabhängig, statt sequenziell zu blockieren; bei etwa 80 Sekunden pro Clip ist das parallele Ausführen mehrerer Tasks der Grund, warum sich das Fast-Tier wirklich schnell anfühlt.

Häufige Fragen

Kann ich das Seitenverhältnis der Ausgabe steuern? Nein – dieses Modell hat kein aspect_ratio-Feld, und das Senden würde einen 400-Fehler liefern. Die Ausgabe folgt dem Seitenverhältnis des Eingabebilds, also bereite das Quell-Standbild vor der Einreichung im gewünschten Verhältnis vor (9:16 für Reels/TikTok, 1:1 für Feed-Posts).

Warum schlägt meine Anfrage mit "got number, want string" fehl? Du hast duration als JSON-Zahl gesendet. Es muss der String "6" oder "10" sein – das sind die einzigen beiden gültigen Werte.

Ist das dasselbe Modell wie hailuo-2.3/image-to-video (Nicht-Fast)? Nein – das Fast-Tier ist ein eigenständiges, separat bepreistes Modell auf hiapi mit eigenem Schema, das auf Geschwindigkeit und Kosten statt auf das Standard-Tier abgestimmt ist. Wenn du einen Nicht-Batch-Referenzdurchlauf benötigst, lies das vollständige Integrations-Tutorial.

Kann ich ihm generierte Bilder statt echter Fotos zuführen? Ja – das Quell-Standbild kann von jedem Bildmodell auf hiapi (oder anderswo) stammen, solange es eine öffentlich zugängliche URL ist. Die Verwendung von Standbildern, die du bereits für andere Formate erzeugt hast (Produkt-Key-Visuals, Poster), ist meist der schnellste Weg zu einem Kurzvideo, ohne einen separaten Kreativprozess.

Ändert sich der Preis je nach Auflösung? Dieses Modell hat keinen Auflösungsparameter, daher ist der Preis unabhängig von der Auflösung des Eingabebilds ein Pauschalpreis pro Dauer – zum Zeitpunkt der Erstellung dieses Artikels 6s $0.27, 10s $0.46. Bestätige dies auf der Preisseite.

Die wichtigsten Punkte

• hailuo-2.3-fast/image-to-video verwandelt ein Standbild in ein 6s- oder 10s-MP4, pauschal pro Video bepreist ($0.27 / $0.46) statt pro Sekunde – günstig genug, um mehrere Prompt-Varianten pro Quellbild durchlaufen zu lassen.
• Das Schema ist bewusst schmal: prompt, image_url (Singular), duration (String-Enum "6"/"10") sowie optional prompt_optimizer – keine Steuerung von Seitenverhältnis, Auflösung oder Seed.
• Die Ausgabe übernimmt das Seitenverhältnis des Eingabebilds, also bereite das Quell-Standbild vor der Einreichung auf 9:16 vor (oder welches Verhältnis deine Plattform auch immer benötigt).
• Die beiden häufigsten Integrationsfehler sind das Senden von image_url als Array und das Senden von duration als Zahl statt als String.
• Für Batch-Kurzvideoworkflows machen der Pauschalpreis pro Video und die Bearbeitungszeit von etwa 80 Sekunden es praktikabel, mehrere Versuche zu generieren und die beste Bewegung auszuwählen, statt pro Asset nur eine Generierung einzureichen.

Bereit, es mit deinen eigenen Produktbildern auszuprobieren? Gehe zur Modellseite von hailuo-2.3-fast/image-to-video und teste eine Anfrage direkt, oder schau dir den vollständigen Modellkatalog an, wenn du zuerst das Fast-Tier mit anderen Image-to-Video-Optionen vergleichen möchtest.