Einführung
Bild zu Video mit MiniMax H3 HighSpeed geht von einem vorhandenen Standbild aus und animiert es zu einer MP4-Datei von 4 bis 15 Sekunden in 768p, mit Ton. Das Bild legt den Look fest; der Prompt muss nur sagen, was sich bewegt.
Modus nach Ausgangsmaterial wählen
| Was Sie haben | Modus |
|---|---|
| nur eine Idee | MiniMax H3 HighSpeed Text zu Video |
| ein Standbild zum Animieren, optional mit Endbild | MiniMax H3 HighSpeed Bild zu Video |
| Personen, Outfits, Orte, Bewegungsclips oder Stimmen | MiniMax H3 HighSpeed Referenz zu Video |
Wichtige Funktionen und Highlights
Das Bild bestimmt den Look
Gesichter, Kleidung, Licht und Bildaufbau stammen aus Ihrem Startbild. Der Clip behält dessen Form, und ein Feld für das Seitenverhältnis gibt es nicht; beschneiden Sie das Standbild also vor dem Senden auf das gewünschte Format, quer oder hoch.
Optionales Endbild
Mit last_image_url läuft der Clip auf dem zweiten Bild aus, und Sie steuern die Bewegung zwischen zwei Standbildern. Das hilft, wenn eine Einstellung sauber in die nächste übergehen muss.
Ton inklusive
Zur Bewegung kommt passender Ton wie Brandung, Schritte, ein Lachen oder eine zitierte Zeile, ohne Aufpreis. Eine Audio:-Zeile im Prompt steuert den Musikstil oder den Raumklang.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Pflicht. Erlaubt sind 1 bis 7.000 Zeichen, längere Eingaben werden abgelehnt. mindestens 1 Zeichen · höchstens 7000 Zeichen |
image_url | Ja | Pflicht: das Startbild, dessen Form der Clip übernimmt. Jede Seite muss 256 bis 5.760 Pixel messen, das Verhältnis von Breite zu Höhe zwischen 0,4 und 2,5 liegen. |
last_image_url | Nein | Optionales Endbild, auf dem der Clip ausläuft. Verursacht keine Mehrkosten. |
resolution | Nein |
|
duration_seconds | Nein | Eine ganze Zahl von 4 bis 15 (Standard 5); jede Sekunde wird zum 768p-Preis berechnet. Eine Anfrage über 4 Sekunden kam als Clip von 3,75 Sekunden zurück. |
Preis
Bezahlt wird jede Sekunde des fertigen Clips in 768p; den aktuellen Preis zeigt die Modellseite.
| Spezifikation | Preis |
|---|---|
| $0.072 / Sekunde |
Anwendungsfälle
Produkt- und Modestills, die sich bewegen
Ein Katalogfoto einer Jacke, Tasche oder eines Schuhpaars kann einen kurzen Clip eröffnen, in dem der Artikel getragen, gedreht oder aufgenommen wird, im Licht der ursprünglichen Aufnahme.
Ein Porträt zum Leben erwecken
Ein einzelnes Porträt wird zu einem kurzen Clip mit einem Lächeln, einer Kopfdrehung oder einem Schritt auf die Kamera zu; das genügt, um ein Profilbild oder eine Figurenkarte zum Leben zu erwecken.
Kontrollierte Übergänge
Mit Start- und Endbild füllt das Modell die Bewegung dazwischen auf: Vorher-nachher-Aufnahmen, Outfitwechsel oder eine Figur, die in einer Pose beginnt und in einer anderen endet.
Prompt-Leitfaden und Praxistipps
Den nächsten Moment beschreiben, nicht das Bild
Nutzen Sie den Prompt, um dem Bild eine kurze Sequenz hinzuzufügen: ein Produkt, das sich zum Etikett dreht, ein Porträt, das aufblickt, eine Kamera, die näher gleitet. Nennen Sie zuerst die Handlung, dann die Kamera, dann den Ton.
Bilder wählen, die in die Grenzen passen
Halten Sie jede Seite zwischen 256 und 5.760 Pixeln und das Verhältnis von Breite zu Höhe zwischen 0,4 und 2,5. Die Ausgabe folgt in 768p der Form Ihres Bilds; prüfen Sie vor der Veröffentlichung Gesichter, Etiketten und Ränder im Ergebnis.
Passende Bilder paaren
Geben Sie Start- und Endbild denselben Bildausschnitt und dasselbe Seitenverhältnis und planen Sie einen einzigen Übergang, der in 4 bis 15 Sekunden passt. Sehen Sie sich die letzte Sekunde an, um zu prüfen, ob die Einstellung auf dem Endbild landet.
Bezahlt wird jede Sekunde des fertigen Clips in 768p; den aktuellen Preis zeigt 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-highspeed/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.
