{ "aboutHtml": "

Eine schnelle, nachtrainierte H3-Variante

MiniMax H3 Max ist eine nachtrainierte Variante des Basismodells MiniMax H3, optimiert für schnellere Generierung, Prompt-Treue und audiovisuelle Qualität. Die Variante entstand durch Nachtraining bei fal Research. Sie behält einen einheitlichen multimodalen Kontext und nativ synchronisierte Bild- und Tonausgabe bei. Geschwindigkeit ist ein Entwicklungsziel und keine feste Fertigstellungszeit für jeden Prompt, jede Dauer oder Anwendung.

Unterscheiden Sie Max vom ursprünglichen H3-System und der separaten Variante Max Turbo. Die aktuelle MiniMax-Schnittstelle führt Max mit 480P oder 768P auf, mit 768P als Standard, 24 Bildern pro Sekunde und einer ganzzahligen Dauer von 5 bis 15 Sekunden. Der dokumentierte Max-Ablauf bietet weder die 2K-Einstellung des ursprünglichen H3-Systems noch eine viersekündige Ausgabe.

Vom Prompt zur Einstellung

Jede Generierung enthält ein nicht leeres Textbriefing mit bis zu 7.000 Zeichen pro Textelement. Beschreiben Sie Motiv, Ausgangskomposition, Handlung und Ergebnis und geben Sie anschließend Kamera und Ton klar vor. Legen Sie bei einer kurzen Objektenthüllung fest, was das Publikum zuerst sehen soll, wie das Objekt ins Bild gelangt und wie die Einstellung enden soll.

Ein hilfreiches fünfsekündiges Briefing könnte eine Keramiktasse auf einem Holztisch beschreiben, eine Hand, die daneben eine Untertasse abstellt, eine kleine Kamerafahrt nach vorn und den Klang von Keramik auf Holz. Begrenzen Sie die Handlung so, dass sie in die gewählte Dauer passt, und prüfen Sie, ob erzeugte Bewegung und Ton demselben Ereignis folgen.

Erstellung mit Einzelbildvorgaben

Der Hersteller dokumentiert ein Anfangsbild, ein Endbild oder beide. Das erste Bild legt den Ausgangspunkt des Clips fest, das letzte den endgültigen visuellen Zustand. Erläutern Sie die verbindende Bewegung, einschließlich Änderungen an Pose, Objektposition, Kamera oder Beleuchtung. Vermeiden Sie bei einem Übergang zwischen zwei Bildern ein Briefing, das zwischen den Endpunkten eine unvereinbare Szene einführt.

Bei bildgeführter Ausgabe bestimmt das Eingabebild das Seitenverhältnis. Wählen Sie für reine Textaufgaben ein konkretes Verhältnis aus 21:9, 16:9, 4:3, 1:1, 3:4 oder 9:16. Referenzgeführte Aufgaben können ein adaptives Verhältnis oder eine der dokumentierten ausdrücklichen Optionen nutzen. Komponieren Sie Referenz oder geschriebene Szene für das Zielformat, statt davon auszugehen, dass dieselbe Anordnung im Hoch- und Querformat gleichermaßen funktioniert.

Multimodale Referenzen

Das aktuelle Max-Generierungsschema von MiniMax dokumentiert außerdem Referenzbilder, -videos und -audio. Geben Sie an, was sie jeweils beeinflussen sollen: Figurenidentität, Umgebung, Bewegungsmuster, Kamerabahn, Stimmklang oder eine Klangeigenschaft. Die Rollen als Anfangs-/Endbild und als Referenzmedium schließen sich in dieser Schnittstelle gegenseitig aus.

Benennen Sie bei einer Figurenaufnahme die Erscheinungsreferenz und die Bewegungsreferenz getrennt und geben Sie anschließend Zielhandlung und gesprochenen Satz vor. Eine Stimmreferenz, die die Sprechweise festlegt, ist etwas anderes als das Kopieren ihres vollständigen Audiosignals. Beschreiben Sie ausdrücklich, welche Eigenschaften erhalten bleiben und welche Änderungen erfolgen sollen, und prüfen Sie den tatsächlichen audiovisuellen Clip anhand jeder Referenzrolle.

Prompt-Erweiterung

Die Max-spezifische Erweiterungseinstellung bietet disabled, balanced und quality; balanced ist die Standardeinstellung. Wählen Sie disabled, wenn das bereitgestellte Briefing ohne Erweiterung weitergegeben werden soll. Nutzen Sie einen dokumentierten Erweiterungsmodus, wenn zusätzliche Interpretation erwünscht ist. Bewahren Sie das Originalbriefing auf, damit sich eine durch die Erweiterung eingeführte Änderung vom angeforderten Inhalt unterscheiden lässt.

Beschreiben Sie Ton als Teil der Szene. Benennen Sie physische Geräusche, Atmosphäre und gesprochene Wörter und trennen Sie sie von Hintergrundmusik, die ausschließlich das Publikum hört. Geben Sie den genauen Satz und die gewünschte sprechende Person vor, statt um unspezifischen Dialog zu bitten. Hören Sie das Ergebnis auch an; ein überzeugendes Bild belegt weder korrekten gesprochenen Wortlaut noch korrektes Timing.

Vorbereitung und Grenzen der Eingaben

Das aktuelle Herstellerschema akzeptiert Bilder als JPG, JPEG, PNG, WebP, HEIC oder HEIF mit bis zu 30 MB pro Datei, Seitenlängen von 256 bis 5.760 Pixeln und Seitenverhältnissen von 0,4 bis 2,5. Die Anfangs- und Endbildrollen erlauben jeweils ein Bild; der Referenzmodus erlaubt bis zu neun Bilder. Sorgen Sie für eine klare Sicht auf Motiv und Details, die erkennbar bleiben müssen.

Als Referenzvideo sind bis zu drei MP4- oder MOV-Clips erlaubt, jeweils 2–15 Sekunden und zusammen höchstens 15 Sekunden lang, mit maximal 50 MB pro Datei. Dokumentiert sind H.264- oder H.265-Video, AAC- oder MP3-Audio, Seitenlängen von 256 bis 5.760 Pixeln, Seitenverhältnisse von 0,4 bis 2,5 und Bildraten von 23,976 bis 60. Referenzaudio erlaubt bis zu drei WAV- oder MP3-Clips mit jeweils bis zu 15 MB und 2–15 Sekunden, zusammen höchstens 15 Sekunden. Für den Anfragekörper gilt eine gesonderte Grenze von 64 MB.

Verwenden Sie nur Referenzen, die zur Einstellung beitragen, und benennen Sie jeden Beitrag im Text. Ein kurzer, relevanter Bewegungsclip ist als Vorgabe leichter nutzbar als eine lange Sammlung unzusammenhängender Ereignisse. Halten Sie gewünschte Dauer und Ausgabeauflösung ausdrücklich fest, damit das Ergebnis mit demselben Briefing verglichen werden kann.

Das fertige Ergebnis

Der asynchrone Ablauf des Herstellers gibt eine Auftragskennung zurück, bevor das fertige Video verfügbar ist. Seine Schnittstelle zur Auftragsabfrage ruft Aufträge aus den vorangegangenen sieben Tagen ab. Speichern Sie den tatsächlich zurückgegebenen Clip und seine Spezifikation für Schnitt oder weitere Prüfung; eine Auftragskennung ist nicht das audiovisuelle Artefakt. Download-Adressen sind zeitlich begrenzt. Bewahren Sie daher die Datei selbst auf, wenn Sie ein ausgewähltes Ergebnis behalten möchten.

Prüfen Sie Motivkontinuität, Bewegung, sichtbaren Text, Dialog und Ton-Timing in der Größe, in der der Clip eingesetzt wird. Formulieren Sie konkrete Rückmeldungen für das nächste kreative Briefing: die veränderte Geste, den ausgelassenen Satz oder den anzupassenden Bildausschnitt. Das nutzbare Ergebnis ist eine kurze audiovisuelle Einstellung, die sich auf den bereitgestellten Inhalt und dessen ausdrücklich festgelegte Referenzbeziehungen bezieht.

", "aboutText": "Eine schnelle, nachtrainierte H3-Variante\n\nMiniMax H3 Max ist eine nachtrainierte Variante des Basismodells MiniMax H3, optimiert für schnellere Generierung, Prompt-Treue und audiovisuelle Qualität. Die Variante entstand durch Nachtraining bei fal Research. Sie behält einen einheitlichen multimodalen Kontext und nativ synchronisierte Bild- und Tonausgabe bei. Geschwindigkeit ist ein Entwicklungsziel und keine feste Fertigstellungszeit für jeden Prompt, jede Dauer oder Anwendung.\n\nUnterscheiden Sie Max vom ursprünglichen H3-System und der separaten Variante Max Turbo. Die aktuelle MiniMax-Schnittstelle führt Max mit 480P oder 768P auf, mit 768P als Standard, 24 Bildern pro Sekunde und einer ganzzahligen Dauer von 5 bis 15 Sekunden. Der dokumentierte Max-Ablauf bietet weder die 2K-Einstellung des ursprünglichen H3-Systems noch eine viersekündige Ausgabe.\n\nVom Prompt zur Einstellung\n\nJede Generierung enthält ein nicht leeres Textbriefing mit bis zu 7.000 Zeichen pro Textelement. Beschreiben Sie Motiv, Ausgangskomposition, Handlung und Ergebnis und geben Sie anschließend Kamera und Ton klar vor. Legen Sie bei einer kurzen Objektenthüllung fest, was das Publikum zuerst sehen soll, wie das Objekt ins Bild gelangt und wie die Einstellung enden soll.\n\nEin hilfreiches fünfsekündiges Briefing könnte eine Keramiktasse auf einem Holztisch beschreiben, eine Hand, die daneben eine Untertasse abstellt, eine kleine Kamerafahrt nach vorn und den Klang von Keramik auf Holz. Begrenzen Sie die Handlung so, dass sie in die gewählte Dauer passt, und prüfen Sie, ob erzeugte Bewegung und Ton demselben Ereignis folgen.\n\nErstellung mit Einzelbildvorgaben\n\nDer Hersteller dokumentiert ein Anfangsbild, ein Endbild oder beide. Das erste Bild legt den Ausgangspunkt des Clips fest, das letzte den endgültigen visuellen Zustand. Erläutern Sie die verbindende Bewegung, einschließlich Änderungen an Pose, Objektposition, Kamera oder Beleuchtung. Vermeiden Sie bei einem Übergang zwischen zwei Bildern ein Briefing, das zwischen den Endpunkten eine unvereinbare Szene einführt.\n\nBei bildgeführter Ausgabe bestimmt das Eingabebild das Seitenverhältnis. Wählen Sie für reine Textaufgaben ein konkretes Verhältnis aus 21:9, 16:9, 4:3, 1:1, 3:4 oder 9:16. Referenzgeführte Aufgaben können ein adaptives Verhältnis oder eine der dokumentierten ausdrücklichen Optionen nutzen. Komponieren Sie Referenz oder geschriebene Szene für das Zielformat, statt davon auszugehen, dass dieselbe Anordnung im Hoch- und Querformat gleichermaßen funktioniert.\n\nMultimodale Referenzen\n\nDas aktuelle Max-Generierungsschema von MiniMax dokumentiert außerdem Referenzbilder, -videos und -audio. Geben Sie an, was sie jeweils beeinflussen sollen: Figurenidentität, Umgebung, Bewegungsmuster, Kamerabahn, Stimmklang oder eine Klangeigenschaft. Die Rollen als Anfangs-/Endbild und als Referenzmedium schließen sich in dieser Schnittstelle gegenseitig aus.\n\nBenennen Sie bei einer Figurenaufnahme die Erscheinungsreferenz und die Bewegungsreferenz getrennt und geben Sie anschließend Zielhandlung und gesprochenen Satz vor. Eine Stimmreferenz, die die Sprechweise festlegt, ist etwas anderes als das Kopieren ihres vollständigen Audiosignals. Beschreiben Sie ausdrücklich, welche Eigenschaften erhalten bleiben und welche Änderungen erfolgen sollen, und prüfen Sie den tatsächlichen audiovisuellen Clip anhand jeder Referenzrolle.\n\nPrompt-Erweiterung\n\nDie Max-spezifische Erweiterungseinstellung bietet disabled, balanced und quality; balanced ist die Standardeinstellung. Wählen Sie disabled, wenn das bereitgestellte Briefing ohne Erweiterung weitergegeben werden soll. Nutzen Sie einen dokumentierten Erweiterungsmodus, wenn zusätzliche Interpretation erwünscht ist. Bewahren Sie das Originalbriefing auf, damit sich eine durch die Erweiterung eingeführte Änderung vom angeforderten Inhalt unterscheiden lässt.\n\nBeschreiben Sie Ton als Teil der Szene. Benennen Sie physische Geräusche, Atmosphäre und gesprochene Wörter und trennen Sie sie von Hintergrundmusik, die ausschließlich das Publikum hört. Geben Sie den genauen Satz und die gewünschte sprechende Person vor, statt um unspezifischen Dialog zu bitten. Hören Sie das Ergebnis auch an; ein überzeugendes Bild belegt weder korrekten gesprochenen Wortlaut noch korrektes Timing.\n\nVorbereitung und Grenzen der Eingaben\n\nDas aktuelle Herstellerschema akzeptiert Bilder als JPG, JPEG, PNG, WebP, HEIC oder HEIF mit bis zu 30 MB pro Datei, Seitenlängen von 256 bis 5.760 Pixeln und Seitenverhältnissen von 0,4 bis 2,5. Die Anfangs- und Endbildrollen erlauben jeweils ein Bild; der Referenzmodus erlaubt bis zu neun Bilder. Sorgen Sie für eine klare Sicht auf Motiv und Details, die erkennbar bleiben müssen.\n\nAls Referenzvideo sind bis zu drei MP4- oder MOV-Clips erlaubt, jeweils 2–15 Sekunden und zusammen höchstens 15 Sekunden lang, mit maximal 50 MB pro Datei. Dokumentiert sind H.264- oder H.265-Video, AAC- oder MP3-Audio, Seitenlängen von 256 bis 5.760 Pixeln, Seitenverhältnisse von 0,4 bis 2,5 und Bildraten von 23,976 bis 60. Referenzaudio erlaubt bis zu drei WAV- oder MP3-Clips mit jeweils bis zu 15 MB und 2–15 Sekunden, zusammen höchstens 15 Sekunden. Für den Anfragekörper gilt eine gesonderte Grenze von 64 MB.\n\nVerwenden Sie nur Referenzen, die zur Einstellung beitragen, und benennen Sie jeden Beitrag im Text. Ein kurzer, relevanter Bewegungsclip ist als Vorgabe leichter nutzbar als eine lange Sammlung unzusammenhängender Ereignisse. Halten Sie gewünschte Dauer und Ausgabeauflösung ausdrücklich fest, damit das Ergebnis mit demselben Briefing verglichen werden kann.\n\nDas fertige Ergebnis\n\nDer asynchrone Ablauf des Herstellers gibt eine Auftragskennung zurück, bevor das fertige Video verfügbar ist. Seine Schnittstelle zur Auftragsabfrage ruft Aufträge aus den vorangegangenen sieben Tagen ab. Speichern Sie den tatsächlich zurückgegebenen Clip und seine Spezifikation für Schnitt oder weitere Prüfung; eine Auftragskennung ist nicht das audiovisuelle Artefakt. Download-Adressen sind zeitlich begrenzt. Bewahren Sie daher die Datei selbst auf, wenn Sie ein ausgewähltes Ergebnis behalten möchten.\n\nPrüfen Sie Motivkontinuität, Bewegung, sichtbaren Text, Dialog und Ton-Timing in der Größe, in der der Clip eingesetzt wird. Formulieren Sie konkrete Rückmeldungen für das nächste kreative Briefing: die veränderte Geste, den ausgelassenen Satz oder den anzupassenden Bildausschnitt. Das nutzbare Ergebnis ist eine kurze audiovisuelle Einstellung, die sich auf den bereitgestellten Inhalt und dessen ausdrücklich festgelegte Referenzbeziehungen bezieht.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "fa778f48535ead3f3abe3e4c8d2c8b1e499bb44e7d2f29ecf0ff2659c9fe247a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de", "methods": [ { "html": "
MM

MiniMax: H3 Max

MiniMax /minimax/hailuo-3-max

Start

MiniMax H3 Max ist eine schnelle, nachtrainierte H3-Variante für kurze Videos mit synchronisiertem Audio. Der dokumentierte MiniMax-Ablauf unterstützt Text, Einzelbilder und multimodale Referenzen, mit 480P- oder 768P-Ausgabe, 5–15 Sekunden Dauer und eigenen Optionen zur Prompt-Erweiterung.

Zulässige Eingaben
Text · Bilder
Ergebnisse
Video
Über das Modell

Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.

Eine schnelle, nachtrainierte H3-Variante

MiniMax H3 Max ist eine nachtrainierte Variante des Basismodells MiniMax H3, optimiert für schnellere Generierung, Prompt-Treue und audiovisuelle Qualität. Die Variante entstand durch Nachtraining bei fal Research. Sie behält einen einheitlichen multimodalen Kontext und nativ synchronisierte Bild- und Tonausgabe bei. Geschwindigkeit ist ein Entwicklungsziel und keine feste Fertigstellungszeit für jeden Prompt, jede Dauer oder Anwendung.

Unterscheiden Sie Max vom ursprünglichen H3-System und der separaten Variante Max Turbo. Die aktuelle MiniMax-Schnittstelle führt Max mit 480P oder 768P auf, mit 768P als Standard, 24 Bildern pro Sekunde und einer ganzzahligen Dauer von 5 bis 15 Sekunden. Der dokumentierte Max-Ablauf bietet weder die 2K-Einstellung des ursprünglichen H3-Systems noch eine viersekündige Ausgabe.

Vom Prompt zur Einstellung

Jede Generierung enthält ein nicht leeres Textbriefing mit bis zu 7.000 Zeichen pro Textelement. Beschreiben Sie Motiv, Ausgangskomposition, Handlung und Ergebnis und geben Sie anschließend Kamera und Ton klar vor. Legen Sie bei einer kurzen Objektenthüllung fest, was das Publikum zuerst sehen soll, wie das Objekt ins Bild gelangt und wie die Einstellung enden soll.

Ein hilfreiches fünfsekündiges Briefing könnte eine Keramiktasse auf einem Holztisch beschreiben, eine Hand, die daneben eine Untertasse abstellt, eine kleine Kamerafahrt nach vorn und den Klang von Keramik auf Holz. Begrenzen Sie die Handlung so, dass sie in die gewählte Dauer passt, und prüfen Sie, ob erzeugte Bewegung und Ton demselben Ereignis folgen.

Erstellung mit Einzelbildvorgaben

Der Hersteller dokumentiert ein Anfangsbild, ein Endbild oder beide. Das erste Bild legt den Ausgangspunkt des Clips fest, das letzte den endgültigen visuellen Zustand. Erläutern Sie die verbindende Bewegung, einschließlich Änderungen an Pose, Objektposition, Kamera oder Beleuchtung. Vermeiden Sie bei einem Übergang zwischen zwei Bildern ein Briefing, das zwischen den Endpunkten eine unvereinbare Szene einführt.

Bei bildgeführter Ausgabe bestimmt das Eingabebild das Seitenverhältnis. Wählen Sie für reine Textaufgaben ein konkretes Verhältnis aus 21:9, 16:9, 4:3, 1:1, 3:4 oder 9:16. Referenzgeführte Aufgaben können ein adaptives Verhältnis oder eine der dokumentierten ausdrücklichen Optionen nutzen. Komponieren Sie Referenz oder geschriebene Szene für das Zielformat, statt davon auszugehen, dass dieselbe Anordnung im Hoch- und Querformat gleichermaßen funktioniert.

Multimodale Referenzen

Das aktuelle Max-Generierungsschema von MiniMax dokumentiert außerdem Referenzbilder, -videos und -audio. Geben Sie an, was sie jeweils beeinflussen sollen: Figurenidentität, Umgebung, Bewegungsmuster, Kamerabahn, Stimmklang oder eine Klangeigenschaft. Die Rollen als Anfangs-/Endbild und als Referenzmedium schließen sich in dieser Schnittstelle gegenseitig aus.

Benennen Sie bei einer Figurenaufnahme die Erscheinungsreferenz und die Bewegungsreferenz getrennt und geben Sie anschließend Zielhandlung und gesprochenen Satz vor. Eine Stimmreferenz, die die Sprechweise festlegt, ist etwas anderes als das Kopieren ihres vollständigen Audiosignals. Beschreiben Sie ausdrücklich, welche Eigenschaften erhalten bleiben und welche Änderungen erfolgen sollen, und prüfen Sie den tatsächlichen audiovisuellen Clip anhand jeder Referenzrolle.

Prompt-Erweiterung

Die Max-spezifische Erweiterungseinstellung bietet disabled, balanced und quality; balanced ist die Standardeinstellung. Wählen Sie disabled, wenn das bereitgestellte Briefing ohne Erweiterung weitergegeben werden soll. Nutzen Sie einen dokumentierten Erweiterungsmodus, wenn zusätzliche Interpretation erwünscht ist. Bewahren Sie das Originalbriefing auf, damit sich eine durch die Erweiterung eingeführte Änderung vom angeforderten Inhalt unterscheiden lässt.

Beschreiben Sie Ton als Teil der Szene. Benennen Sie physische Geräusche, Atmosphäre und gesprochene Wörter und trennen Sie sie von Hintergrundmusik, die ausschließlich das Publikum hört. Geben Sie den genauen Satz und die gewünschte sprechende Person vor, statt um unspezifischen Dialog zu bitten. Hören Sie das Ergebnis auch an; ein überzeugendes Bild belegt weder korrekten gesprochenen Wortlaut noch korrektes Timing.

Vorbereitung und Grenzen der Eingaben

Das aktuelle Herstellerschema akzeptiert Bilder als JPG, JPEG, PNG, WebP, HEIC oder HEIF mit bis zu 30 MB pro Datei, Seitenlängen von 256 bis 5.760 Pixeln und Seitenverhältnissen von 0,4 bis 2,5. Die Anfangs- und Endbildrollen erlauben jeweils ein Bild; der Referenzmodus erlaubt bis zu neun Bilder. Sorgen Sie für eine klare Sicht auf Motiv und Details, die erkennbar bleiben müssen.

Als Referenzvideo sind bis zu drei MP4- oder MOV-Clips erlaubt, jeweils 2–15 Sekunden und zusammen höchstens 15 Sekunden lang, mit maximal 50 MB pro Datei. Dokumentiert sind H.264- oder H.265-Video, AAC- oder MP3-Audio, Seitenlängen von 256 bis 5.760 Pixeln, Seitenverhältnisse von 0,4 bis 2,5 und Bildraten von 23,976 bis 60. Referenzaudio erlaubt bis zu drei WAV- oder MP3-Clips mit jeweils bis zu 15 MB und 2–15 Sekunden, zusammen höchstens 15 Sekunden. Für den Anfragekörper gilt eine gesonderte Grenze von 64 MB.

Verwenden Sie nur Referenzen, die zur Einstellung beitragen, und benennen Sie jeden Beitrag im Text. Ein kurzer, relevanter Bewegungsclip ist als Vorgabe leichter nutzbar als eine lange Sammlung unzusammenhängender Ereignisse. Halten Sie gewünschte Dauer und Ausgabeauflösung ausdrücklich fest, damit das Ergebnis mit demselben Briefing verglichen werden kann.

Das fertige Ergebnis

Der asynchrone Ablauf des Herstellers gibt eine Auftragskennung zurück, bevor das fertige Video verfügbar ist. Seine Schnittstelle zur Auftragsabfrage ruft Aufträge aus den vorangegangenen sieben Tagen ab. Speichern Sie den tatsächlich zurückgegebenen Clip und seine Spezifikation für Schnitt oder weitere Prüfung; eine Auftragskennung ist nicht das audiovisuelle Artefakt. Download-Adressen sind zeitlich begrenzt. Bewahren Sie daher die Datei selbst auf, wenn Sie ein ausgewähltes Ergebnis behalten möchten.

Prüfen Sie Motivkontinuität, Bewegung, sichtbaren Text, Dialog und Ton-Timing in der Größe, in der der Clip eingesetzt wird. Formulieren Sie konkrete Rückmeldungen für das nächste kreative Briefing: die veränderte Geste, den ausgelassenen Satz oder den anzupassenden Bildausschnitt. Das nutzbare Ergebnis ist eine kurze audiovisuelle Einstellung, die sich auf den bereitgestellten Inhalt und dessen ausdrücklich festgelegte Referenzbeziehungen bezieht.

In Ailoot verfügbar · Eingaben und Methoden

Ailoot Ultra · Video POST /v1/videos
Eingabetypen
text, image
Ausgabetypen
video
Ausgabeformat
Originale MP4-Bytes; keine Normalisierung/Transkodierung
FeldTypAnforderungWerte und LimitsStandard
FeldmodelTypstringAnforderungErforderlichWerte und Limits
minimax/hailuo-3-max
Standard—
FeldpromptTypstringAnforderungErforderlichWerte und LimitsStandard—
FelddurationTypintegerAnforderungErforderlichWerte und Limits
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maximum: 600
Standard—
FeldresolutionTypstringAnforderungOptionalWerte und Limits
768p, 480p
Standard—
Feldaspect_ratioTypstringAnforderungOptionalWerte und Limits
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Standard—
Feldgenerate_audioTypbooleanAnforderungOptionalWerte und Limits
false
Standard—
Feldframe_imagesTyparrayAnforderungOptionalWerte und Limits
Mindestanzahl Elemente: 1
Maximale Anzahl Elemente: 2
Eingabeinhalt: Array von Frame-Objekten. Jedes Objekt enthält type=image_url, image_url mit url und frame_type. Verwenden Sie eine HTTPS-Bild-URL und setzen Sie frame_type auf first_frame oder last_frame. Jede Frame-Rolle darf höchstens einmal vorkommen.
Exakte Schlüssel: type, image_url, frame_type
Bedingungen: Diese Schlüssel beschreiben jedes Frame-Objekt; image_url enthält ausschließlich url. Lassen Sie frame_images bei einer reinen Textanfrage weg.
Standard—
Feldinput_referencesTyparrayAnforderungOptionalWerte und LimitsStandard—
Feldcallback_urlTypstringAnforderungOptionalWerte und Limits
Muster: ^https://
Standard—
Feldsession_idTypstringAnforderungOptionalWerte und LimitsStandard—
FeldtraceTypobjectAnforderungOptionalWerte und LimitsStandard—
FelduserTypstringAnforderungOptionalWerte und LimitsStandard—
Kombinationen von Eingabematerialien

Text zu Video · Ein schriftlicher Prompt. · Erforderlich: model, prompt, duration

Geben Sie prompt als Text und duration in ganzen Sekunden an. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.

model: Typ: string · minimax/hailuo-3-max

prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja

Bild zu Video · Ein schriftlicher Prompt und ein Bild für den ersten Frame. · Erforderlich: model, prompt, duration, frame_images

frame_images ist ein Array. Jedes Frame-Objekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame und optional last_frame. Jede Frame-Rolle darf höchstens einmal vorkommen. Geben Sie für jeden Frame eine öffentliche HTTPS-Bild-URL an. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.

Exakte Schlüssel: type, image_url, frame_type

model: Typ: string · minimax/hailuo-3-max

prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja

Methodenparameter und Lebenszyklus
ParameterVertrag
Parametercontent_typeVertragapplication/json
ParameterrequiredVertragmodel, prompt, duration
Parametermaterial_typesVertragtext, image
Parameteradditional_propertiesVertragfalse
Parameteroptional_controlsVertragresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user

Lebenszyklus: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Tarife

So wird die endgültige Gebühr berechnet

Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.

Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.

Schnellmodus
Nicht angegeben Wenn der Schnellmodus ausgewählt ist
Flex-Modus
Nicht angegeben Wenn der Modus flex ausgewählt ist
Maximaler Denkaufwand
Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird

Geschätzte Tarife zum Vergleich

Preise nach Konfiguration

Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.

KonfigurationTarifstaffelPrognostizierte MengeGebührenkomponenteAbrechnungseinheitAbrechnungsbedingungenGebühr
KonfigurationBasistarife für TokenTarifstaffelGrundtarifPrognostizierte Menge—Gebührenkomponente—Abrechnungseinheit—Abrechnungsbedingungen—Gebühr
Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token
Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token
Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token
Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token
Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token
KonfigurationVideoausgabe · ReferenzpreisTarifstaffel—Prognostizierte Menge—Gebührenkomponentereference_output_rateAbrechnungseinheitpro AusgabesekundeAbrechnungsbedingungen—Gebühr
Ausgabe · Referenzpreis pro Sekunde des Ausgabevideos · Schätzung nur zum Vergleich $0.16 pro Ausgabesekunde
KonfigurationVideopreisTarifstaffel—Prognostizierte Menge—Gebührenkomponente—Abrechnungseinheitpro VideosekundeAbrechnungsbedingungenresolution: 480pGebühr
Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.1 pro Videosekunde
KonfigurationVideopreisTarifstaffel—Prognostizierte Menge—Gebührenkomponente—Abrechnungseinheitpro VideosekundeAbrechnungsbedingungenresolution: 768pGebühr
Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.16 pro Videosekunde
KonfigurationGeschätzte GenerierungskostenTarifstaffel—Prognostizierte MengeSchätzung für eine GenerierungGebührenkomponente—Abrechnungseinheit—Abrechnungsbedingungen—Gebühr
Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.5 Schätzung vor der Generierung

Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung.

Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →

Details zum Referenztarif

Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.

Preisreferenzen für Videokonfigurationen

Preise nach Konfiguration

Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.

KonfigurationAbrechnungsbedingungenGebühr
KonfigurationVideopreisAbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben.Gebühr
Ausgabe · Videopreis $0.16 pro Videosekunde

Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration.

KonfigurationVideopreisAbrechnungsbedingungenresolution: 480pGebühr
Ausgabe · Videopreis $0.1 pro Videosekunde

Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration.

KonfigurationVideopreisAbrechnungsbedingungenresolution: 768pGebühr
Ausgabe · Videopreis $0.16 pro Videosekunde

Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration.

Beispielanfragen

Ailoot Ultra · Video

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3-max","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

Ergebnisse abrufen und speichern

Ailoot Ultra · Video

Signierte Inhalts-URLs der Ihnen zugeordneten Assets

Auftragsstatus prüfen
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Abrufe anderer Inhalte
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n    target=Path('owned-'+label+'.bin')\n    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
Alle fertiggestellten Ergebnisse aufbewahren

Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.

Bewahren Sie jede tatsächlich erzeugte, Ihnen zugeordnete Ausgabe samt den zurückgegebenen gemessenen Metadaten auf.

Wenn die ursprüngliche Antwort geprüft werden muss

503 result_pending_check + ursprüngliche ID + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen

Antwortfelder
FeldTypBedeutung
FeldindexTypintegerBedeutungBei null beginnende Position dieses Videos in der Ausgabeliste.
Feldcontent_urlTypstringBedeutungSignierte HTTPS-Download-URL für dieses fertiggestellte Video.
Feldsha256Typstring | nullBedeutungSHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar.
Feldsize_bytesTypinteger | nullBedeutungGröße der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar.
Feldduration_msTypinteger | nullBedeutungGemessene Videodauer in Millisekunden; null, falls nicht verfügbar.
FeldwidthTypinteger | nullBedeutungVideobreite in Pixeln; null, falls nicht verfügbar.
FeldheightTypinteger | nullBedeutungVideohöhe in Pixeln; null, falls nicht verfügbar.
Feldvideo_codecTypstring | nullBedeutungVideocodec-Kennung; null, falls nicht aufgezeichnet.
Feldhas_audioTypboolean | nullBedeutungGibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen.
Feldaudio_codecTypstring | nullBedeutungAudiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde.
Fehler und nächste Schritte
AntwortBedingungNächster Schritt
Antwort404 · not_found_errorBedingungDer Videozugriff ist nicht verfügbar, oder diese Video-ID wurde nicht gefunden.Nächster SchrittPrüfen Sie den Videozugriff. Verwenden Sie für ein vorhandenes Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel.
Antwort401 · authentication_errorBedingungDer API-Schlüssel passt nicht zum authentifizierten Konto.Nächster SchrittPrüfen Sie vor der Übermittlung Ihren API-Schlüssel und den Kontozugriff.
Antwort400 · invalid_request_errorBedingungDie Anfrage konnte nicht gelesen werden, oder der Downloadindex ist ungültig.Nächster SchrittKorrigieren Sie den Anfrageinhalt. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat.
Antwort422 · price_unavailableBedingungFür die ausgewählte Videokonfiguration lässt sich kein Preis bestimmen.Nächster SchrittWählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage senden.
Antwort422 · invalid_request_errorBedingungEine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig.Nächster SchrittVerwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die öffentliche Video-ID Ihres fertiggestellten Originals mit demselben API-Schlüssel.
Antwort402 · billing_errorBedingungDas verfügbare Guthaben oder die geltenden Limits lassen keine Reservierung zu.Nächster SchrittPrüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden.
Antwort503 · server_errorBedingungVideoprüfung, Speicherung oder Dienstzugriff sind vorübergehend nicht verfügbar.Nächster SchrittWarten Sie, bis der Dienst verfügbar ist. Wenn Sie bereits eine Video-ID haben, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Generierung zu erstellen.
Antwort503 · result_pending_checkBedingungDas ursprüngliche Videoergebnis und die Abrechnung müssen geprüft werden.Nächster SchrittBewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Generierungsanfrage.
Antwort503 · owned_result_unavailableBedingungDer Download des vorhandenen Videos ist vorübergehend nicht verfügbar.Nächster SchrittPrüfen Sie dieselbe Videoaufgabe später erneut und laden Sie ihre vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang.
Antwort409 · video_not_readyBedingungDer Videoinhalt wurde nicht veröffentlicht.Nächster SchrittPrüfen Sie den Status der ursprünglichen Aufgabe. Laden Sie das Ergebnis herunter, sobald completed gemeldet wird; bei failed folgen Sie dem Hinweis zur Abrechnungsprüfung.

Aliasnamen

Modellaliasnamen

Ailoot Ultra minimax/hailuo-3-max

Aliasnamen für Methodenpfade

Verwenden Sie die oben angezeigten Methodenpfade.

Zugehörige Aufrufer-IDs

minimax/hailuo-3-max

", "method_identity": { "effective_request_model_id": "minimax/hailuo-3-max", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|minimax%2Fhailuo-3-max", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Bewahren Sie jede tatsächlich erzeugte, Ihnen zugeordnete Ausgabe samt den zurückgegebenen gemessenen Metadaten auf.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Der Videozugriff ist nicht verfügbar, oder diese Video-ID wurde nicht gefunden.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Prüfen Sie den Videozugriff. Verwenden Sie für ein vorhandenes Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel.", "type": "not_found_error" }, { "condition": "Der API-Schlüssel passt nicht zum authentifizierten Konto.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Prüfen Sie vor der Übermittlung Ihren API-Schlüssel und den Kontozugriff.", "type": "authentication_error" }, { "condition": "Die Anfrage konnte nicht gelesen werden, oder der Downloadindex ist ungültig.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Korrigieren Sie den Anfrageinhalt. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat.", "type": "invalid_request_error" }, { "condition": "Für die ausgewählte Videokonfiguration lässt sich kein Preis bestimmen.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Wählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage senden.", "type": "price_unavailable" }, { "condition": "Eine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Verwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die öffentliche Video-ID Ihres fertiggestellten Originals mit demselben API-Schlüssel.", "type": "invalid_request_error" }, { "condition": "Das verfügbare Guthaben oder die geltenden Limits lassen keine Reservierung zu.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Prüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden.", "type": "billing_error" }, { "condition": "Videoprüfung, Speicherung oder Dienstzugriff sind vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Warten Sie, bis der Dienst verfügbar ist. Wenn Sie bereits eine Video-ID haben, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Generierung zu erstellen.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Das ursprüngliche Videoergebnis und die Abrechnung müssen geprüft werden.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Bewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Generierungsanfrage.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Der Download des vorhandenen Videos ist vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Prüfen Sie dieselbe Videoaufgabe später erneut und laden Sie ihre vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang.", "type": "server_error" }, { "condition": "Der Videoinhalt wurde nicht veröffentlicht.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Prüfen Sie den Status der ursprünglichen Aufgabe. Laden Sie das Ergebnis herunter, sobald completed gemeldet wird; bei failed folgen Sie dem Hinweis zur Abrechnungsprüfung.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + ursprüngliche ID + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Geben Sie prompt als Text und duration in ganzen Sekunden an. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.", "required": [ "model", "prompt", "duration" ], "required_material": "Ein schriftlicher Prompt." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images ist ein Array. Jedes Frame-Objekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame und optional last_frame. Jede Frame-Rolle darf höchstens einmal vorkommen. Geben Sie für jeden Frame eine öffentliche HTTPS-Bild-URL an. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Ein schriftlicher Prompt und ein Bild für den ersten Frame." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Bei null beginnende Position dieses Videos in der Ausgabeliste.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signierte HTTPS-Download-URL für dieses fertiggestellte Video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Größe der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Gemessene Videodauer in Millisekunden; null, falls nicht verfügbar.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videobreite in Pixeln; null, falls nicht verfügbar.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videohöhe in Pixeln; null, falls nicht verfügbar.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Videocodec-Kennung; null, falls nicht aufgezeichnet.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Gibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "Signierte Inhalts-URLs der Ihnen zugeordneten Assets", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3-max" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "768p", "480p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "768p", "480p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Diese Schlüssel beschreiben jedes Frame-Objekt; image_url enthält ausschließlich url. Lassen Sie frame_images bei einer reinen Textanfrage weg.", "content": "Array von Frame-Objekten. Jedes Objekt enthält type=image_url, image_url mit url und frame_type. Verwenden Sie eine HTTPS-Bild-URL und setzen Sie frame_type auf first_frame oder last_frame. Jede Frame-Rolle darf höchstens einmal vorkommen.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "minimax/hailuo-3-max" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "768p", "480p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Videoausgabe · Referenzpreis", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Videopreis", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Geschätzte Generierungskosten", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3-max\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"480p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video output · reference rate", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" }, { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "minimax/hailuo-3-max", "nativeProvenance": { "input_facts_canonical_sha256": "8d4ce49c51d3b711615e1cc9e85166b469c2045f3c3ced4a6a1a76941cd5dccc", "input_html_sha256": "5f7d963e45add411fa44ebac1009e4005d13320cfe1ad4daede7d4dfb1ba1dc0", "private_audit_sha256": "d182c07cec084c85f15a51c95a8c55f9368b41015dc8e89f8ceb0ab2ef922bae", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/de/minimax-hailuo-3-max/", "description": "MiniMax H3 Max ist eine schnelle, nachtrainierte H3-Variante für kurze Videos mit synchronisiertem Audio. Der dokumentierte MiniMax-Ablauf unterstützt Text, Einzelbilder und multimodale Referenzen, mit 480P- oder 768P-Ausgabe, 5–15 Sekunden Dauer und eigenen Optionen zur Prompt-Erweiterung.", "locale": "de", "md_url": "https://ailoot.ai/models/de/minimax-hailuo-3-max/index.md", "title": "MiniMax: H3 Max — Ailoot", "url": "https://ailoot.ai/models/de/minimax-hailuo-3-max/" }, "rawModel": { "about": "Eine schnelle, nachtrainierte H3-Variante\n\nMiniMax H3 Max ist eine nachtrainierte Variante des Basismodells MiniMax H3, optimiert für schnellere Generierung, Prompt-Treue und audiovisuelle Qualität. Die Variante entstand durch Nachtraining bei fal Research. Sie behält einen einheitlichen multimodalen Kontext und nativ synchronisierte Bild- und Tonausgabe bei. Geschwindigkeit ist ein Entwicklungsziel und keine feste Fertigstellungszeit für jeden Prompt, jede Dauer oder Anwendung.\n\nUnterscheiden Sie Max vom ursprünglichen H3-System und der separaten Variante Max Turbo. Die aktuelle MiniMax-Schnittstelle führt Max mit 480P oder 768P auf, mit 768P als Standard, 24 Bildern pro Sekunde und einer ganzzahligen Dauer von 5 bis 15 Sekunden. Der dokumentierte Max-Ablauf bietet weder die 2K-Einstellung des ursprünglichen H3-Systems noch eine viersekündige Ausgabe.\n\nVom Prompt zur Einstellung\n\nJede Generierung enthält ein nicht leeres Textbriefing mit bis zu 7.000 Zeichen pro Textelement. Beschreiben Sie Motiv, Ausgangskomposition, Handlung und Ergebnis und geben Sie anschließend Kamera und Ton klar vor. Legen Sie bei einer kurzen Objektenthüllung fest, was das Publikum zuerst sehen soll, wie das Objekt ins Bild gelangt und wie die Einstellung enden soll.\n\nEin hilfreiches fünfsekündiges Briefing könnte eine Keramiktasse auf einem Holztisch beschreiben, eine Hand, die daneben eine Untertasse abstellt, eine kleine Kamerafahrt nach vorn und den Klang von Keramik auf Holz. Begrenzen Sie die Handlung so, dass sie in die gewählte Dauer passt, und prüfen Sie, ob erzeugte Bewegung und Ton demselben Ereignis folgen.\n\nErstellung mit Einzelbildvorgaben\n\nDer Hersteller dokumentiert ein Anfangsbild, ein Endbild oder beide. Das erste Bild legt den Ausgangspunkt des Clips fest, das letzte den endgültigen visuellen Zustand. Erläutern Sie die verbindende Bewegung, einschließlich Änderungen an Pose, Objektposition, Kamera oder Beleuchtung. Vermeiden Sie bei einem Übergang zwischen zwei Bildern ein Briefing, das zwischen den Endpunkten eine unvereinbare Szene einführt.\n\nBei bildgeführter Ausgabe bestimmt das Eingabebild das Seitenverhältnis. Wählen Sie für reine Textaufgaben ein konkretes Verhältnis aus 21:9, 16:9, 4:3, 1:1, 3:4 oder 9:16. Referenzgeführte Aufgaben können ein adaptives Verhältnis oder eine der dokumentierten ausdrücklichen Optionen nutzen. Komponieren Sie Referenz oder geschriebene Szene für das Zielformat, statt davon auszugehen, dass dieselbe Anordnung im Hoch- und Querformat gleichermaßen funktioniert.\n\nMultimodale Referenzen\n\nDas aktuelle Max-Generierungsschema von MiniMax dokumentiert außerdem Referenzbilder, -videos und -audio. Geben Sie an, was sie jeweils beeinflussen sollen: Figurenidentität, Umgebung, Bewegungsmuster, Kamerabahn, Stimmklang oder eine Klangeigenschaft. Die Rollen als Anfangs-/Endbild und als Referenzmedium schließen sich in dieser Schnittstelle gegenseitig aus.\n\nBenennen Sie bei einer Figurenaufnahme die Erscheinungsreferenz und die Bewegungsreferenz getrennt und geben Sie anschließend Zielhandlung und gesprochenen Satz vor. Eine Stimmreferenz, die die Sprechweise festlegt, ist etwas anderes als das Kopieren ihres vollständigen Audiosignals. Beschreiben Sie ausdrücklich, welche Eigenschaften erhalten bleiben und welche Änderungen erfolgen sollen, und prüfen Sie den tatsächlichen audiovisuellen Clip anhand jeder Referenzrolle.\n\nPrompt-Erweiterung\n\nDie Max-spezifische Erweiterungseinstellung bietet disabled, balanced und quality; balanced ist die Standardeinstellung. Wählen Sie disabled, wenn das bereitgestellte Briefing ohne Erweiterung weitergegeben werden soll. Nutzen Sie einen dokumentierten Erweiterungsmodus, wenn zusätzliche Interpretation erwünscht ist. Bewahren Sie das Originalbriefing auf, damit sich eine durch die Erweiterung eingeführte Änderung vom angeforderten Inhalt unterscheiden lässt.\n\nBeschreiben Sie Ton als Teil der Szene. Benennen Sie physische Geräusche, Atmosphäre und gesprochene Wörter und trennen Sie sie von Hintergrundmusik, die ausschließlich das Publikum hört. Geben Sie den genauen Satz und die gewünschte sprechende Person vor, statt um unspezifischen Dialog zu bitten. Hören Sie das Ergebnis auch an; ein überzeugendes Bild belegt weder korrekten gesprochenen Wortlaut noch korrektes Timing.\n\nVorbereitung und Grenzen der Eingaben\n\nDas aktuelle Herstellerschema akzeptiert Bilder als JPG, JPEG, PNG, WebP, HEIC oder HEIF mit bis zu 30 MB pro Datei, Seitenlängen von 256 bis 5.760 Pixeln und Seitenverhältnissen von 0,4 bis 2,5. Die Anfangs- und Endbildrollen erlauben jeweils ein Bild; der Referenzmodus erlaubt bis zu neun Bilder. Sorgen Sie für eine klare Sicht auf Motiv und Details, die erkennbar bleiben müssen.\n\nAls Referenzvideo sind bis zu drei MP4- oder MOV-Clips erlaubt, jeweils 2–15 Sekunden und zusammen höchstens 15 Sekunden lang, mit maximal 50 MB pro Datei. Dokumentiert sind H.264- oder H.265-Video, AAC- oder MP3-Audio, Seitenlängen von 256 bis 5.760 Pixeln, Seitenverhältnisse von 0,4 bis 2,5 und Bildraten von 23,976 bis 60. Referenzaudio erlaubt bis zu drei WAV- oder MP3-Clips mit jeweils bis zu 15 MB und 2–15 Sekunden, zusammen höchstens 15 Sekunden. Für den Anfragekörper gilt eine gesonderte Grenze von 64 MB.\n\nVerwenden Sie nur Referenzen, die zur Einstellung beitragen, und benennen Sie jeden Beitrag im Text. Ein kurzer, relevanter Bewegungsclip ist als Vorgabe leichter nutzbar als eine lange Sammlung unzusammenhängender Ereignisse. Halten Sie gewünschte Dauer und Ausgabeauflösung ausdrücklich fest, damit das Ergebnis mit demselben Briefing verglichen werden kann.\n\nDas fertige Ergebnis\n\nDer asynchrone Ablauf des Herstellers gibt eine Auftragskennung zurück, bevor das fertige Video verfügbar ist. Seine Schnittstelle zur Auftragsabfrage ruft Aufträge aus den vorangegangenen sieben Tagen ab. Speichern Sie den tatsächlich zurückgegebenen Clip und seine Spezifikation für Schnitt oder weitere Prüfung; eine Auftragskennung ist nicht das audiovisuelle Artefakt. Download-Adressen sind zeitlich begrenzt. Bewahren Sie daher die Datei selbst auf, wenn Sie ein ausgewähltes Ergebnis behalten möchten.\n\nPrüfen Sie Motivkontinuität, Bewegung, sichtbaren Text, Dialog und Ton-Timing in der Größe, in der der Clip eingesetzt wird. Formulieren Sie konkrete Rückmeldungen für das nächste kreative Briefing: die veränderte Geste, den ausgelassenen Satz oder den anzupassenden Bildausschnitt. Das nutzbare Ergebnis ist eine kurze audiovisuelle Einstellung, die sich auf den bereitgestellten Inhalt und dessen ausdrücklich festgelegte Referenzbeziehungen bezieht.", "alias_of": null, "aliases": [], "author": "MiniMax", "available": null, "canonical_model": "minimax/hailuo-3-max", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Die vollständigen Preisangaben zur Konfiguration finden Sie in den Details." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "c3ee132fc5b4cd02f24f5c4d", "label": "Preisreferenzen für Videokonfigurationen", "profiles": [ { "basis": "Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration.", "dimensions": { "conditions": "In diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben." }, "label": "Videopreis", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration.", "dimensions": { "conditions": "resolution: 480p" }, "label": "Videopreis", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration.", "dimensions": { "conditions": "resolution: 768p" }, "label": "Videopreis", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "minimax/hailuo-3-max", "input": [ "text", "image" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Bewahren Sie jede tatsächlich erzeugte, Ihnen zugeordnete Ausgabe samt den zurückgegebenen gemessenen Metadaten auf.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Der Videozugriff ist nicht verfügbar, oder diese Video-ID wurde nicht gefunden.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Prüfen Sie den Videozugriff. Verwenden Sie für ein vorhandenes Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel.", "type": "not_found_error" }, { "condition": "Der API-Schlüssel passt nicht zum authentifizierten Konto.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Prüfen Sie vor der Übermittlung Ihren API-Schlüssel und den Kontozugriff.", "type": "authentication_error" }, { "condition": "Die Anfrage konnte nicht gelesen werden, oder der Downloadindex ist ungültig.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Korrigieren Sie den Anfrageinhalt. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat.", "type": "invalid_request_error" }, { "condition": "Für die ausgewählte Videokonfiguration lässt sich kein Preis bestimmen.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Wählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage senden.", "type": "price_unavailable" }, { "condition": "Eine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Verwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die öffentliche Video-ID Ihres fertiggestellten Originals mit demselben API-Schlüssel.", "type": "invalid_request_error" }, { "condition": "Das verfügbare Guthaben oder die geltenden Limits lassen keine Reservierung zu.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Prüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden.", "type": "billing_error" }, { "condition": "Videoprüfung, Speicherung oder Dienstzugriff sind vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Warten Sie, bis der Dienst verfügbar ist. Wenn Sie bereits eine Video-ID haben, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Generierung zu erstellen.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Das ursprüngliche Videoergebnis und die Abrechnung müssen geprüft werden.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Bewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Generierungsanfrage.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Der Download des vorhandenen Videos ist vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Prüfen Sie dieselbe Videoaufgabe später erneut und laden Sie ihre vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang.", "type": "server_error" }, { "condition": "Der Videoinhalt wurde nicht veröffentlicht.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Prüfen Sie den Status der ursprünglichen Aufgabe. Laden Sie das Ergebnis herunter, sobald completed gemeldet wird; bei failed folgen Sie dem Hinweis zur Abrechnungsprüfung.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + ursprüngliche ID + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Geben Sie prompt als Text und duration in ganzen Sekunden an. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.", "required": [ "model", "prompt", "duration" ], "required_material": "Ein schriftlicher Prompt." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images ist ein Array. Jedes Frame-Objekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame und optional last_frame. Jede Frame-Rolle darf höchstens einmal vorkommen. Geben Sie für jeden Frame eine öffentliche HTTPS-Bild-URL an. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Ein schriftlicher Prompt und ein Bild für den ersten Frame." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Bei null beginnende Position dieses Videos in der Ausgabeliste.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signierte HTTPS-Download-URL für dieses fertiggestellte Video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Größe der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Gemessene Videodauer in Millisekunden; null, falls nicht verfügbar.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videobreite in Pixeln; null, falls nicht verfügbar.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videohöhe in Pixeln; null, falls nicht verfügbar.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Videocodec-Kennung; null, falls nicht aufgezeichnet.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Gibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "Signierte Inhalts-URLs der Ihnen zugeordneten Assets", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3-max" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "768p", "480p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "768p", "480p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Diese Schlüssel beschreiben jedes Frame-Objekt; image_url enthält ausschließlich url. Lassen Sie frame_images bei einer reinen Textanfrage weg.", "content": "Array von Frame-Objekten. Jedes Objekt enthält type=image_url, image_url mit url und frame_type. Verwenden Sie eine HTTPS-Bild-URL und setzen Sie frame_type auf first_frame oder last_frame. Jede Frame-Rolle darf höchstens einmal vorkommen.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "minimax/hailuo-3-max" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "768p", "480p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Videoausgabe · Referenzpreis", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Videopreis", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Geschätzte Generierungskosten", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3-max\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"480p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video output · reference rate", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" }, { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "minimax/hailuo-3-max", "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra" } ], "name": "MiniMax: H3 Max", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.5, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.5, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "480P" }, "label": "Ultra", "units": [ { "amount": "0.10", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "480P" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "768P" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "480P" }, "label": "Ultra", "units": [ { "amount": "0.1106", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "480P" }, "key": "input_video", "label": "input video", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.286", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "768P" }, "key": "input_video", "label": "input video", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "first_free_reference_images": 2, "only_additional_images_charged": true, "reference_audio_free": true }, "label": "Ultra", "units": [ { "amount": "0.148", "amount_unit": "usd_per_input_image", "conditions": { "adds_to_output": true, "first_free_reference_images": 2, "only_additional_images_charged": true, "reference_audio_free": true }, "key": "input_image", "label": "input image", "profile_index": 4, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_image" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.16", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.10", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=480p", "billing_original_currency": "USD", "billing_original_rate": "0.10", "key": "duration_seconds_480p", "label": "output second", "native_amount_usd_per_unit": "0.10", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=768p", "billing_original_currency": "USD", "billing_original_rate": "0.16", "key": "duration_seconds_768p", "label": "output second", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "minimax/hailuo-3-max", "short": "MiniMax H3 Max ist eine schnelle, nachtrainierte H3-Variante für kurze Videos mit synchronisiertem Audio. Der dokumentierte MiniMax-Ablauf unterstützt Text, Einzelbilder und multimodale Referenzen, mit 480P- oder 768P-Ausgabe, 5–15 Sekunden Dauer und eigenen Optionen zur Prompt-Erweiterung." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "MiniMax H3 Max ist eine schnelle, nachtrainierte H3-Variante für kurze Videos mit synchronisiertem Audio. Der dokumentierte MiniMax-Ablauf unterstützt Text, Einzelbilder und multimodale Referenzen, mit 480P- oder 768P-Ausgabe, 5–15 Sekunden Dauer und eigenen Optionen zur Prompt-Erweiterung.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "cd209f9538ef509559deed5acf14d5ab5dbc0bde7831c330e83bd955477d8fa3", "renderer_sha256": "8bd3076b303b7b3aa4d961032854071403a471ec26a4f50c64e3a32556ea2925" }, "sourceRevision": "0903e50aed004d24eda7069df71c5f516e74ca18a2136cfc22b7d2ac31d4c5ca" }