MiniMax H3 Max API

MiniMax H3 Max Bild-zu-Video animiert ein Anfangsbild aus image_url zu einem Clip von 5 bis 15 ganzen Sekunden in 480p oder 768p, mit Ton aus demselben Durchgang. Ein optionales last_image_url legt zusätzlich das Schlussbild fest. Das Anfangsbild bestimmt die Ausgabeform, und eine Anfrage ohne Dauerangabe läuft 8 Sekunden.

Modus nach dem Ausgangsmaterial wählen

Das Bild bestimmt Motiv, Garderobe und Form

Dieser Endpunkt hat kein Feld für das Seitenverhältnis: Das Still, das Sie übergeben, legt den Rahmen des Clips fest. Im Beispiel laundromat-spin ist nichts über Raum, Garderobe oder das flache Neonröhrenlicht aufgeschrieben, weil das Anfangsbild all das bereits geklärt hat. Der Prompt beschreibt nur, wie die Maschine in den Schleudergang geht und wie sie darauf reagiert.

Beide Enden der Einstellung festlegen

last_image_url fügt ein Schlussbild hinzu und kann nur zusammen mit image_url gesendet werden. Das Beispiel frame-to-frame beginnt auf einer Komposition und landet über acht Sekunden auf einer anderen, sodass sich der Clip sauber in einen Schnitt fügt. Das Schlussbild bindet das Ende, nicht die Mitte, und zwei Bilder, die sich in Licht oder Garderobe widersprechen, erzeugen eine sichtbare Verhandlung zwischen beiden.

Mindestens fünf Sekunden, zwei Auflösungen

Die Dauer reicht von 5 bis 15 ganzen Sekunden, Standard sind 8. resolution nimmt 480p oder 768p an, Standard ist 768p; 480p kostet pro Sekunde weniger und eignet sich für Entwürfe. Schon die kürzeste Anfrage ergibt einen vollständigen Moment: Der Clip laundromat-spin bringt Schleudergang, Lachen, Beinschwung und Blick zur Trommel in fünf Sekunden unter.

Vom Objekt zur Person schwenken

Eine einzige ununterbrochene Kamerabewegung macht die Reihenfolge der Enthüllung zum ganzen Briefing. Das Beispiel grimoire-to-bare-shoulder beginnt bei einem aufgeschlagenen Buch und neigt sich über acht Sekunden hinauf zur Leserin im hochlehnigen Sessel, während Siegellicht aus den Seiten über ihre Schulter wandert. Das Bild fixiert die Anfangskomposition, der Prompt verwendet seine Worte darauf, was die Kamera wann findet.

Einen Clip auf einer bekannten Komposition enden lassen

Wenn ein Schnitt verlangt, dass ein Clip auf einem bestimmten Bild endet, liefern Sie beide Bilder. Bereiten Sie das Schluss-Still als Fortsetzung des Anfangsbilds vor und beschreiben Sie dann die Handlung, die beide verbindet. In frame-to-frame ist das ein Gang auf die Kamera zu durch einen Marmorkorridor, der mit einem direkten Blick in die Linse endet – mit hartem Kantenlicht, Windmaschine und tiefem Synth-Drone.

Eine statische Szene beleben

Eine feste Totale kann mehrere kleine Bewegungen gleichzeitig tragen. Der Prompt von laundromat-spin verlangt eine starre Kamera, eine Trommel, die sich hinter Glas dreht, und eine Leuchtstoffröhre, die einmal flackert, dazu die Reaktion der Figur, mit leisem Maschinenbrummen im Ton.

# 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-max/image-to-video",
  "input": {
    "duration_seconds": 8,
    "enable_prompt_expansion": false,
    "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.