MiniMax H3 Video-API: Generierung und Neugenerierung
Binde MiniMax H3 mit deinem BetterToken API Key ein und wähle Felder, Medien und Generierungsart anhand von Model ID und Operation.
Du kannst Videos aus Text, Start- und Endbildern oder Referenzmedien generieren. Außerdem kannst du eigene geeignete 768p-H3-Videos in 2k neu generieren. Die Neugenerierung akzeptiert nur die ID der Quellaufgabe, keine neuen Medien-URLs.
Halte deinen BetterToken API Key bereit. Die Base URL ist https://bettertoken.ai/v1; verwende Authorization: Bearer YOUR_API_KEY zur Authentifizierung. Kopiere die Model ID exakt, einschließlich Groß- und Kleinschreibung.
Alle folgenden request.json verwenden denselben Ablauf: Angebot einholen, bestätigen, Aufgabe erstellen, Status abfragen und herunterladen. Ein Angebot startet keine Generierung; die Erstellung übermittelt eine kostenpflichtige Aufgabe. Aktuelle Preise stehen in der model plaza.
Modelle und Operationen
Die folgende Tabelle zeigt die verfügbaren Werte je Operation. Standardwerte, Medienanzahl und Kombinationsregeln stehen im jeweiligen Abschnitt. Die Mediengrößen verwenden 1 MB = 1048576 Bytes.
| Model ID | Operation | Dauer (Sekunden) | Ausgabestufe | Seitenverhältnis | Audio | Medienrolle |
|---|---|---|---|---|---|---|
MiniMax-H3 | image_to_video | 4–15, Schrittweite 1 | 768p, 2k | adaptive | provider_default | first_frame, last_frame, reference_image, reference_video, reference_audio |
MiniMax-H3 | reference_to_video | 4–15, Schrittweite 1 | 768p, 2k | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | provider_default | reference_image, reference_video, reference_audio |
MiniMax-H3 | text_to_video | 4–15, Schrittweite 1 | 768p, 2k | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | provider_default | Keine |
MiniMax-H3 | video_edit | Von Quellaufgabe übernommen | 2k | adaptive (übernommen) | provider_default | ID der Quellaufgabe |
provider_default übernimmt die Audioeinstellung des Modells; ein Schalter für on / off ist nicht verfügbar. Seitenverhältnis, Dauer und Eingaben der Neugenerierung bestimmt die Quellaufgabe.
Beispielmedien
Die Beispiele für Generierung aus Bildern und Bildreferenzen verwenden einen blauen Keramikbecher auf einem weißen Tisch. Du kannst das Beispielbild ausprobieren oder es vorher durch eigene öffentlich erreichbare HTTPS-Medien ersetzen, die du verwenden darfst und die die Anforderungen dieser Seite erfüllen.

Video aus Text generieren
MiniMax-H3
Verwende diese Operation, wenn du ein Video nur aus einer Textbeschreibung generieren möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf text_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | provider_default | provider_default |
duration.mode | string | Nein | fixed | fixed |
duration.seconds | integer | Nein | 4–15, Schrittweite 1 Sekunde; nur bei fester Dauer | 4 |
output.aspect_ratio | string | Ja | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Keine |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 768p, 2k | 768p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
Diese Operation akzeptiert keine Medien.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "MiniMax-H3", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "768p", "aspect_ratio": "16:9" }}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
Video aus Bildern generieren
MiniMax-H3
Verwende diese Operation, wenn du das Startbild oder Start- und Endbild durch Bilder festlegen möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf image_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | provider_default | provider_default |
duration.mode | string | Nein | fixed | fixed |
duration.seconds | integer | Nein | 4–15, Schrittweite 1 Sekunde; nur bei fester Dauer | 4 |
output.aspect_ratio | string | Nein | adaptive | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 768p, 2k | 768p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
first_frame | image, optional, höchstens 1 | jpg, jpeg, png, webp, heic, heif | Größe höchstens 30 MB; Breite 256–5760 px; Höhe 256–5760 px |
last_frame | image, optional, höchstens 1 | jpg, jpeg, png, webp, heic, heif | Größe höchstens 30 MB; Breite 256–5760 px; Höhe 256–5760 px |
reference_image | image, optional, höchstens 9 | jpg, jpeg, png, webp, heic, heif | Größe höchstens 30 MB; Breite 256–5760 px; Höhe 256–5760 px |
reference_video | video, optional, höchstens 3 | mp4, mov | Größe höchstens 50 MB; Breite 256–5760 px; Höhe 256–5760 px; Dauer 2–15 Sekunden; Bildrate mindestens 23.976 fps, höchstens 60 fps; Gesamtdauer dieser Rolle höchstens 15 Sekunden |
reference_audio | audio, optional, höchstens 3 | wav, mp3 | Größe höchstens 15 MB; Dauer 2–15 Sekunden; Gesamtdauer dieser Rolle höchstens 15 Sekunden |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Gib mindestens eine der Rollen
first_frame,last_framean. - Start- und Endbilder dürfen nicht mit Referenzbildern, Referenzvideos oder Referenzaudio kombiniert werden. Verwende für Start- und Endbilder die Generierung aus Bildern und für Referenzmedien die Referenzgenerierung.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "MiniMax-H3", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "768p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
mutually_exclusive_roles | Start- und Endbilder getrennt von Referenzmedien verwenden. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
Video aus Referenzen generieren
MiniMax-H3
Verwende diese Operation, wenn Referenzmedien die Merkmale eines Motivs oder einer Bewegung erhalten sollen.
Setze model auf die Model ID dieses Abschnitts und operation auf reference_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | provider_default | provider_default |
duration.mode | string | Nein | fixed | fixed |
duration.seconds | integer | Nein | 4–15, Schrittweite 1 Sekunde; nur bei fester Dauer | 4 |
output.aspect_ratio | string | Nein | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 768p, 2k | 768p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
reference_image | image, optional, höchstens 9 | jpg, jpeg, png, webp, heic, heif | Größe höchstens 30 MB; Breite 256–5760 px; Höhe 256–5760 px |
reference_video | video, optional, höchstens 3 | mp4, mov | Größe höchstens 50 MB; Breite 256–5760 px; Höhe 256–5760 px; Dauer 2–15 Sekunden; Bildrate mindestens 23.976 fps, höchstens 60 fps; Gesamtdauer dieser Rolle höchstens 15 Sekunden |
reference_audio | audio, optional, höchstens 3 | wav, mp3 | Größe höchstens 15 MB; Dauer 2–15 Sekunden; Gesamtdauer dieser Rolle höchstens 15 Sekunden |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Gib mindestens eine der Rollen
reference_image,reference_video,reference_audioan. - Start- und Endbilder dürfen nicht mit Referenzbildern, Referenzvideos oder Referenzaudio kombiniert werden. Verwende für Start- und Endbilder die Generierung aus Bildern und für Referenzmedien die Referenzgenerierung.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "MiniMax-H3", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "768p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
mutually_exclusive_roles | Start- und Endbilder getrennt von Referenzmedien verwenden. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
Fertiges Video neu generieren
MiniMax-H3
Verwende diese Operation, wenn du ein eigenes fertiges 768p-H3-Video mit gleichem Inhalt in 2k neu generieren möchtest. Beliebige Videodateien werden nicht akzeptiert.
Die Quellaufgabe muss alle folgenden Bedingungen erfüllen:
- Sie gehört deinem Konto und hat die Model ID
MiniMax-H3. - Die Generierung war erfolgreich und das fertige Video ist noch herunterladbar.
- Die Ausgabe ist auf
768peingestellt. - Seit Erstellung der Quellaufgabe sind höchstens 7 Tage vergangen.
Der Server prüft auch das Format des Quellvideos und gibt bei ungeeigneten Quellen 422 video_regeneration_source_invalid zurück. Hole das Angebot mit der ID der Quellaufgabe ein. Ersetze die Quellaufgabe nicht durch eine selbst veränderte Videodatei.
| Anfragefeld | Typ | Erforderlich | Wert |
|---|---|---|---|
model | string | Ja | MiniMax-H3 |
operation | string | Ja | video_edit |
provider_options.hailuo.source_task_id | string | Ja | ID deiner geeigneten Quellaufgabe |
watermark | boolean | Nein | false / true, Standard false |
Sende weder prompt, duration, output, audio noch media. Die Neugenerierung übernimmt Inhalt und Eingaben der Quellaufgabe und gibt 2k, adaptive und MP4 aus.
Ersetze zuerst REPLACE_WITH_YOUR_H3_TASK_ID durch die ID deiner Quellaufgabe, bevor du Angebot und Erstellung ausführst. Dadurch entsteht eine neue kostenpflichtige Aufgabe; verwende eine neue Zustandsdatei.
{ "model": "MiniMax-H3", "operation": "video_edit", "provider_options": { "hailuo": { "source_task_id": "REPLACE_WITH_YOUR_H3_TASK_ID" } }}Ist die Quellaufgabe ungeeignet oder nicht vorhanden, liefert das Angebot 422 video_regeneration_source_invalid mit field_path gleich provider_options.hailuo.source_task_id. Das folgende Beispiel dient zur Erkennung dieses Fehlers und lässt sich nicht zur Generierung verwenden:
{ "model": "MiniMax-H3", "operation": "video_edit", "provider_options": { "hailuo": { "source_task_id": "video_DOES_NOT_EXIST" } }}Offizielle Dokumentation
Verwende beim Aufruf von BetterToken die Felder dieser Seite und die passende Operation im aktuellen Modellkatalog.

