MiniMax

Hailuo 2.3

hailuo-2.3-fast/image-to-video

Ein von MiniMax vorgestelltes Videogenerierungsmodell, das sowohl Text-zu-Video als auch Bild-zu-Video unterstützt und bei Anime-Stilkonsistenz, Ganzkörperbewegungsdarstellung und der Realitätstreue von Gesichtsmikroausdrücken gegenüber der Vorgängergeneration verbessert wurde – ideal für Anime-Kurzfilme und kommerzielle Produktionen mit realistischem Look

hailuo-2.3-fast/image-to-video hailuo-2.3/image-to-video hailuo-2.3/text-to-video

hailuo-2.3-fast/image-to-video ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

video

Fülle die Parameter aus und generiere – die Ergebnisse erscheinen hier.

Preise

hailuo-2.3-fast/image-to-video per video

Spezifikationen	Einzelpreis
6S	$0.270
10S	$0.460

Kurzprofil

Hailuo 2.3-Fast ist die schnelle Bild-zu-Video-Version der MiniMax Hailuo 2.3-Serie. Sie nimmt ein Startbild und eine Textaufforderung entgegen und erzeugt ein 6- oder 10-sekündiges Video, wobei sie Wert auf die Natürlichkeit von Figurenbewegungen und mimischen Mikroexpressionen sowie auf stabile Ausgaben bei stilisierten Bildern wie Anime legt. Sie eignet sich für Entwickler, die mit einem einzelnen Bild schnell Testaufnahmen machen, Storyboards iterieren oder Kurzvideos produzieren möchten, und ist über die einheitliche Schnittstelle von HiAPI.ai zugänglich.

Kernhighlights

Leichtgewichtige, schnelle Version für Bild-zu-Video – Die Serie umfasst außerdem eine Vollversion und ein Text-zu-Video-Modell; Fast konzentriert sich auf die Effizienz der Ausgabe aus einem einzelnen Bild und eignet sich für schnelle Testaufnahmen und Iterationen in der Frühphase.
Startbild treibt die Bewegung direkt an – Es genügt ein Startbild im Format jpeg, png oder webp zusammen mit einer Aufforderung, um fortlaufende Bewegtbilder zu erzeugen.
Optionale automatische Prompt-Optimierung – prompt_optimizer ist standardmäßig aktiviert und kann die Generierungsergebnisse verbessern, ohne den Prompt neu zu schreiben.
Zwei Laufzeitoptionen von 6 und 10 Sekunden – Durch Umschalten der Laufzeit lassen sich Materiallänge und Generierungsaufwand ausbalancieren, was sowohl Kurzvideos als auch Storyboard-Entwürfe abdeckt.

Funktionsbeschreibung

Videogenerierung aus einem einzelnen Startbild: Übergibt man ein Startbild und eine Textbeschreibung, wird ein Bewegtbildvideo ausgegeben, das statisches Material direkt in abspielbares Bildmaterial verwandelt.

Steuerung des Bildinhalts per Textaufforderung: Das Feld prompt unterstützt Beschreibungen von bis zu 2000 Zeichen, um Aktionen, Kameraführung und Bildinhalt festzulegen und die Generierungsrichtung zu steuern.

Wählbare Laufzeit: duration bietet die zwei Optionen 6 Sekunden und 10 Sekunden; Entwickler können die Länge des fertigen Videos je nach Veröffentlichungsplattform oder Storyboard-Struktur wählen.

Automatische Prompt-Optimierung: prompt_optimizer ist standardmäßig aktiviert und kann Prompts automatisch ergänzen und umschreiben, wodurch sich der Trial-and-Error-Aufwand beim wiederholten Parameter-Tuning verringert.

Anwendungsfälle

Anime- und Stilcontent-Kreative: einzelnes Charakterbild + Bewegungsprompt – Illustrationen oder Charakterdesigns in kurze Videoclips mit Bewegung verwandeln, für Anime-Kurzfilme, Social-Media-Inhalte oder dynamische Poster.
Kurzvideoteams: Figurenbild + Darstellungsbeschreibung – Aus einem Figuren-Startbild Clips mit Tanz, Körperbewegungen oder Mimik erzeugen, als fertiges Material oder Storyboard-Entwurf.
Produkt- und Werbekommunikation: Produktbild + Präsentationsskript – Standbilder von Produkten in dynamische Präsentationsvideos verwandeln, für schnelle Entwürfe von E-Commerce-Detailseiten, Feed-Anzeigen oder Werbekurzfilmen.
Kreativteams: visuelle Testaufnahmen von Skripten – Mit einem einzelnen Bild schnell 6- oder 10-sekündige Clips generieren, um die kreative Richtung zu validieren, bevor über die formelle Produktion entschieden wird.

Einschränkungen und Auswahlhinweise

Es wird ausschließlich die Steuerung durch ein einzelnes Startbild unterstützt; eine Kontrolle von Start- und Endbild ist nicht möglich. Eingabebilder müssen im Format jpeg, png oder webp vorliegen, SVG wird nicht unterstützt. Die Fast-Version bietet nur Bild-zu-Video, keinen Text-zu-Video-Pfad; wer reine Text-zu-Video-Generierung oder die Bildqualität der Vollversion benötigt, sollte auf das Text-zu-Video- oder das vollwertige Bild-zu-Video-Modell derselben Serie ausweichen. Für Auflösung und Generierungsgeschwindigkeit fehlen offizielle Parameterbelege; bei der Auswahl empfiehlt es sich, zunächst mit kleinen Stückzahlen zu testen und dann zu entscheiden.

Neuigkeiten

Changelog ansehen →

Neues Modell Neues Modell verfügbar: hailuo-2.3-fast/image-to-video Nov 3, 2026

Häufige Fragen

Alle Fragen ansehen →

Erfordert Hailuo 2.3 Image to Video das Hochladen eines Bildes?

Ja. Der aktuelle Pfad hailuo-2.3/image-to-video ist eine Image-to-Video-Route: Das Eingabebild bestimmt das Motiv und die Ausgangskomposition, der Prompt steuert Bewegung, Kamera und Umgebungsveränderungen.
Welche Dauern und Auflösungen unterstützt Hailuo 2.3 Image to Video?

Der aktuelle HiAPI-Anfragevertrag unterstützt 6s / 10s. Maßgeblich sind die Parameterleiste der Seite und die API-Dokumentation.
Wie erfolgt die Abrechnung für Hailuo 2.3 Image to Video?

Aufgaben werden pro Video basierend auf der gewählten Dauerstufe abgerechnet. Die Seite zeigt die aktuellen Preise in der globalen Währungseinheit an; die endgültige Abrechnung richtet sich nach den erfolgreich aufgezeichneten Aufgaben.
Wie lässt sich die Stabilität des Hauptmotivs bei der Bild-zu-Video-Generierung verbessern?

Verwenden Sie ein Eingabebild mit klarem Hauptmotiv, wenigen Verdeckungen und vollständiger Komposition; beschreiben Sie im Prompt zuerst die Hauptaktion und die Kameraführung und listen Sie anschließend das unbedingt beizubehaltende Aussehen, Material und die Hintergrundbeziehungen auf. Für den ersten Test wird eine kürzere Dauer empfohlen.

Generierungsaufgabe erstellen

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.

Idempotency-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.

Body

modelstringPflicht

Aktueller Festwert: hailuo-2.3-fast/image-to-video

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für hailuo-2.3-fast/image-to-video und Route default — siehe Parametertabelle unten.

promptstringPflichtminLength 1maxLength 2000

Textbeschreibung für die Videogenerierung, die den gewünschten Inhalt des zu erzeugenden Bildes angibt. Nimmt einen Zeichenkettenwert an.

durationstringOptionalStandard: "6"

Dauer des zu generierenden Videos in Sekunden. Nimmt einen numerischen Wert als Zeichenkette an, Standard 6.

Optionen:610

image_urlstringPflicht

URL des ersten Frame-Bildes, nur ein einzelnes Bild wird unterstützt, Format jpeg/png/webp, SVG wird nicht unterstützt. Nimmt einen Zeichenkettenwert an.

prompt_optimizerbooleanOptionalStandard: true

Ob der Prompt automatisch optimiert werden soll, um bessere Generierungsergebnisse zu erzielen. Nimmt einen booleschen Wert an, Standard true.

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.

urlstringPflicht

Pflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.

whenstringOptionalStandard: "final"

Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.

Optionen:final

storagestringOptionalStandard: "temp"

Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.

Optionen:temppersistent

Anfragebeispiele

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
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": "…",
    "duration": "6",
    "image_url": "…",
    "prompt_optimizer": true
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "hailuo-2.3-fast/image-to-video",
    input: {
      "prompt": "…",
      "duration": "6",
      "image_url": "…",
      "prompt_optimizer": true
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "hailuo-2.3-fast/image-to-video",
        "input": {
          "prompt": "…",
          "duration": "6",
          "image_url": "…",
          "prompt_optimizer": True
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

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

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Aufgabendetails abrufen

GET https://api.hiapi.ai/v1/tasks/:id

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

queued Eingereiht, noch nicht gestartet. handling In Verarbeitung. archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet. success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben). fail Endzustand: fehlgeschlagen (error wird zurückgegeben). Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-Sekunden des Endzustands; vor Abschluss stets 0.

outputarrayOptional

Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).

Array [ object ]

Array-Elemente

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

Antwortbeispiele

Erfolg

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In Bearbeitung (nicht final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fehlgeschlagen

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}