{ "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 wurde durch Nachtraining von fal Research entwickelt. Sie erhält den einheitlichen multimodalen Kontext sowie die native Synchronisation von Bild und Ton. Geschwindigkeit ist ein Entwicklungsziel, 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, standardmässig 768P, 24 Bildern pro Sekunde und ganzzahliger 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, Anfangskomposition, Handlung und Ergebnis und machen Sie Kamera- und Tonanweisungen deutlich. Bestimmen Sie bei einer kurzen Objektenthüllung, was zuerst sichtbar sein soll, wie das Objekt ins Bild gelangt und wie die Einstellung endet.

Ein brauchbares Fünfsekunden-Briefing könnte eine Keramiktasse auf einem Holztisch, eine Hand, die eine Untertasse danebenstellt, eine kleine Kameravorfahrt und das Geräusch von Keramik auf Holz beschreiben. Halten Sie die Handlung klein genug für die gewählte Dauer und prüfen Sie, ob zurückgegebene Bewegung und Ton demselben Ereignis folgen.

Einzelbildgesteuerte Erstellung

Der Hersteller dokumentiert ein Eröffnungsbild, ein Endbild oder beide. Ein erstes Bild legt fest, wo der Clip beginnt; ein letztes bestimmt den endgültigen visuellen Zustand. Erklären Sie die verbindende Bewegung, einschliesslich Änderungen an Haltung, Objektposition, Kamera oder Licht. Vermeiden Sie bei einem Übergang zwischen zwei Bildern ein Briefing, das dazwischen eine unvereinbare Szene einführt.

Einzelbildgesteuerte Ausgabe übernimmt ihr Seitenverhältnis vom Eingabebild. Wählen Sie für reine Textarbeit ein konkretes Verhältnis aus 21:9, 16:9, 4:3, 1:1, 3:4 oder 9:16. Referenzgestützte Arbeit kann ein adaptives Verhältnis oder eine der dokumentierten ausdrücklichen Optionen verwenden. Komponieren Sie Referenz oder schriftliche Szene für den Zielrahmen, statt anzunehmen, dieselbe Anordnung funktioniere im Hoch- und Querformat gleich gut.

Multimodale Referenzen

MiniMaxs aktuelles Max-Generierungsschema dokumentiert auch Referenzbilder, -videos und -ton. Geben Sie an, was jedes Material beeinflussen soll: Figurenidentität, Umgebung, Bewegungsmuster, Kamerabahn, Stimmklang oder Geräuschmerkmal. Erst-/Letztbildrollen und Referenzmedienrollen schliessen sich in dieser Schnittstelle gegenseitig aus.

Benennen Sie bei einer Figureneinstellung Erscheinungs- und Bewegungsreferenz getrennt und geben Sie anschliessend Zielhandlung und gesprochenen Satz an. Eine Stimmreferenz zur Darbietung ist etwas anderes als die Kopie ihres vollständigen Audiosignals. Formulieren Sie beizubehaltende Merkmale und gewünschte Änderungen ausdrücklich und prüfen Sie den tatsächlichen audiovisuellen Clip anhand jeder Referenzrolle.

Prompt-Erweiterung

Die Max-spezifische Erweiterungseinstellung bietet disabled, balanced und quality, standardmässig balanced. Wählen Sie disabled, wenn das bereitgestellte Briefing ohne Erweiterung durchgehen soll; verwenden Sie einen dokumentierten Erweiterungsmodus, wenn zusätzliche Interpretation erwünscht ist. Bewahren Sie das ursprüngliche Briefing auf, damit sich während der Erweiterung eingeführte Änderungen vom angeforderten Inhalt unterscheiden lassen.

Beschreiben Sie Ton als Teil der Szene. Benennen Sie physische Geräusche, Atmosphäre und gesprochene Wörter und trennen Sie sie von nur für das Publikum hörbarer Hintergrundmusik. Geben Sie den exakten Satz und vorgesehenen Sprecher an, statt unbestimmten Dialog zu verlangen. Hören und sehen Sie sich das Ergebnis an; ein überzeugendes Bild belegt nicht den korrekten gesprochenen Wortlaut oder das Timing.

Eingabevorbereitung und Grenzen

Das aktuelle Herstellerschema akzeptiert JPG-, JPEG-, PNG-, WebP-, HEIC- oder HEIF-Bilder bis 30 MB pro Datei mit Seiten von 256 bis 5’760 Pixeln und Verhältnissen von 0.4 bis 2.5. Eröffnungs- und Endbildrollen erlauben je ein Bild; der Referenzmodus bis zu neun Bilder. Erhalten Sie eine klare Sicht auf Motiv und Details, die identifizierbar bleiben müssen.

Referenzvideo erlaubt bis zu drei MP4- oder MOV-Clips, jeweils 2–15 Sekunden und zusammen höchstens 15 Sekunden, mit maximal 50 MB pro Datei. Dokumentiert sind H.264- oder H.265-Video, AAC- oder MP3-Ton, Seiten von 256 bis 5’760 Pixeln, Verhältnisse von 0.4 bis 2.5 und Bildraten von 23.976 bis 60. Referenzton erlaubt bis zu drei WAV- oder MP3-Clips, jeweils bis 15 MB und 2–15 Sekunden, zusammen höchstens 15 Sekunden. Der Anfragekörper hat eine separate Grenze von 64 MB.

Verwenden Sie nur Referenzen, die zur Einstellung beitragen, und benennen Sie jeden Beitrag im Text. Ein kurzer relevanter Bewegungsclip eignet sich besser als Vorgabe 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 Herstellerablauf liefert eine Auftragskennung, bevor das fertige Video verfügbar ist. Seine Auftragsabfrage ruft Aufträge der vorausgehenden sieben Tage 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 Ergebnis. Downloadadressen sind zeitlich begrenzt; bewahren Sie bei einem gewählten Ergebnis deshalb die Datei selbst auf.

Prüfen Sie Motivkontinuität, Bewegung, sichtbaren Text, Dialog und Tontiming in der vorgesehenen Anzeigegrösse. Geben Sie für ein weiteres kreatives Briefing konkrete Rückmeldung: die veränderte Geste, den ausgelassenen Satz oder den anzupassenden Bildausschnitt. Das brauchbare Ergebnis ist eine kurze audiovisuelle Einstellung, die an den gelieferten Inhalt und seine ausdrücklichen Referenzbeziehungen gebunden ist.

", "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 wurde durch Nachtraining von fal Research entwickelt. Sie erhält den einheitlichen multimodalen Kontext sowie die native Synchronisation von Bild und Ton. Geschwindigkeit ist ein Entwicklungsziel, 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, standardmässig 768P, 24 Bildern pro Sekunde und ganzzahliger 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, Anfangskomposition, Handlung und Ergebnis und machen Sie Kamera- und Tonanweisungen deutlich. Bestimmen Sie bei einer kurzen Objektenthüllung, was zuerst sichtbar sein soll, wie das Objekt ins Bild gelangt und wie die Einstellung endet.\n\nEin brauchbares Fünfsekunden-Briefing könnte eine Keramiktasse auf einem Holztisch, eine Hand, die eine Untertasse danebenstellt, eine kleine Kameravorfahrt und das Geräusch von Keramik auf Holz beschreiben. Halten Sie die Handlung klein genug für die gewählte Dauer und prüfen Sie, ob zurückgegebene Bewegung und Ton demselben Ereignis folgen.\n\nEinzelbildgesteuerte Erstellung\n\nDer Hersteller dokumentiert ein Eröffnungsbild, ein Endbild oder beide. Ein erstes Bild legt fest, wo der Clip beginnt; ein letztes bestimmt den endgültigen visuellen Zustand. Erklären Sie die verbindende Bewegung, einschliesslich Änderungen an Haltung, Objektposition, Kamera oder Licht. Vermeiden Sie bei einem Übergang zwischen zwei Bildern ein Briefing, das dazwischen eine unvereinbare Szene einführt.\n\nEinzelbildgesteuerte Ausgabe übernimmt ihr Seitenverhältnis vom Eingabebild. Wählen Sie für reine Textarbeit ein konkretes Verhältnis aus 21:9, 16:9, 4:3, 1:1, 3:4 oder 9:16. Referenzgestützte Arbeit kann ein adaptives Verhältnis oder eine der dokumentierten ausdrücklichen Optionen verwenden. Komponieren Sie Referenz oder schriftliche Szene für den Zielrahmen, statt anzunehmen, dieselbe Anordnung funktioniere im Hoch- und Querformat gleich gut.\n\nMultimodale Referenzen\n\nMiniMaxs aktuelles Max-Generierungsschema dokumentiert auch Referenzbilder, -videos und -ton. Geben Sie an, was jedes Material beeinflussen soll: Figurenidentität, Umgebung, Bewegungsmuster, Kamerabahn, Stimmklang oder Geräuschmerkmal. Erst-/Letztbildrollen und Referenzmedienrollen schliessen sich in dieser Schnittstelle gegenseitig aus.\n\nBenennen Sie bei einer Figureneinstellung Erscheinungs- und Bewegungsreferenz getrennt und geben Sie anschliessend Zielhandlung und gesprochenen Satz an. Eine Stimmreferenz zur Darbietung ist etwas anderes als die Kopie ihres vollständigen Audiosignals. Formulieren Sie beizubehaltende Merkmale und gewünschte Änderungen ausdrücklich 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, standardmässig balanced. Wählen Sie disabled, wenn das bereitgestellte Briefing ohne Erweiterung durchgehen soll; verwenden Sie einen dokumentierten Erweiterungsmodus, wenn zusätzliche Interpretation erwünscht ist. Bewahren Sie das ursprüngliche Briefing auf, damit sich während der Erweiterung eingeführte Änderungen vom angeforderten Inhalt unterscheiden lassen.\n\nBeschreiben Sie Ton als Teil der Szene. Benennen Sie physische Geräusche, Atmosphäre und gesprochene Wörter und trennen Sie sie von nur für das Publikum hörbarer Hintergrundmusik. Geben Sie den exakten Satz und vorgesehenen Sprecher an, statt unbestimmten Dialog zu verlangen. Hören und sehen Sie sich das Ergebnis an; ein überzeugendes Bild belegt nicht den korrekten gesprochenen Wortlaut oder das Timing.\n\nEingabevorbereitung und Grenzen\n\nDas aktuelle Herstellerschema akzeptiert JPG-, JPEG-, PNG-, WebP-, HEIC- oder HEIF-Bilder bis 30 MB pro Datei mit Seiten von 256 bis 5’760 Pixeln und Verhältnissen von 0.4 bis 2.5. Eröffnungs- und Endbildrollen erlauben je ein Bild; der Referenzmodus bis zu neun Bilder. Erhalten Sie eine klare Sicht auf Motiv und Details, die identifizierbar bleiben müssen.\n\nReferenzvideo erlaubt bis zu drei MP4- oder MOV-Clips, jeweils 2–15 Sekunden und zusammen höchstens 15 Sekunden, mit maximal 50 MB pro Datei. Dokumentiert sind H.264- oder H.265-Video, AAC- oder MP3-Ton, Seiten von 256 bis 5’760 Pixeln, Verhältnisse von 0.4 bis 2.5 und Bildraten von 23.976 bis 60. Referenzton erlaubt bis zu drei WAV- oder MP3-Clips, jeweils bis 15 MB und 2–15 Sekunden, zusammen höchstens 15 Sekunden. Der Anfragekörper hat eine separate Grenze von 64 MB.\n\nVerwenden Sie nur Referenzen, die zur Einstellung beitragen, und benennen Sie jeden Beitrag im Text. Ein kurzer relevanter Bewegungsclip eignet sich besser als Vorgabe 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 Herstellerablauf liefert eine Auftragskennung, bevor das fertige Video verfügbar ist. Seine Auftragsabfrage ruft Aufträge der vorausgehenden sieben Tage 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 Ergebnis. Downloadadressen sind zeitlich begrenzt; bewahren Sie bei einem gewählten Ergebnis deshalb die Datei selbst auf.\n\nPrüfen Sie Motivkontinuität, Bewegung, sichtbaren Text, Dialog und Tontiming in der vorgesehenen Anzeigegrösse. Geben Sie für ein weiteres kreatives Briefing konkrete Rückmeldung: die veränderte Geste, den ausgelassenen Satz oder den anzupassenden Bildausschnitt. Das brauchbare Ergebnis ist eine kurze audiovisuelle Einstellung, die an den gelieferten Inhalt und seine ausdrücklichen Referenzbeziehungen gebunden ist.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "7718b6021610564bc9fc0c58e709ef8c14bd8219308fbbae1bb5c801e8f98d6a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de-ch", "methods": [ { "html": "
MM

MiniMax: H3 Max

MiniMax /minimax/hailuo-3-max

Einstieg

MiniMax H3 Max ist eine schnelle, nachtrainierte H3-Variante für kurze Videos mit synchronisiertem Ton. MiniMaxs dokumentierter 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 wurde durch Nachtraining von fal Research entwickelt. Sie erhält den einheitlichen multimodalen Kontext sowie die native Synchronisation von Bild und Ton. Geschwindigkeit ist ein Entwicklungsziel, 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, standardmässig 768P, 24 Bildern pro Sekunde und ganzzahliger 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, Anfangskomposition, Handlung und Ergebnis und machen Sie Kamera- und Tonanweisungen deutlich. Bestimmen Sie bei einer kurzen Objektenthüllung, was zuerst sichtbar sein soll, wie das Objekt ins Bild gelangt und wie die Einstellung endet.

Ein brauchbares Fünfsekunden-Briefing könnte eine Keramiktasse auf einem Holztisch, eine Hand, die eine Untertasse danebenstellt, eine kleine Kameravorfahrt und das Geräusch von Keramik auf Holz beschreiben. Halten Sie die Handlung klein genug für die gewählte Dauer und prüfen Sie, ob zurückgegebene Bewegung und Ton demselben Ereignis folgen.

Einzelbildgesteuerte Erstellung

Der Hersteller dokumentiert ein Eröffnungsbild, ein Endbild oder beide. Ein erstes Bild legt fest, wo der Clip beginnt; ein letztes bestimmt den endgültigen visuellen Zustand. Erklären Sie die verbindende Bewegung, einschliesslich Änderungen an Haltung, Objektposition, Kamera oder Licht. Vermeiden Sie bei einem Übergang zwischen zwei Bildern ein Briefing, das dazwischen eine unvereinbare Szene einführt.

Einzelbildgesteuerte Ausgabe übernimmt ihr Seitenverhältnis vom Eingabebild. Wählen Sie für reine Textarbeit ein konkretes Verhältnis aus 21:9, 16:9, 4:3, 1:1, 3:4 oder 9:16. Referenzgestützte Arbeit kann ein adaptives Verhältnis oder eine der dokumentierten ausdrücklichen Optionen verwenden. Komponieren Sie Referenz oder schriftliche Szene für den Zielrahmen, statt anzunehmen, dieselbe Anordnung funktioniere im Hoch- und Querformat gleich gut.

Multimodale Referenzen

MiniMaxs aktuelles Max-Generierungsschema dokumentiert auch Referenzbilder, -videos und -ton. Geben Sie an, was jedes Material beeinflussen soll: Figurenidentität, Umgebung, Bewegungsmuster, Kamerabahn, Stimmklang oder Geräuschmerkmal. Erst-/Letztbildrollen und Referenzmedienrollen schliessen sich in dieser Schnittstelle gegenseitig aus.

Benennen Sie bei einer Figureneinstellung Erscheinungs- und Bewegungsreferenz getrennt und geben Sie anschliessend Zielhandlung und gesprochenen Satz an. Eine Stimmreferenz zur Darbietung ist etwas anderes als die Kopie ihres vollständigen Audiosignals. Formulieren Sie beizubehaltende Merkmale und gewünschte Änderungen ausdrücklich und prüfen Sie den tatsächlichen audiovisuellen Clip anhand jeder Referenzrolle.

Prompt-Erweiterung

Die Max-spezifische Erweiterungseinstellung bietet disabled, balanced und quality, standardmässig balanced. Wählen Sie disabled, wenn das bereitgestellte Briefing ohne Erweiterung durchgehen soll; verwenden Sie einen dokumentierten Erweiterungsmodus, wenn zusätzliche Interpretation erwünscht ist. Bewahren Sie das ursprüngliche Briefing auf, damit sich während der Erweiterung eingeführte Änderungen vom angeforderten Inhalt unterscheiden lassen.

Beschreiben Sie Ton als Teil der Szene. Benennen Sie physische Geräusche, Atmosphäre und gesprochene Wörter und trennen Sie sie von nur für das Publikum hörbarer Hintergrundmusik. Geben Sie den exakten Satz und vorgesehenen Sprecher an, statt unbestimmten Dialog zu verlangen. Hören und sehen Sie sich das Ergebnis an; ein überzeugendes Bild belegt nicht den korrekten gesprochenen Wortlaut oder das Timing.

Eingabevorbereitung und Grenzen

Das aktuelle Herstellerschema akzeptiert JPG-, JPEG-, PNG-, WebP-, HEIC- oder HEIF-Bilder bis 30 MB pro Datei mit Seiten von 256 bis 5’760 Pixeln und Verhältnissen von 0.4 bis 2.5. Eröffnungs- und Endbildrollen erlauben je ein Bild; der Referenzmodus bis zu neun Bilder. Erhalten Sie eine klare Sicht auf Motiv und Details, die identifizierbar bleiben müssen.

Referenzvideo erlaubt bis zu drei MP4- oder MOV-Clips, jeweils 2–15 Sekunden und zusammen höchstens 15 Sekunden, mit maximal 50 MB pro Datei. Dokumentiert sind H.264- oder H.265-Video, AAC- oder MP3-Ton, Seiten von 256 bis 5’760 Pixeln, Verhältnisse von 0.4 bis 2.5 und Bildraten von 23.976 bis 60. Referenzton erlaubt bis zu drei WAV- oder MP3-Clips, jeweils bis 15 MB und 2–15 Sekunden, zusammen höchstens 15 Sekunden. Der Anfragekörper hat eine separate Grenze von 64 MB.

Verwenden Sie nur Referenzen, die zur Einstellung beitragen, und benennen Sie jeden Beitrag im Text. Ein kurzer relevanter Bewegungsclip eignet sich besser als Vorgabe 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 Herstellerablauf liefert eine Auftragskennung, bevor das fertige Video verfügbar ist. Seine Auftragsabfrage ruft Aufträge der vorausgehenden sieben Tage 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 Ergebnis. Downloadadressen sind zeitlich begrenzt; bewahren Sie bei einem gewählten Ergebnis deshalb die Datei selbst auf.

Prüfen Sie Motivkontinuität, Bewegung, sichtbaren Text, Dialog und Tontiming in der vorgesehenen Anzeigegrösse. Geben Sie für ein weiteres kreatives Briefing konkrete Rückmeldung: die veränderte Geste, den ausgelassenen Satz oder den anzupassenden Bildausschnitt. Das brauchbare Ergebnis ist eine kurze audiovisuelle Einstellung, die an den gelieferten Inhalt und seine ausdrücklichen Referenzbeziehungen gebunden ist.

In Ailoot verfügbar · Eingaben und Methoden

Ailoot Ultra · Video POST /v1/videos
Eingabe
text, image
Ausgabe
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 Bildobjekten. 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 Bildrolle darf höchstens einmal vorkommen.
Exakte Schlüssel: type, image_url, frame_type
Bedingungen: Diese Schlüssel beschreiben jedes Bildobjekt; image_url enthält ausschliesslich 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 · Eine schriftliche Beschreibung. · 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 ausser Leerraum erforderlich: Ja

Bild zu Video · Eine schriftliche Beschreibung und ein Bild für das erste Einzelbild. · Erforderlich: model, prompt, duration, frame_images

frame_images ist ein Array. Jedes Bildobjekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame mit einem optionalen last_frame. Jede Bildrolle darf höchstens einmal vorkommen. Geben Sie für jedes Bild 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 ausser 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
KonfigurationToken-BasistarifeTarifstaffelGrundtarifPrognostizierte Menge—Gebührenkomponente—Abrechnungseinheit—Abrechnungsbedingungen—Gebühr
Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens
Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens
Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens
Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens
Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens
KonfigurationVideoausgabe · ReferenzpreisTarifstaffel—Prognostizierte Menge—Gebührenkomponentereference_output_rateAbrechnungseinheitpro AusgabesekundeAbrechnungsbedingungen—Gebühr
Ausgabe · Referenztarif pro Ausgabevideo-Sekunde · 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 ErzeugungskostenTarifstaffel—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 abschliessenden 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 Ausgaben

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ächliche, Ihnen zugeordnete Ausgabe und die 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-URL zum Herunterladen dieses fertiggestellten Videos.
Feldsha256Typstring | nullBedeutungSHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar.
Feldsize_bytesTypinteger | nullBedeutungGrösse 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 | nullBedeutungKennung des Videocodecs; null, falls nicht aufgezeichnet.
Feldhas_audioTypboolean | nullBedeutungGibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen.
Feldaudio_codecTypstring | nullBedeutungKennung des Audiocodecs; 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 bei einem bestehenden Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel.
Antwort401 · authentication_errorBedingungDer API-Schlüssel stimmt nicht mit dem authentifizierten Konto überein.Nächster SchrittPrüfen Sie vor dem Einreichen 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 Anfragetext. 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 ermitteln.Nächster SchrittWählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage einreichen.
Antwort422 · invalid_request_errorBedingungEine Videoeingabe oder eine ursprüngliche Fortsetzungsaufgabe ist ungültig.Nächster SchrittVerwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die ursprüngliche öffentliche Video-ID Ihres fertiggestellten Videos mit demselben API-Schlüssel.
Antwort402 · billing_errorBedingungDas verfügbare Guthaben oder die geltenden Limiten erlauben keine Reservierung.Nächster SchrittPrüfen Sie Ihr verfügbares Guthaben und Ihre Limiten, bevor Sie eine neue Anfrage senden.
Antwort503 · server_errorBedingungVideoprüfung, Speicher oder Dienstzugriff ist vorübergehend nicht verfügbar.Nächster SchrittWarten Sie, bis der Dienst verfügbar ist. Falls Sie bereits eine Video-ID besitzen, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Erzeugung zu erstellen.
Antwort503 · result_pending_checkBedingungDas ursprüngliche Videoergebnis und die Abbuchung 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 Erzeugungsanfrage.
Antwort503 · owned_result_unavailableBedingungDer Download des bestehenden Videos ist vorübergehend nicht verfügbar.Nächster SchrittPrüfen Sie später dieselbe Videoaufgabe und laden Sie deren bestehende Ausgabe herunter. Eine neue Erzeugung erstellt einen separaten Vorgang.
Antwort409 · video_not_readyBedingungDer Videoinhalt wurde nicht veröffentlicht.Nächster SchrittPrüfen Sie den ursprünglichen Aufgabenstatus. Laden Sie die Ausgabe herunter, nachdem completed gemeldet wird; bei failed befolgen Sie den Hinweis zur Prüfung der Abbuchung.

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ächliche, Ihnen zugeordnete Ausgabe und die 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 bei einem bestehenden Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel.", "type": "not_found_error" }, { "condition": "Der API-Schlüssel stimmt nicht mit dem authentifizierten Konto überein.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Prüfen Sie vor dem Einreichen 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 Anfragetext. 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 ermitteln.", "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 einreichen.", "type": "price_unavailable" }, { "condition": "Eine Videoeingabe oder eine 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 ursprüngliche öffentliche Video-ID Ihres fertiggestellten Videos mit demselben API-Schlüssel.", "type": "invalid_request_error" }, { "condition": "Das verfügbare Guthaben oder die geltenden Limiten erlauben keine Reservierung.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Prüfen Sie Ihr verfügbares Guthaben und Ihre Limiten, bevor Sie eine neue Anfrage senden.", "type": "billing_error" }, { "condition": "Videoprüfung, Speicher oder Dienstzugriff ist vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Warten Sie, bis der Dienst verfügbar ist. Falls Sie bereits eine Video-ID besitzen, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Erzeugung zu erstellen.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Das ursprüngliche Videoergebnis und die Abbuchung 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 Erzeugungsanfrage.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Der Download des bestehenden Videos ist vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Prüfen Sie später dieselbe Videoaufgabe und laden Sie deren bestehende Ausgabe herunter. Eine neue Erzeugung 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 ursprünglichen Aufgabenstatus. Laden Sie die Ausgabe herunter, nachdem completed gemeldet wird; bei failed befolgen Sie den Hinweis zur Prüfung der Abbuchung.", "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": "Eine schriftliche Beschreibung." }, { "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 Bildobjekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame mit einem optionalen last_frame. Jede Bildrolle darf höchstens einmal vorkommen. Geben Sie für jedes Bild 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": "Eine schriftliche Beschreibung und ein Bild für das erste Einzelbild." } ], "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-URL zum Herunterladen dieses fertiggestellten Videos.", "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össe 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": "Kennung des Videocodecs; 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": "Kennung des Audiocodecs; 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 Ausgaben", "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 Bildobjekt; image_url enthält ausschliesslich url. Lassen Sie frame_images bei einer reinen Textanfrage weg.", "content": "Array von Bildobjekten. 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 Bildrolle 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 Erzeugungskosten", "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": "ddcea445fa6519a4ba023a707c6344939f5e26a6ceda54cf9dd870b78ba36c22", "input_html_sha256": "9c2813b1160e4bc09c73c79d4e68cbebfeaae0791be905dfef4b61ce633ccfa0", "private_audit_sha256": "9fb486fd13c44b34b593d92a519c50938e1a22c0e268a67185cd7b0ef7351c90", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/de-ch/minimax-hailuo-3-max/", "description": "MiniMax H3 Max ist eine schnelle, nachtrainierte H3-Variante für kurze Videos mit synchronisiertem Ton. MiniMaxs dokumentierter 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-ch", "md_url": "https://ailoot.ai/models/de-ch/minimax-hailuo-3-max/index.md", "title": "MiniMax: H3 Max — Ailoot", "url": "https://ailoot.ai/models/de-ch/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 wurde durch Nachtraining von fal Research entwickelt. Sie erhält den einheitlichen multimodalen Kontext sowie die native Synchronisation von Bild und Ton. Geschwindigkeit ist ein Entwicklungsziel, 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, standardmässig 768P, 24 Bildern pro Sekunde und ganzzahliger 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, Anfangskomposition, Handlung und Ergebnis und machen Sie Kamera- und Tonanweisungen deutlich. Bestimmen Sie bei einer kurzen Objektenthüllung, was zuerst sichtbar sein soll, wie das Objekt ins Bild gelangt und wie die Einstellung endet.\n\nEin brauchbares Fünfsekunden-Briefing könnte eine Keramiktasse auf einem Holztisch, eine Hand, die eine Untertasse danebenstellt, eine kleine Kameravorfahrt und das Geräusch von Keramik auf Holz beschreiben. Halten Sie die Handlung klein genug für die gewählte Dauer und prüfen Sie, ob zurückgegebene Bewegung und Ton demselben Ereignis folgen.\n\nEinzelbildgesteuerte Erstellung\n\nDer Hersteller dokumentiert ein Eröffnungsbild, ein Endbild oder beide. Ein erstes Bild legt fest, wo der Clip beginnt; ein letztes bestimmt den endgültigen visuellen Zustand. Erklären Sie die verbindende Bewegung, einschliesslich Änderungen an Haltung, Objektposition, Kamera oder Licht. Vermeiden Sie bei einem Übergang zwischen zwei Bildern ein Briefing, das dazwischen eine unvereinbare Szene einführt.\n\nEinzelbildgesteuerte Ausgabe übernimmt ihr Seitenverhältnis vom Eingabebild. Wählen Sie für reine Textarbeit ein konkretes Verhältnis aus 21:9, 16:9, 4:3, 1:1, 3:4 oder 9:16. Referenzgestützte Arbeit kann ein adaptives Verhältnis oder eine der dokumentierten ausdrücklichen Optionen verwenden. Komponieren Sie Referenz oder schriftliche Szene für den Zielrahmen, statt anzunehmen, dieselbe Anordnung funktioniere im Hoch- und Querformat gleich gut.\n\nMultimodale Referenzen\n\nMiniMaxs aktuelles Max-Generierungsschema dokumentiert auch Referenzbilder, -videos und -ton. Geben Sie an, was jedes Material beeinflussen soll: Figurenidentität, Umgebung, Bewegungsmuster, Kamerabahn, Stimmklang oder Geräuschmerkmal. Erst-/Letztbildrollen und Referenzmedienrollen schliessen sich in dieser Schnittstelle gegenseitig aus.\n\nBenennen Sie bei einer Figureneinstellung Erscheinungs- und Bewegungsreferenz getrennt und geben Sie anschliessend Zielhandlung und gesprochenen Satz an. Eine Stimmreferenz zur Darbietung ist etwas anderes als die Kopie ihres vollständigen Audiosignals. Formulieren Sie beizubehaltende Merkmale und gewünschte Änderungen ausdrücklich 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, standardmässig balanced. Wählen Sie disabled, wenn das bereitgestellte Briefing ohne Erweiterung durchgehen soll; verwenden Sie einen dokumentierten Erweiterungsmodus, wenn zusätzliche Interpretation erwünscht ist. Bewahren Sie das ursprüngliche Briefing auf, damit sich während der Erweiterung eingeführte Änderungen vom angeforderten Inhalt unterscheiden lassen.\n\nBeschreiben Sie Ton als Teil der Szene. Benennen Sie physische Geräusche, Atmosphäre und gesprochene Wörter und trennen Sie sie von nur für das Publikum hörbarer Hintergrundmusik. Geben Sie den exakten Satz und vorgesehenen Sprecher an, statt unbestimmten Dialog zu verlangen. Hören und sehen Sie sich das Ergebnis an; ein überzeugendes Bild belegt nicht den korrekten gesprochenen Wortlaut oder das Timing.\n\nEingabevorbereitung und Grenzen\n\nDas aktuelle Herstellerschema akzeptiert JPG-, JPEG-, PNG-, WebP-, HEIC- oder HEIF-Bilder bis 30 MB pro Datei mit Seiten von 256 bis 5’760 Pixeln und Verhältnissen von 0.4 bis 2.5. Eröffnungs- und Endbildrollen erlauben je ein Bild; der Referenzmodus bis zu neun Bilder. Erhalten Sie eine klare Sicht auf Motiv und Details, die identifizierbar bleiben müssen.\n\nReferenzvideo erlaubt bis zu drei MP4- oder MOV-Clips, jeweils 2–15 Sekunden und zusammen höchstens 15 Sekunden, mit maximal 50 MB pro Datei. Dokumentiert sind H.264- oder H.265-Video, AAC- oder MP3-Ton, Seiten von 256 bis 5’760 Pixeln, Verhältnisse von 0.4 bis 2.5 und Bildraten von 23.976 bis 60. Referenzton erlaubt bis zu drei WAV- oder MP3-Clips, jeweils bis 15 MB und 2–15 Sekunden, zusammen höchstens 15 Sekunden. Der Anfragekörper hat eine separate Grenze von 64 MB.\n\nVerwenden Sie nur Referenzen, die zur Einstellung beitragen, und benennen Sie jeden Beitrag im Text. Ein kurzer relevanter Bewegungsclip eignet sich besser als Vorgabe 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 Herstellerablauf liefert eine Auftragskennung, bevor das fertige Video verfügbar ist. Seine Auftragsabfrage ruft Aufträge der vorausgehenden sieben Tage 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 Ergebnis. Downloadadressen sind zeitlich begrenzt; bewahren Sie bei einem gewählten Ergebnis deshalb die Datei selbst auf.\n\nPrüfen Sie Motivkontinuität, Bewegung, sichtbaren Text, Dialog und Tontiming in der vorgesehenen Anzeigegrösse. Geben Sie für ein weiteres kreatives Briefing konkrete Rückmeldung: die veränderte Geste, den ausgelassenen Satz oder den anzupassenden Bildausschnitt. Das brauchbare Ergebnis ist eine kurze audiovisuelle Einstellung, die an den gelieferten Inhalt und seine ausdrücklichen Referenzbeziehungen gebunden ist.", "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ächliche, Ihnen zugeordnete Ausgabe und die 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 bei einem bestehenden Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel.", "type": "not_found_error" }, { "condition": "Der API-Schlüssel stimmt nicht mit dem authentifizierten Konto überein.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Prüfen Sie vor dem Einreichen 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 Anfragetext. 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 ermitteln.", "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 einreichen.", "type": "price_unavailable" }, { "condition": "Eine Videoeingabe oder eine 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 ursprüngliche öffentliche Video-ID Ihres fertiggestellten Videos mit demselben API-Schlüssel.", "type": "invalid_request_error" }, { "condition": "Das verfügbare Guthaben oder die geltenden Limiten erlauben keine Reservierung.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Prüfen Sie Ihr verfügbares Guthaben und Ihre Limiten, bevor Sie eine neue Anfrage senden.", "type": "billing_error" }, { "condition": "Videoprüfung, Speicher oder Dienstzugriff ist vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Warten Sie, bis der Dienst verfügbar ist. Falls Sie bereits eine Video-ID besitzen, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Erzeugung zu erstellen.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Das ursprüngliche Videoergebnis und die Abbuchung 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 Erzeugungsanfrage.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Der Download des bestehenden Videos ist vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Prüfen Sie später dieselbe Videoaufgabe und laden Sie deren bestehende Ausgabe herunter. Eine neue Erzeugung 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 ursprünglichen Aufgabenstatus. Laden Sie die Ausgabe herunter, nachdem completed gemeldet wird; bei failed befolgen Sie den Hinweis zur Prüfung der Abbuchung.", "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": "Eine schriftliche Beschreibung." }, { "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 Bildobjekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame mit einem optionalen last_frame. Jede Bildrolle darf höchstens einmal vorkommen. Geben Sie für jedes Bild 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": "Eine schriftliche Beschreibung und ein Bild für das erste Einzelbild." } ], "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-URL zum Herunterladen dieses fertiggestellten Videos.", "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össe 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": "Kennung des Videocodecs; 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": "Kennung des Audiocodecs; 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 Ausgaben", "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 Bildobjekt; image_url enthält ausschliesslich url. Lassen Sie frame_images bei einer reinen Textanfrage weg.", "content": "Array von Bildobjekten. 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 Bildrolle 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 Erzeugungskosten", "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 Ton. MiniMaxs dokumentierter 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 Ton. MiniMaxs dokumentierter 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": "52620c7061897ad864a382117f356199a691326c019ade96cf55786799f876ca", "renderer_sha256": "76caa42c097db2ddc47d1e1e6fe7ca45c8363d7211296daf28e4352971e6c0c8" }, "sourceRevision": "e30a82e958f898fc7bb13cba59fb79733051d555135a9e0733afadc9ee5f4236" }