MiniMax
Hailuo 2.3
hailuo-2.3/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/image-to-video ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
videoPreise
hailuo-2.3/image-to-video per video
| Spezifikationen | Einzelpreis |
|---|---|
| 6S | $0.400 |
| 10S | $0.800 |
Positionierung und Kurzprofil
hailuo-2.3/image-to-video ist ein Image-to-Video-Modell aus der MiniMax Hailuo 2.3-Serie, das aus einem einzigen Startbild ein Video erzeugt und über die einheitliche Schnittstelle von HiAPI.ai aufgerufen wird. Es zeichnet sich durch die Darstellung von Personenbewegungen und feinen Gesichtsausdrücken aus und bleibt bei stilisierten Bildern wie Anime sowie bei Ganzkörperbewegungsszenen vergleichsweise stabil. Damit eignet es sich für Entwickler und Kreativteams, die statisches Material schnell zu Kurzvideos erweitern möchten. Unterstützt werden fertige Videos mit 6 oder 10 Sekunden; die automatische Prompt-Optimierung lässt sich bei Bedarf aktivieren.
Zentrale Highlights
- Fixierung des Bildanfangs durch ein einzelnes Startbild – Es genügt ein Startbild zusammen mit einer Textbeschreibung, um ein dynamisches Video zu erzeugen, das Komposition und Stil fortsetzt.
- Natürlichere Darstellung von Personenbewegungen und Gesichtsdetails – Bei Nahaufnahmen von Personen und komplexen Ganzkörperbewegungen sind Bewegungsfluss und die Realitätsnähe feiner Mimik verbessert.
- Stabilere Ergebnisse bei stilisierten und kommerziellen Motiven – Bei besonderen Stilen wie Anime und bei Produktwerbebildern bleibt die Konsistenz gut erhalten, sodass sich die Ergebnisse direkt in den Workflow einbinden lassen.
Funktionsbeschreibung
Videogenerierung aus einem einzelnen Bild: Übergibt man ein Startbild im Format jpeg, png oder webp zusammen mit einem Prompt, wird ein Video erzeugt. Mehrere Frames als Material sind nicht nötig, was sich gut für die schnelle Erweiterung vorhandener Bildressourcen eignet.
Zwei Daueroptionen: Die Videolänge lässt sich zwischen 6 und 10 Sekunden festlegen, Standard sind 6 Sekunden. So lässt sich die Produktion an Platzierungsformate oder Storyboard-Längen anpassen.
Automatische Prompt-Optimierung: prompt_optimizer ist standardmäßig aktiviert; das Modell ergänzt und optimiert die Beschreibung automatisch, wodurch sich der Aufwand für die Prompt-Abstimmung reduziert. Er lässt sich auch deaktivieren, um die ursprüngliche Absicht zu bewahren.
Steuerung des Bildinhalts über Textbeschreibung: Der Prompt kann bis zu 2000 Zeichen lang sein und beschreibt die gewünschten Bewegungen, Kameraführungen und die Atmosphäre; zusammen mit dem Startbild gibt er die Gesamtrichtung des Bildes vor.
Anwendungsfälle
- Anime-Kurzfilme für Content-Creator – Mit Charakterillustrationen oder Storyboard-Bildern als Eingabe entstehen dynamische Kurzfilm-Materialien mit einheitlichem Stil für die Veröffentlichung und den Schnitt von Anime-Inhalten.
- Bewegte Materialien für Werbung und Produktpromotion – Mit Produktbildern und Szenenbeschreibungen als Eingabe werden kurze Produktpräsentationsvideos erzeugt, etwa für E-Commerce-Detailseiten und Feed-Platzierungen.
- Dynamisierung von Personenaufnahmen – Mit Kostüm- oder Szenenfotos von Personen werden Clips mit Ganzkörperbewegungen und Gesichtsausdrücken erzeugt, etwa für Kurzserien, Tanz und Social-Content.
- Schnelle Visualisierung kreativer Skripte – Konzeptbilder beschleunigen Testaufnahmen im schnellen Takt und ermöglichen eine kostengünstige Prüfung von Kameraeinstellungen und Bewegungsvorstellungen für kreative Reviews und Konzeptfreigaben.
Einschränkungen und Auswahlhinweise
Die Generierung wird ausschließlich durch ein einzelnes Startbild gesteuert; eine Kontrolle von Start- und Endframe wird nicht geboten, sodass der Bildendpunkt nicht präzise festgelegt werden kann. Das Ergebnis hat eine feste Dauer von 6 oder 10 Sekunden; für eine feinere Längenabstimmung sollte dies im Schnitt erfolgen. Das Modell eignet sich für Personendarstellungen, stilisierte Bilder und kommerzielle Produktkurzfilme. Soll ein Bild rein aus Text von Grund auf konzipiert werden, ist die Text-to-Video-Variante derselben Serie zu wählen; steht schnelles iteratives Testen im Vordergrund, kommt eine Version der Serie mit Fokus auf Geschwindigkeit und Kosten in Betracht.
Neuigkeiten
Changelog ansehen →- Neues Modell Neues Modell verfügbar: hailuo-2.3-fast/image-to-video
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
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer 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-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
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
modelstringPflichtAktueller Festwert: hailuo-2.3/image-to-video
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für hailuo-2.3/image-to-video und Route default — siehe Parametertabelle unten.
promptstringPflichtminLength 1maxLength 2000Der Text-Prompt zur Beschreibung des zu generierenden Videoinhalts.
durationstringOptionalStandard: "6"Dauer des generierten Videos in Sekunden, Standardwert 6 Sekunden.
610image_urlstringPflichtURL des ersten Einzelbildes; nur ein einzelnes Bild wird unterstützt; unterstützte Formate sind jpeg, png, webp, SVG wird nicht unterstützt.
prompt_optimizerbooleanOptionalStandard: trueOb der Prompt automatisch optimiert werden soll, um bessere Generierungsergebnisse zu erzielen; Standardwert true.
callbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
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.
urlstringPflichtPflicht, 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.
finalstoragestringOptionalStandard: "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.
temppersistentAnfragebeispiele
# 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/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/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/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
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelö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.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
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.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-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
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
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"
}
}
} Artikel
Alle Artikel ansehen →-
Vergleichstest
hailuo-2.3-fast/image-to-video im Quervergleich: Wie man Bild-zu-Video-Modelle auswählt und worauf bei der Migration zu achten ist
-
Tutorial
So rufen Sie kling-4.0/image-to-video auf HiAPI auf: curl, Python und Polling
-
Tutorial
Kandinsky 6.0 Pro Text-zu-Video auf HiAPI: curl- und Python-Tutorial
Eine anfrageorientierte praktische Demonstration: Aufbau des Aufrufs vom Prompt zum Videoclip, Absenden der Anfrage, Abfragen des Fertigstellungsstatus und Herunterladen des Ergebnisses
-
Vergleichstest
Recraft v4.1 Flash 文生图横向对比:Entwickler-Auswahl und Migrationsleitfaden
Mit Kosten von $0,01 pro Bild und reiner Text-zu-Bild-Fähigkeit beurteilen, ob es zu Ihrer Bildgenerierungs-Pipeline passt
-
Tutorial
So rufen Sie hailuo-2.3/text-to-video über die HiAPI API auf: curl, Python und lauffähige Anfragebeispiele
-
Tutorial
So rufen Sie hailuo-2.3-fast/image-to-video über die HiAPI API auf: curl und Python in der Praxis
Die erste lauffähige Anfrage für die schnelle, kostengünstige Bild-zu-Video-Stufe – von der Modell-ID bis zum heruntergeladenen MP4
-
Tutorial
So nutzt du kling-4.0/text-to-video über die HiAPI-API: curl, Python und ein lauffähiges Anforderungsbeispiel
Ein praxisnaher Leitfaden für Entwickler: filmische Prompts, synchrones Audio, asynchrones Polling und Download der Ausgabe
-
Tutorial
kandinsky-6.0-pro/image-to-video auf HiAPI: Tutorial mit curl und Python
Eine funktionierende Bild-zu-Video-Anfrage auf HiAPI ausführen: vom Upload des ersten Frames über asynchrones Polling bis zum finalen Download
Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
Grok Imagine 1.5 Lite xAI $0.029 /Sekunde -
Seedance 2.5 ByteDance $0.121 /Sekunde -
Wan 2.7 Video Alibaba $0.100 /Sekunde -
Kling 4.0 Kuaishou $0.330 /Sekunde -
Gemini Omni Google -- -
FLUX 3 Max Black Forest Labs $0.061 /Sekunde -
Grok Imagine 1.5 xAI $0.011 /Sekunde -
Creatify Boreal Creatify $0.015 /Sekunde -
FLUX 3 Video Black Forest Labs $0.090 /Sekunde -
HeyGen Avatar IV HeyGen $0.150 /Sekunde -
Wan 3.0 Video Alibaba $0.040 /Sekunde -
LTX 2.5 Fast Lightricks $0.086 /Sekunde



