MiniMax
MiniMax H3
minimax-h3-max/image-to-video
Einheitliches multimodales Videomodell, das Text, Bilder, Videos und Audio in einem einzigen Kontext gleichzeitig verarbeitet, Text-zu-Video, Bild-zu-Video, referenzbasiertes Video und instruktionsgestützte Bearbeitung unterstützt und synchrones Audio erzeugen kann
minimax-h3-max/image-to-video ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
videoPreise
minimax-h3-max/image-to-video per second
| Spezifikationen | Einzelpreis |
|---|---|
| 480P | $0.072 |
| 768P | $0.115 |
| 1080P | $0.229 |
Positionierung im Überblick
MiniMax H3 Max ist eine Bild-zu-Video-Pipeline für Entwickler, die aus einem statischen Bild zuverlässig Videos erzeugen möchten. Ausgehend von einem hochgeladenen Startbild steuert sie anhand des Prompts Bewegungen, Kameraführung und Ton im Bild und gibt Videos mit anpassbarer Dauer und Auflösung aus; zugleich unterstützt sie die Paarung von Start- und Endbild, um den Übergang zwischen beiden Frames zu steuern. Geeignet ist sie für das Erstellen von Werbe-Storyboards, die Animierung von Illustrationen und Produktbildern sowie für Kurzfilm-Generierungsprozesse mit kontrollierbaren Übergängen; über die einheitliche Schnittstelle von HiAPI.ai lässt sie sich mit Abrechnung nach Ausgabedauer aufrufen.
Zentrale Highlights
- Übergangssteuerung mit Start- und Endbild – Es kann entweder nur das Startbild vorgegeben werden, um die Folgebilder zu erzeugen, oder Start- und Endbild, damit das Modell die Bewegung und den Übergang zwischen beiden Bildern ausführt.
- Anpassbare Dauer und Auflösung – Die Dauer lässt sich zwischen 0,92 und 15 Sekunden festlegen; als Auflösung stehen 480P, 768P oder 1080P zur Wahl, je nach Anforderung des Endergebnisses.
- Optionale Ersetzung der Tonspur – Über eine Ziel-Audioadresse lässt sich die Ausgabetonspur ersetzen; zu langes Audio wird am Anfang gekürzt, zu kurzes mit Stille aufgefüllt, was die Abstimmung mit Synchronisation oder Musik erleichtert.
- Prompt-Erweiterung in drei Stufen – Der Erweiterungsmodus ist in Aus, Ausgewogen und Qualität unterteilt, sodass zwischen strikter Befolgung der ursprünglichen Beschreibung und automatischer Ergänzung von Bilddetails gewählt werden kann.
Funktionsbeschreibung
Bild-zu-Video und Start-/Endbild-Steuerung: Das Startbild bestimmt das Seitenverhältnis und erzeugt das Video; wird nur ein Endbild angegeben, richtet sich die Komposition danach, werden beide Frames angegeben, wird der Übergangsprozess gesteuert – geeignet für kontrollierbare Übergänge und Vorher-Nachher-Aufnahmen.
Dauer- und Auflösungsstufen: Eine einzelne Generierung unterstützt 0,92 bis 15 Sekunden und 480P bis 1080P; Entwickler können je nach Verwendungszweck eine Vorschau- oder Lieferstufe wählen und so Kosten vermeiden, die durch einheitlich hohe Spezifikationen im gesamten Ablauf entstehen.
Einspielen einer Tonspur: Wird eine Ziel-Audioadresse übergeben, ersetzt sie die Ausgabetonspur; das Audio muss mindestens 2 Sekunden und darf höchstens 15 MB groß sein, das Modell kürzt oder füllt mit Stille automatisch passend zur Videolänge auf, sodass die nachträgliche Zweitabstimmung bei der Vertonung entfällt.
Prompt-Aufbau: Der Prompt kann bis zu 50000 Zeichen umfassen und beschreibt Bild, Bewegung, Kamera und Ton; der Erweiterungsmodus ist optional Aus, Ausgewogen oder Qualität und steuert die Treue zur ursprünglichen Beschreibung bei der Generierung.
Fester Zufallsseed: Die explizite Übergabe eines Seeds ermöglicht die Reproduktion desselben Ergebnisses; zusammen mit fein abgestimmten Prompts lassen sich Vergleichsexperimente durchführen und so in der Batch-Generierung wirksame Rezepte ermitteln.
Anwendungsfälle
- Werbe- und Storyboard-Teams erzeugen Vorschaufilme aus einem einzigen Key Visual – Startbild hochladen und Bewegung sowie Kamera beschreiben, um Vorschauvideos von 5 bis 15 Sekunden für Präsentationen und die Rhythmusprüfung vor dem Dreh zu erhalten.
- Animierung von Illustrationen und Produktbildern – Ausgehend von Illustrationen oder Produktbildern, bei Bedarf mit Ausgabe in 768P oder 1080P, entstehen direkt einsatzfähige kurze Loop-Videos.
- Szenenübergänge mit festgelegtem Übergang – Start- und Endbild gleichzeitig angeben, damit das Modell den Zwischenprozess ergänzt und natürlich wirkende Übergangssequenzen für die Schnitt-Timeline entstehen.
- Lippensynchronität zu vorhandener Vertonung oder Musik – Eine Ziel-Audioadresse übergeben, um Sequenzen mit passender Tonspur zu erzeugen, die als direkt weiterverarbeitbares Material in die Postproduktion gelangen.
Einschränkungen und Auswahlhinweise
Diese Pipeline akzeptiert ausschließlich Bild-zu-Video und unterstützt weder reine Text-zu-Video-Generierung noch gemischte Eingaben mit Referenzbildern; ein einzelner Clip ist maximal 15 Sekunden lang, längere Erzählungen müssen in Abschnitten generiert und anschließend geschnitten werden. Bei Übergabe eines Ziel-Audios beträgt die Mindestvideodauer 2 Sekunden, und das Audio selbst darf 15 MB nicht überschreiten. Ist das Ziel eine reine Text-zu-Video-Generierung oder sind multimodale Referenzeingaben erforderlich, sollte auf andere Pipelines derselben Familie ausgewichen werden; auch Szenarien ohne Bedarf an Start-/Endbild-Steuerung und Tonspur-Einspielung können eine schlankere Generierungsmethode wählen.
Neuigkeiten
Changelog ansehen →- Neues Modell Neues Modell: minimax-h3 —— native 2K-Videos über POST /v1/tasks generieren, Unterstützung für 4-15 Sekunden Text-zu-Video…
Häufige Fragen
Alle Fragen ansehen →-
Was für ein Videomodell ist MiniMax H3?
Es stellt den Prompt in den Mittelpunkt; optional können Start- und Endbilder oder Referenzbilder, -videos und -audios hinzugefügt werden; die verschiedenen Steuerungsarten sollten gemäß dem aktuellen Parametervertrag kombiniert werden.
-
Welche Ausgabespezifikationen unterstützt MiniMax H3?
Unterstützt 4-15 Sekunden, Auflösungen einschließlich 2K, Seitenverhältnisse einschließlich 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive.
-
Können Audiodaten generiert oder Audio-Referenzen verwendet werden?
Optional Bild-, Video- und Audio-Referenzen; Audiogenerierung wird unterstützt
-
Wie wird MiniMax H3 abgerechnet?
Die Abrechnung erfolgt nach Ausgabedauer und Echtzeit-Stufe; Abweichungen durch Auflösung, Modus oder Tonoptionen richten sich nach dem Seitenpreis und den Aufgabenaufzeichnungen.
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: minimax-h3-max/image-to-video
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für minimax-h3-max/image-to-video und Route default — siehe Parametertabelle unten.
seedintegerOptionalZufälliger Startwert, Ganzzahl. Wird bei Weglassen vom System zufällig gewählt; bei expliziter Angabe von 0 muss er unverändert übergeben werden, um das Generierungsergebnis zu reproduzieren.
promptstringPflichtminLength 1maxLength 50000pattern \SText-Prompt zur Beschreibung des gewünschten Bildinhalts, der Bewegung, der Kameraführung und des Toninhalts.
durationnumberOptionalStandard: 5min 0.92max 15Videodauer, numerischer Wert, Standard 5.
resolutionstringOptionalStandard: "768P"Auflösung des Ausgabevideos, Zeichenkette, Standard 768P.
480P768P1080Plast_frame_imagestringOptionalminLength 1pattern ^https?://[^\s/@]+(?:[/?#][^\s]*)?$Bild des letzten Frames zur Festlegung des Endbilds des Videos; das Seitenverhältnis folgt dem ersten Frame, nur wenn ein letzter Frame angegeben und kein erster Frame angegeben ist, folgt es dem letzten Frame.
target_audio_urlstringOptionalminLength 1pattern ^https?://[^\s/@]+(?:[/?#][^\s]*)?$Ziel-Audioadresse zum Ersetzen der Ausgabespur; die Audiodauer muss mindestens 2 Sekunden betragen und die Größe darf 15 MB nicht überschreiten, bei längerem Audio wird der Anfang abgeschnitten, bei kürzerem Audio wird mit Stille aufgefüllt.
first_frame_imagestringOptionalminLength 1pattern ^https?://[^\s/@]+(?:[/?#][^\s]*)?$Bild des ersten Frames zur Festlegung des Startbilds des Videos; das Seitenverhältnis folgt dem ersten Frame, nur wenn ausschließlich ein letzter Frame vorhanden ist, folgt es dem letzten Frame.
prompt_expansion_modestringOptionalStandard: "balanced"Modus zur Prompt-Erweiterung, Zeichenkette, Standard balanced.
disabledbalancedqualitycallbackobjectOptional
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": "minimax-h3-max/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "768P",
"prompt_expansion_mode": "balanced"
}
}' 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: "minimax-h3-max/image-to-video",
input: {
"prompt": "…",
"duration": 5,
"resolution": "768P",
"prompt_expansion_mode": "balanced"
}
}),
});
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": "minimax-h3-max/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "768P",
"prompt_expansion_mode": "balanced"
}
},
)
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 →-
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
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
-
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
-
Tutorial
So rufen Sie hailuo-2.3/text-to-video über die HiAPI API auf: curl, Python und lauffähige Anfragebeispiele
Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
Runway Gen 4.5 Runway $0.172 /Sekunde -
Veo 3.1 Lite Google $0.060 /Sekunde -
Kling 2.5 Kuaishou $0.060 /Sekunde -
Wan 3.0 Video Alibaba $0.040 /Sekunde -
Kling 3.0 Turbo Kuaishou $0.130 /Sekunde -
Gemini Omni 1.1 Flash Google $0.450 /Video -
Vidu Q3 Vidu $0.149 /Sekunde -
MiniMax H3 MiniMax $0.072 /Sekunde -
Wan 2.7 Video Alibaba $0.100 /Sekunde -
Seedance 2.0 ByteDance $0.017 /Sekunde -
Veo 3.1 Fast Google $0.170 /Sekunde -
Seedance 2.5 ByteDance $0.121 /Sekunde







