Einführung
Video-Verlängerung mit MiniMax H3 Max. Senden Sie den Clip, den Sie fortsetzen möchten, und beschreiben Sie, was als Nächstes passiert: Das letzte Bild Ihres Clips wird zum Startbild einer neuen MiniMax H3 Max-Image-to-Video-Einstellung, und Original und neues Segment kommen verbunden in einer einzigen MP4 zurück. Berechnet werden nur die neuen Sekunden.
| Feld | Wert |
|---|---|
| Eingabe | Video |
| Ausgabe | Video |
| Herausgeber | MiniMax |
| Endpunkte | text-to-video, image-to-video, video-extend |
| Dauer | 5–15 Sekunden, ganze Sekunden, Vorgabe 8 |
| Auflösung | 480p, 768p (Standard) |
| Seitenverhältnisse | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 (text-to-video; Vorgabe 1:1) |
| Frame-Steuerung | Startbild bei image-to-video Pflicht, Schlussbild optional |
| Ton | Zusammen mit dem Bild erzeugt |
| Ausführung | Asynchroner Task, abgerechnet pro Sekunde Ausgabe |
Wichtige Funktionen und Highlights
Gebaut, um ein Briefing schnell umzusetzen
MiniMax positioniert H3 Max als auf Tempo optimierte, schnelle Generierungsvariante von H3. Hier läuft sie in 480p oder 768p mit Ton im selben Durchgang, was zu einer Schleife aus Schreiben, Rendern und Nachjustieren passt. Clips beginnen bei fünf Sekunden, die kürzeste Anfrage ist also schon ein brauchbarer Moment statt eines Testbilds.
Sagen, wo die Einstellung beginnt und wo sie landet
image-to-video nimmt ein Startbild und optional ein Schlussbild. Damit stehen beide Enden fest, und nur die Bewegung dazwischen wird erzeugt – nützlich, wenn ein Clip sauber in einen Schnitt fallen muss. Die beiden Frames müssen in Motiv, Garderobe und Licht durchgehend bleiben, sonst verhandelt die Mitte des Clips sichtbar zwischen ihnen.
Das Format festlegen, bevor Sie einen Take beurteilen
text-to-video steht standardmäßig auf 1:1, ein Breitbild-Briefing kommt also quadratisch zurück, wenn aspect_ratio nichts anderes sagt – setzen Sie 21:9, 16:9, 4:3, 3:4 oder 9:16, bevor Sie Takes vergleichen. image-to-video hat kein aspect_ratio-Feld: Das Startbild bestimmt das Format, also beschneiden Sie das Standbild vor dem Senden.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
last_image_url | Nein | Optionales Zielbild für das Ende: Das neue Segment schließt auf diesem Bild. Es steuert nur den Schluss; die Mitte bleibt frei. |
prompt | Ja | Pflichtfeld. Was als Nächstes passiert: die folgende Handlung, die Kamerabewegung und der Ton. mindestens 1 Zeichen · höchstens 7000 Zeichen |
duration_seconds | Nein | Länge des neuen Segments: ganze Sekunden, 5 bis 15; Standard ist 8. Ihr Original kommt davor hinzu und wird nicht berechnet. |
resolution | Nein | Auflösung des neuen Segments: 480p oder 768p, Standard 768p. Beide sind native Renderings. |
enable_prompt_expansion | Nein | Standardmäßig aus, der Prompt wird also so verwendet, wie Sie ihn geschrieben haben. Standardwert: |
video_url | Ja | Der Clip, der fortgesetzt wird: MP4, MOV oder WebM, bis zu 60 Sekunden. mindestens 1 Zeichen |
Preis
Abgerechnet wird pro Sekunde des neuen Segments in der gewählten Auflösung; der gesendete Quellclip wird nicht berechnet. Eine fehlgeschlagene Generierung oder eine Verbindung, die sich nicht erstellen lässt, wird vollständig erstattet. Wird die Prompt-Erweiterung eingeschaltet, kommt eine pauschale Gebühr pro Anfrage hinzu.
| Spezifikation | Preis |
|---|---|
| $0.05 / Sekunde |
| $0.08 / Sekunde |
Anwendungsfälle
Hero-Einstellungen ab dem freigegebenen Startbild
Steht eine Szene, erzeugen Sie zuerst das Startbild und schicken es an image-to-video: Garderobe, Körper und Gesicht, die Sie entworfen haben, kommen durch, statt bei jedem Durchlauf neu erfunden zu werden.
Anamorpher Kampagnenfilm
21:9 mit langsamem Gang auf die Kamera zu, hartem Kantenlicht und Windmaschine: die Modefilm-Grammatik, in der diese Stufe gut ist. Eine Anfrage über 15 Sekunden deckt eine vollständige Annäherung samt Halt ab – im Schnitt bleibt keine Naht zu verstecken.
Vertikale Fassungen aus demselben Briefing
Dieselbe geschriebene Einstellung läuft erneut in 9:16 für Feeds und in 1:1 für quadratische Platzierungen. Lassen Sie Prompt und Dauer unverändert und ändern Sie nur das Seitenverhältnis, um zu sehen, wie der neue Ausschnitt wirkt, bevor Sie einen ganzen Satz an Formaten produzieren.
Clips, die sich in einen Schnitt einfügen müssen
Muss eine Einstellung auf einem Board beginnen und auf einem anderen enden, geben Sie beide als image_url und last_image_url mit. Die erzeugte Bewegung landet auf der Schlusskomposition, der abgehende Frame passt also zur nächsten Einstellung in der Timeline.
Prompt-Leitfaden und Praxistipps
Text oder Startbild wählen
Eine geschriebene Idee geht an text-to-video; ein freigegebenes Still an image-to-video, das ihm weit wörtlicher folgt. Die beiden Endpunkte teilen sich keinen Feldsatz – image-to-video hat kein
aspect_ratio, weil das Startbild die Form entscheidet.Den Shot schreiben, dann das Format setzen
Beschreiben Sie Motiv, Bewegung, Licht und Ton in der Reihenfolge, in der sie passieren, und setzen Sie
aspect_ratioselbst, denn die Vorgabe ist 1:1. Ein funktionierendes Briefing sieht so aus (englisch belassen, so wie gesendet): „High-fashion campaign film. An adult model in a liquid-silver slip gown walks slowly toward camera down a black marble corridor, the fabric catching hard rim light and rippling with each step, hair moving in a wind machine, she stops and looks straight down the lens. Anamorphic 2.39:1, deep blacks, glossy specular highlights, low synth drone.“Eine Änderung pro Durchlauf
Ändern Sie pro Durchlauf nur eine Sache, damit jedes Ergebnis nur Ihre Änderung widerspiegelt, und schreiben Sie die Details, die Ihnen wichtig sind, in den Prompt, statt dem Modell Lücken zum Füllen zu lassen. Der Ton entsteht mit dem Bild, also gehört jeder Hinweis zu Musik oder Raumklang in denselben Prompt.
Einführung
MiniMax H3 Max Video-Verlängerung setzt einen vorhandenen Clip fort. Senden Sie ihn als video_url mit einem Prompt dafür, was als Nächstes passiert. Das letzte Bild Ihres Clips wird zum Startbild einer neuen MiniMax H3 Max-Image-to-Video-Einstellung von 5 bis 15 Sekunden, und beide werden zu einer MP4 verbunden: zuerst Ihr Original, dann die Fortsetzung, das doppelte Nahtbild entfällt. Das neue Segment kommt zusätzlich als eigene Datei zurück, sodass Sie weiter verlängern oder die Teile getrennt bearbeiten können.
Hauptmerkmale und Highlights
Die Kontinuität kommt vom letzten Bild
Garderobe, Set, Licht und die Positionen aller Personen bleiben erhalten, weil das neue Segment buchstäblich auf Ihrem letzten Bild beginnt. Die Bewegung geht nicht auf dieselbe Weise über: Das Modell sieht ein Standbild, nicht den ganzen Clip. Beschreiben Sie also die Bewegung, die weiterlaufen soll, statt anzunehmen, dass Tempo und Richtung erhalten bleiben.
Eine Datei zurück, dazu das neue Stück einzeln
Die verbundene MP4 behält Bildrate und Bildausschnitt Ihres Clips, ohne schwarze Balken. Damit die Naht sauber sitzt, kann das Bild an den Rändern um einige Prozent beschnitten oder angepasst werden. Liefert das Modell ein deutlich anderes Seitenverhältnis, wird das neue Segment so skaliert, dass es Ihr Bild ausfüllt, mittig ausgerichtet und an den überstehenden Rändern beschnitten. Das neue Segment bringt Ton aus demselben Durchlauf mit; der Ton Ihres Originals bleibt erhalten, und die Naht wird über Sekundenbruchteile übergeblendet. Ist eine Seite stumm, wird die andere mit Stille aufgefüllt. Das zweite Asset der Ausgabe ist das neue Segment allein mit der Rolle segment, bereit für eine weitere Verlängerung oder für den Schnitt.
Ein optionales Schlussbild
last_image_url ist optional. Senden Sie ein Bild, und das neue Segment kommt darauf zur Ruhe; ohne Angabe ist das Ende frei. Das Schlussbild steuert nur das Ende, und je länger das Segment, desto weiter kann die Mitte davon abweichen.
Alles andere ist MiniMax H3 Max Image-to-Video
Das neue Segment läuft über dieselben Routen, mit demselben Inhaltsspielraum und demselben Sekundenpreis wie der Image-to-Video-Endpunkt, und eine fehlgeschlagene Generierung wird genauso erstattet. Gelingt die Generierung, lässt sich aber die Verbindung nicht erstellen, schlägt die Aufgabe fehl und der Betrag wird erstattet.
Anwendungsfälle
Eine zu früh endende Einstellung verlängern
Ein Produkt-Drehteller, der anhält, bevor das Etikett zur Kamera zeigt, oder ein Gang, der schneidet, bevor die Person die Tür erreicht. Verlängern Sie um ein paar Sekunden und beschreiben Sie nur die restliche Bewegung.
Eine längere Sequenz Schritt für Schritt aufbauen
Eine Anfrage liefert höchstens 15 Sekunden. Für mehr erzeugen Sie eine erste Einstellung, verlängern sie und verlängern dann das verbundene Ergebnis erneut; jeder Schritt berechnet nur die Sekunden, die er hinzufügt. Da jeder Schritt von einem einzelnen Bild ausgeht, prüfen Sie jede Naht, bevor Sie die nächste aufsetzen.
Prompt-Leitfaden und Profi-Tipps
Beschreiben Sie den nächsten Takt, nicht die ganze Szene
Das Bild legt bereits fest, wer und wo, verwenden Sie den Prompt also für die folgende Handlung, die Kamerabewegung und den Ton. Wiederholen Sie die Kamerasprache, mit der Ihr Clip endete, etwa ein langsamer Zoom oder eine feste Einstellung, damit die Naht wie eine Einstellung wirkt.
Vor dem Verlängern schneiden
Das letzte Bild ist das Einzige, was das Modell sieht; ein unscharfes, mitten im Schnitt liegendes oder stark komprimiertes Ende wandert direkt in die Fortsetzung. Schneiden Sie Ihr Original zuerst an einem sauberen, scharfen Bild. Originale bis 60 Sekunden werden als MP4, MOV oder WebM angenommen.
Die Auflösung konsistent halten
Die Auflösung bestimmt nur, wie scharf das neue Segment erzeugt wird; eine niedrigere Stufe lässt den neuen Teil daher weicher wirken als das Original. Passen Sie die Auflösung an Ihr Original an und setzen Sie duration_seconds auf die Länge, die Sie wirklich brauchen: Berechnet wird nur das neue Segment.
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-max/video-extend",
"input": {
"duration_seconds": 8,
"enable_prompt_expansion": false,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.
