Einführung
Die Bild-zu-Video-API von MiniMax H3 Lite verwandelt ein Standbild in einen 4–15 Sekunden langen Clip mit Ton in 480p oder 768p. Senden Sie ein Startbild, optional ein Schlussbild, und prüfen Sie die Bewegung in 480p, bevor Sie für einen schärferen Render zahlen. Die leichte Variante eignet sich zum Ausprobieren von Ideen und zum Erstellen mehrerer Versionen. Jede Anfrage ergibt genau eine MP4-Datei, in der Bild und Ton zusammen entstehen.
Modus nach Ausgangsmaterial wählen
| Was Sie haben | Modus |
|---|---|
| nur eine Idee | MiniMax H3 Lite Text zu Video |
| ein Standbild zum Animieren, optional mit Endbild | MiniMax H3 Lite Bild zu Video |
| Personen, Outfits, Orte, Bewegungsclips oder Stimmen | MiniMax H3 Lite Referenz zu Video |
Wichtige Funktionen und Highlights
Das Bild bestimmt den Look
Das Startbild legt Gesichter, Kleidung, Licht und Komposition fest, sodass MiniMax H3 Lite den Prompt für das einsetzt, was sich bewegt. Der Clip übernimmt die Form Ihres Bildes. Ein Feld für das Seitenverhältnis gibt es nicht; schneiden Sie das Bild vor dem Hochladen auf Quer- oder Hochformat zu.
Optionales Endbild
Senden Sie ein zweites Bild als last_image_url, dann kommt der Clip auf ihm zur Ruhe. Aus zwei Standbildern wird so ein geplanter Übergang. Statt ein Ende zu erfinden, plant das Modell die Bewegung zwischen den beiden Bildern, was hilft, wenn eine Einstellung in die nächste übergehen muss.
Ton inklusive
Die Bewegung kommt mit passendem Ton: Brandung, Schritte, ein Lachen oder eine zitierte Zeile, zusammen mit dem Bild ohne Aufpreis erzeugt. Fügen Sie eine Audio:-Zeile hinzu, wenn Sie einen bestimmten Musikstil oder Raumton möchten statt dessen, was die Szene vorgibt.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Pflicht, 1 bis 7.000 Zeichen; längere Prompts werden abgelehnt. Gesprochene Zeilen in doppelte Anführungszeichen setzen. mindestens 1 Zeichen · höchstens 7000 Zeichen |
image_url | Ja | Pflicht, das Startbild. Der Clip behält seine Form. |
last_image_url | Nein | Optionales Schlussbild, auf dem der Clip endet. Ändert den Preis nicht. |
resolution | Nein |
|
duration_seconds | Nein | Ganze Sekunden, 4 bis 15, Standard 5. Abgerechnet pro Sekunde zusammen mit der Auflösung. |
Preis
Die Ausgabe wird pro Sekunde zu dem Satz der gewählten Auflösung berechnet, 480p oder 768p. Den aktuellen Satz zeigt immer die Modellseite.
| Spezifikation | Preis |
|---|---|
| $0.025 / Sekunde |
| $0.04 / Sekunde |
Anwendungsfälle
Produkt- und Modestills, die sich bewegen
Ein Katalogfoto von einer Jacke, einer Tasche oder einem Paar Schuhe kann auf MiniMax H3 Lite einen kurzen Clip eröffnen: Das Modell geht, dreht sich oder nimmt den Artikel auf, während das Licht des Originalshootings erhalten bleibt. Bei einfachen Bewegungen spart das eine Neuaufnahme.
Ein Porträt zum Leben erwecken
Ein einzelnes Porträt wird auf MiniMax H3 Lite zu einem kurzen Clip mit natürlicher Bewegung und Ton, ohne dass Sie den Look von Grund auf beschreiben müssen. Schon ein Lächeln, eine Kopfdrehung oder ein Schritt zur Kamera kann ein Profilbild oder eine Charakterkarte zum Leben erwecken.
Kontrollierte Übergänge
Mit einem Start- und einem Endbild füllt MiniMax H3 Lite die Bewegung zwischen zwei Standbildern aus. Das eignet sich für Vorher-nachher-Aufnahmen, Outfitwechsel oder Story-Momente, in denen eine Figur in einer Haltung startet und in einer anderen endet.
Prompt-Leitfaden und Praxistipps
Den nächsten Moment beschreiben, nicht das Bild
Das Startbild zeigt bereits, wer und wo. Nutzen Sie den Prompt für Handlung, Kamerabewegung und den folgenden Ton, in der Reihenfolge des Geschehens. Wer das Bild erneut beschreibt, friert es eher ein, während eine klare erste Handlung, etwa sie dreht sich zum Fenster, es in Bewegung setzt.
Bilder wählen, die in die Grenzen passen
Bilder müssen 256 bis 5.760 Pixel je Seite messen und ein Seitenverhältnis von 0,4 bis 2,5 haben. Beschneiden Sie extreme Panoramen, bevor Sie sie senden. Ein scharfes, gut beleuchtetes Bild mit klar sichtbarem Motiv hält Gesichter ruhiger als ein kleines oder stark komprimiertes.
Passende Bilder paaren
Ein Endbild funktioniert am besten, wenn es dieselben Personen und denselben Raum zeigt wie das Startbild, mit einer Veränderung, die der Prompt erklären kann, etwa einer neuen Pose, einem Schritt näher oder einem anderen Ausdruck. Zwei unzusammenhängende Bilder erzwingen einen schnittartigen Sprung.
Die Ausgabe wird pro Sekunde zu dem Satz der gewählten Auflösung berechnet, 480p oder 768p. Den aktuellen Satz zeigt immer die Modellseite.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-lite/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
