{ "aboutHtml": "

Eén audiovisueel resultaat uit een multimodale briefing

MiniMax H3 is het omnimodale videosysteem van MiniMax. Het interpreteert tekst, afbeeldingen, video en audio samen en genereert vervolgens video met native stereogeluid. De maker presenteert het voor kort creatief werk zoals productbeelden, reclame, geanimeerde posters en concepten voor filmtitels, waarbij de relaties tussen referentiematerialen even belangrijk zijn als de scènebeschrijving.

Het gedocumenteerde systeem produceert video van 4–15 seconden bij 24 beelden per seconde met 32 kHz-stereo-audio. H3-Base genereert op 768p; de volledige 2K-workflow genereert dat resultaat opnieuw met de oorspronkelijke multimodale context. Dat gaat verder dan een gewone formaatvergroting: de tweede fase gebruikt het model en de broncontext opnieuw om fijne details te herstellen. H3 Max en H3-Context-IR hebben afzonderlijke rollen en limieten.

Creatie vanuit tekst en framebeelden

Invoer met alleen tekst beschrijft de volledige audiovisuele tijdlijn. Een eerste afbeelding verankert de opening, een laatste de afsluiting, en twee afbeeldingen kunnen beide vastleggen. Begin bij een shot vanuit een eerste frame met de compositie en identiteit in het stilstaande beeld en beschrijf daarna hoe de actie zich ontwikkelt. Beschrijf bij een overgang van eerste naar laatste frame de waarneembare beweging die beide toestanden verbindt, in plaats van twee losstaande afbeeldingsbeschrijvingen te herhalen.

Een praktische productbriefing kan een gesloten verpakking in het openingsframe vastleggen, de hand die ze opent, een rustige camerabeweging en de te bereiken eindtoestand. Behoud de vorm van het object, de plaatsing van het etiket en de belichting in de aangeleverde frames. Creatie met framebeelden en creatie met referenties zijn afzonderlijke invoermodi; de interface van de maker combineert geen eerste/laatste-framerollen met referentiemediarollen in één aanvraag.

Generatie en bewerking met referenties

De referentiemodus accepteert tekst met afbeeldingen, videoclips en audioclips. Benoem wat elke bron bijdraagt: het uiterlijk van een personage, een locatie, camerabeweging, de tijdsstructuur van een bronclip of een stem. Een video die alleen als camerabewegingsreferentie dient, is iets anders dan een video die daadwerkelijk moet worden bewerkt of voortgezet. Geef dat verband expliciet aan.

De referentiegids van de maker onderscheidt onderwerpdefinities, een taaksamenvatting, een analyse van wat behouden blijft, een gedetailleerde shotbeschrijving, het algemene geluidslandschap en achtergrondmuziek die alleen het publiek hoort. Hij onderscheidt behoud van zichtbare inhoud van de overdracht van kenmerken of een brede stijlreferentie. Bij audio is een signaal kopiëren iets anders dan verwijzen naar timbre, ritme of voordracht. Hou die rollen gedurende de briefing gelijk.

Lever voor een scène met referenties een personageafbeelding, een korte camerabewegingsreferentie en een stemreferentie als audio aan en beschrijf waar elk ervan het doelshot moet beïnvloeden. Geef aan welke details van kleding, omgeving of object herkenbaar moeten blijven. Vergelijk de afgewerkte clip met die vereisten, inclusief bewegingscontinuïteit en het verband tussen de zichtbare spreker en de gehoorde stem.

Spraak, geluid en shottiming

H3 modelleert dialoog, fysieke geluiden, omgevingsgeluid en muziek gezamenlijk. De modelkaart documenteert stabiele dialoogondersteuning voor Arabisch, Chinees, Engels, Frans, Duits, Italiaans, Japans, Koreaans, Portugees, Russisch en Spaans; voor andere talen varieert de ondersteuning volgens de beschrijving. Geef de exacte gesproken woorden en taal op, met een vaste sprekeridentiteit over de shots heen.

De promptgidsen van de maker gebruiken Engels voor beschrijvende onderdelen en behouden dialoog en zichtbare tekst in de oorspronkelijke taal. Gesproken inhoud gebruikt <d>[Language] ...</d>, met sprekeridentiteit en stembeschrijving buiten het blok. Maak onderscheid tussen spraak in de scène en voice-over buiten beeld en geef aan wanneer een zin over een knip heen doorloopt of door het einde wordt afgebroken. Behoud ook zichtbare tekst exact. Stem de hoeveelheid spraak af op de gekozen duur en controleer de weergegeven woorden en hoorbare zin samen.

Beschrijf camerabeweging als een actie, inclusief bereik en snelheid wanneer die relevant zijn. Nummer shots in afspeelvolgorde en hou kniptijden binnen de videoduur. Scheid scènegeluiden zoals voetstappen of een sluitende deur van achtergrondmuziek die alleen het publiek hoort. Zo wordt een kort shotplan gemakkelijker te interpreteren en met het resultaat te vergelijken.

Invoer voorbereiden en numerieke limieten

Het huidige generatieschema vereist in elke modus niet-lege tekst, met maximaal 7.000 tekens per tekstonderdeel. Afbeeldingen mogen JPG, JPEG, PNG, WebP, HEIC of HEIF zijn, maximaal 30 MB elk, met elke zijde van 256 tot 5.760 pixels en een beeldverhouding van 0.4 tot 2.5. Frame-invoer staat één openings- en één eindafbeelding toe; de referentiemodus staat maximaal negen referentiebeelden toe.

Referentievideo kan maximaal drie MP4- of MOV-clips bevatten, elk 2–15 seconden en samen maximaal 15 seconden. Een clip mag maximaal 50 MB zijn; de videocodec is H.264 of H.265, met AAC- of MP3-audio, zijden van 256 tot 5.760 pixels, verhoudingen van 0.4 tot 2.5 en een beeldsnelheid van 23.976 tot 60. Referentieaudio ondersteunt maximaal drie WAV- of MP3-clips, elk maximaal 15 MB en 2–15 seconden, samen maximaal 15 seconden. De modelkaart beperkt gemengde referentie-invoer tot 12 bestanden. De gedocumenteerde limiet voor de aanvraagbody is 64 MB, los van de limieten per bestand.

Kies alleen referenties die bijdragen aan de briefing en maak elke bijdrage expliciet. Een duidelijk zicht op het onderwerp is nuttiger dan meerdere tegenstrijdige beelden zonder uitleg. Behoud de volgorde van referenties, snij irrelevant materiaal weg zonder noodzakelijke scènecontext te verwijderen en controleer of korte bronclips de gevraagde actie of stemkarakteristiek bevatten.

Uitvoerformaat en het volledige systeem

De H3-interface van de fabrikant biedt 768P en 2K. Generatie met alleen tekst vereist een concrete verhouding: 21:9, 16:9, 4:3, 1:1, 3:4 of 9:16. Creatie met eerste/laatste frames neemt de beeldverhouding over van de invoerafbeelding; creatie met referenties kan een adaptieve of expliciete verhouding gebruiken. De uitvoerduur bedraagt 4–15 seconden en wordt in gehele seconden opgegeven.

De modelkaart onderscheidt H3-Context-IR, dat de briefing interpreteert en verrijkt, H3-Base, dat audiovisuele inhoud genereert, en H3-Regenerate-2K, dat het resultaat met hogere resolutie maakt. De vrijgegeven basischeckpoints scheiden taken met framebeelden van taken met omnireferenties. De context- en regeneratiecomponenten staan los van die basisgewichten, dus de naam van een open checkpoint alleen bepaalt niet het gedrag van het volledige systeem.

De generatieworkflow van de maker is asynchroon. De interface voor taakopvraging haalt taken uit de voorgaande zeven dagen op. Bewaar de taak-ID tot het daadwerkelijke videoresultaat terugkomt en bewaar daarna de clip zelf, niet alleen een tijdelijk downloadadres. Beoordeel visuele identiteit, kleine tekst, interacties tussen objecten, gesproken inhoud en geluidstiming op de beoogde kijkgrootte. De fabrikant noemt multimodaal begrip en fijne visuele details als verdere verbeterpunten; een gedetailleerde briefing en vergelijking met de bronnen blijven essentieel voor een bruikbaar resultaat.

", "aboutText": "Eén audiovisueel resultaat uit een multimodale briefing\n\nMiniMax H3 is het omnimodale videosysteem van MiniMax. Het interpreteert tekst, afbeeldingen, video en audio samen en genereert vervolgens video met native stereogeluid. De maker presenteert het voor kort creatief werk zoals productbeelden, reclame, geanimeerde posters en concepten voor filmtitels, waarbij de relaties tussen referentiematerialen even belangrijk zijn als de scènebeschrijving.\n\nHet gedocumenteerde systeem produceert video van 4–15 seconden bij 24 beelden per seconde met 32 kHz-stereo-audio. H3-Base genereert op 768p; de volledige 2K-workflow genereert dat resultaat opnieuw met de oorspronkelijke multimodale context. Dat gaat verder dan een gewone formaatvergroting: de tweede fase gebruikt het model en de broncontext opnieuw om fijne details te herstellen. H3 Max en H3-Context-IR hebben afzonderlijke rollen en limieten.\n\nCreatie vanuit tekst en framebeelden\n\nInvoer met alleen tekst beschrijft de volledige audiovisuele tijdlijn. Een eerste afbeelding verankert de opening, een laatste de afsluiting, en twee afbeeldingen kunnen beide vastleggen. Begin bij een shot vanuit een eerste frame met de compositie en identiteit in het stilstaande beeld en beschrijf daarna hoe de actie zich ontwikkelt. Beschrijf bij een overgang van eerste naar laatste frame de waarneembare beweging die beide toestanden verbindt, in plaats van twee losstaande afbeeldingsbeschrijvingen te herhalen.\n\nEen praktische productbriefing kan een gesloten verpakking in het openingsframe vastleggen, de hand die ze opent, een rustige camerabeweging en de te bereiken eindtoestand. Behoud de vorm van het object, de plaatsing van het etiket en de belichting in de aangeleverde frames. Creatie met framebeelden en creatie met referenties zijn afzonderlijke invoermodi; de interface van de maker combineert geen eerste/laatste-framerollen met referentiemediarollen in één aanvraag.\n\nGeneratie en bewerking met referenties\n\nDe referentiemodus accepteert tekst met afbeeldingen, videoclips en audioclips. Benoem wat elke bron bijdraagt: het uiterlijk van een personage, een locatie, camerabeweging, de tijdsstructuur van een bronclip of een stem. Een video die alleen als camerabewegingsreferentie dient, is iets anders dan een video die daadwerkelijk moet worden bewerkt of voortgezet. Geef dat verband expliciet aan.\n\nDe referentiegids van de maker onderscheidt onderwerpdefinities, een taaksamenvatting, een analyse van wat behouden blijft, een gedetailleerde shotbeschrijving, het algemene geluidslandschap en achtergrondmuziek die alleen het publiek hoort. Hij onderscheidt behoud van zichtbare inhoud van de overdracht van kenmerken of een brede stijlreferentie. Bij audio is een signaal kopiëren iets anders dan verwijzen naar timbre, ritme of voordracht. Hou die rollen gedurende de briefing gelijk.\n\nLever voor een scène met referenties een personageafbeelding, een korte camerabewegingsreferentie en een stemreferentie als audio aan en beschrijf waar elk ervan het doelshot moet beïnvloeden. Geef aan welke details van kleding, omgeving of object herkenbaar moeten blijven. Vergelijk de afgewerkte clip met die vereisten, inclusief bewegingscontinuïteit en het verband tussen de zichtbare spreker en de gehoorde stem.\n\nSpraak, geluid en shottiming\n\nH3 modelleert dialoog, fysieke geluiden, omgevingsgeluid en muziek gezamenlijk. De modelkaart documenteert stabiele dialoogondersteuning voor Arabisch, Chinees, Engels, Frans, Duits, Italiaans, Japans, Koreaans, Portugees, Russisch en Spaans; voor andere talen varieert de ondersteuning volgens de beschrijving. Geef de exacte gesproken woorden en taal op, met een vaste sprekeridentiteit over de shots heen.\n\nDe promptgidsen van de maker gebruiken Engels voor beschrijvende onderdelen en behouden dialoog en zichtbare tekst in de oorspronkelijke taal. Gesproken inhoud gebruikt `[Language] ...`, met sprekeridentiteit en stembeschrijving buiten het blok. Maak onderscheid tussen spraak in de scène en voice-over buiten beeld en geef aan wanneer een zin over een knip heen doorloopt of door het einde wordt afgebroken. Behoud ook zichtbare tekst exact. Stem de hoeveelheid spraak af op de gekozen duur en controleer de weergegeven woorden en hoorbare zin samen.\n\nBeschrijf camerabeweging als een actie, inclusief bereik en snelheid wanneer die relevant zijn. Nummer shots in afspeelvolgorde en hou kniptijden binnen de videoduur. Scheid scènegeluiden zoals voetstappen of een sluitende deur van achtergrondmuziek die alleen het publiek hoort. Zo wordt een kort shotplan gemakkelijker te interpreteren en met het resultaat te vergelijken.\n\nInvoer voorbereiden en numerieke limieten\n\nHet huidige generatieschema vereist in elke modus niet-lege tekst, met maximaal 7.000 tekens per tekstonderdeel. Afbeeldingen mogen JPG, JPEG, PNG, WebP, HEIC of HEIF zijn, maximaal 30 MB elk, met elke zijde van 256 tot 5.760 pixels en een beeldverhouding van 0.4 tot 2.5. Frame-invoer staat één openings- en één eindafbeelding toe; de referentiemodus staat maximaal negen referentiebeelden toe.\n\nReferentievideo kan maximaal drie MP4- of MOV-clips bevatten, elk 2–15 seconden en samen maximaal 15 seconden. Een clip mag maximaal 50 MB zijn; de videocodec is H.264 of H.265, met AAC- of MP3-audio, zijden van 256 tot 5.760 pixels, verhoudingen van 0.4 tot 2.5 en een beeldsnelheid van 23.976 tot 60. Referentieaudio ondersteunt maximaal drie WAV- of MP3-clips, elk maximaal 15 MB en 2–15 seconden, samen maximaal 15 seconden. De modelkaart beperkt gemengde referentie-invoer tot 12 bestanden. De gedocumenteerde limiet voor de aanvraagbody is 64 MB, los van de limieten per bestand.\n\nKies alleen referenties die bijdragen aan de briefing en maak elke bijdrage expliciet. Een duidelijk zicht op het onderwerp is nuttiger dan meerdere tegenstrijdige beelden zonder uitleg. Behoud de volgorde van referenties, snij irrelevant materiaal weg zonder noodzakelijke scènecontext te verwijderen en controleer of korte bronclips de gevraagde actie of stemkarakteristiek bevatten.\n\nUitvoerformaat en het volledige systeem\n\nDe H3-interface van de fabrikant biedt 768P en 2K. Generatie met alleen tekst vereist een concrete verhouding: 21:9, 16:9, 4:3, 1:1, 3:4 of 9:16. Creatie met eerste/laatste frames neemt de beeldverhouding over van de invoerafbeelding; creatie met referenties kan een adaptieve of expliciete verhouding gebruiken. De uitvoerduur bedraagt 4–15 seconden en wordt in gehele seconden opgegeven.\n\nDe modelkaart onderscheidt H3-Context-IR, dat de briefing interpreteert en verrijkt, H3-Base, dat audiovisuele inhoud genereert, en H3-Regenerate-2K, dat het resultaat met hogere resolutie maakt. De vrijgegeven basischeckpoints scheiden taken met framebeelden van taken met omnireferenties. De context- en regeneratiecomponenten staan los van die basisgewichten, dus de naam van een open checkpoint alleen bepaalt niet het gedrag van het volledige systeem.\n\nDe generatieworkflow van de maker is asynchroon. De interface voor taakopvraging haalt taken uit de voorgaande zeven dagen op. Bewaar de taak-ID tot het daadwerkelijke videoresultaat terugkomt en bewaar daarna de clip zelf, niet alleen een tijdelijk downloadadres. Beoordeel visuele identiteit, kleine tekst, interacties tussen objecten, gesproken inhoud en geluidstiming op de beoogde kijkgrootte. De fabrikant noemt multimodaal begrip en fijne visuele details als verdere verbeterpunten; een gedetailleerde briefing en vergelijking met de bronnen blijven essentieel voor een bruikbaar resultaat.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "b2fee4118ecf7b18f17cf7639b45928b786964458c50fff888b3c0237b8dcae1", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl-be", "methods": [ { "html": "
MM

MiniMax: H3

MiniMax /minimax/hailuo-3

Aan de slag

MiniMax H3 genereert korte video met native stereogeluid op basis van tekst, framebeelden of multimodale referenties. Het ondersteunt creatie met eerste/laatste frames, bewerking met referenties en verbanden met beweging of stem, met uitvoer van 4–15 seconden en een afzonderlijke workflow voor 2K-regeneratie.

Toegestane invoer
Tekst · Afbeeldingen · Audio · Video
Resultaten
Video
Over het model

Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.

Eén audiovisueel resultaat uit een multimodale briefing

MiniMax H3 is het omnimodale videosysteem van MiniMax. Het interpreteert tekst, afbeeldingen, video en audio samen en genereert vervolgens video met native stereogeluid. De maker presenteert het voor kort creatief werk zoals productbeelden, reclame, geanimeerde posters en concepten voor filmtitels, waarbij de relaties tussen referentiematerialen even belangrijk zijn als de scènebeschrijving.

Het gedocumenteerde systeem produceert video van 4–15 seconden bij 24 beelden per seconde met 32 kHz-stereo-audio. H3-Base genereert op 768p; de volledige 2K-workflow genereert dat resultaat opnieuw met de oorspronkelijke multimodale context. Dat gaat verder dan een gewone formaatvergroting: de tweede fase gebruikt het model en de broncontext opnieuw om fijne details te herstellen. H3 Max en H3-Context-IR hebben afzonderlijke rollen en limieten.

Creatie vanuit tekst en framebeelden

Invoer met alleen tekst beschrijft de volledige audiovisuele tijdlijn. Een eerste afbeelding verankert de opening, een laatste de afsluiting, en twee afbeeldingen kunnen beide vastleggen. Begin bij een shot vanuit een eerste frame met de compositie en identiteit in het stilstaande beeld en beschrijf daarna hoe de actie zich ontwikkelt. Beschrijf bij een overgang van eerste naar laatste frame de waarneembare beweging die beide toestanden verbindt, in plaats van twee losstaande afbeeldingsbeschrijvingen te herhalen.

Een praktische productbriefing kan een gesloten verpakking in het openingsframe vastleggen, de hand die ze opent, een rustige camerabeweging en de te bereiken eindtoestand. Behoud de vorm van het object, de plaatsing van het etiket en de belichting in de aangeleverde frames. Creatie met framebeelden en creatie met referenties zijn afzonderlijke invoermodi; de interface van de maker combineert geen eerste/laatste-framerollen met referentiemediarollen in één aanvraag.

Generatie en bewerking met referenties

De referentiemodus accepteert tekst met afbeeldingen, videoclips en audioclips. Benoem wat elke bron bijdraagt: het uiterlijk van een personage, een locatie, camerabeweging, de tijdsstructuur van een bronclip of een stem. Een video die alleen als camerabewegingsreferentie dient, is iets anders dan een video die daadwerkelijk moet worden bewerkt of voortgezet. Geef dat verband expliciet aan.

De referentiegids van de maker onderscheidt onderwerpdefinities, een taaksamenvatting, een analyse van wat behouden blijft, een gedetailleerde shotbeschrijving, het algemene geluidslandschap en achtergrondmuziek die alleen het publiek hoort. Hij onderscheidt behoud van zichtbare inhoud van de overdracht van kenmerken of een brede stijlreferentie. Bij audio is een signaal kopiëren iets anders dan verwijzen naar timbre, ritme of voordracht. Hou die rollen gedurende de briefing gelijk.

Lever voor een scène met referenties een personageafbeelding, een korte camerabewegingsreferentie en een stemreferentie als audio aan en beschrijf waar elk ervan het doelshot moet beïnvloeden. Geef aan welke details van kleding, omgeving of object herkenbaar moeten blijven. Vergelijk de afgewerkte clip met die vereisten, inclusief bewegingscontinuïteit en het verband tussen de zichtbare spreker en de gehoorde stem.

Spraak, geluid en shottiming

H3 modelleert dialoog, fysieke geluiden, omgevingsgeluid en muziek gezamenlijk. De modelkaart documenteert stabiele dialoogondersteuning voor Arabisch, Chinees, Engels, Frans, Duits, Italiaans, Japans, Koreaans, Portugees, Russisch en Spaans; voor andere talen varieert de ondersteuning volgens de beschrijving. Geef de exacte gesproken woorden en taal op, met een vaste sprekeridentiteit over de shots heen.

De promptgidsen van de maker gebruiken Engels voor beschrijvende onderdelen en behouden dialoog en zichtbare tekst in de oorspronkelijke taal. Gesproken inhoud gebruikt <d>[Language] ...</d>, met sprekeridentiteit en stembeschrijving buiten het blok. Maak onderscheid tussen spraak in de scène en voice-over buiten beeld en geef aan wanneer een zin over een knip heen doorloopt of door het einde wordt afgebroken. Behoud ook zichtbare tekst exact. Stem de hoeveelheid spraak af op de gekozen duur en controleer de weergegeven woorden en hoorbare zin samen.

Beschrijf camerabeweging als een actie, inclusief bereik en snelheid wanneer die relevant zijn. Nummer shots in afspeelvolgorde en hou kniptijden binnen de videoduur. Scheid scènegeluiden zoals voetstappen of een sluitende deur van achtergrondmuziek die alleen het publiek hoort. Zo wordt een kort shotplan gemakkelijker te interpreteren en met het resultaat te vergelijken.

Invoer voorbereiden en numerieke limieten

Het huidige generatieschema vereist in elke modus niet-lege tekst, met maximaal 7.000 tekens per tekstonderdeel. Afbeeldingen mogen JPG, JPEG, PNG, WebP, HEIC of HEIF zijn, maximaal 30 MB elk, met elke zijde van 256 tot 5.760 pixels en een beeldverhouding van 0.4 tot 2.5. Frame-invoer staat één openings- en één eindafbeelding toe; de referentiemodus staat maximaal negen referentiebeelden toe.

Referentievideo kan maximaal drie MP4- of MOV-clips bevatten, elk 2–15 seconden en samen maximaal 15 seconden. Een clip mag maximaal 50 MB zijn; de videocodec is H.264 of H.265, met AAC- of MP3-audio, zijden van 256 tot 5.760 pixels, verhoudingen van 0.4 tot 2.5 en een beeldsnelheid van 23.976 tot 60. Referentieaudio ondersteunt maximaal drie WAV- of MP3-clips, elk maximaal 15 MB en 2–15 seconden, samen maximaal 15 seconden. De modelkaart beperkt gemengde referentie-invoer tot 12 bestanden. De gedocumenteerde limiet voor de aanvraagbody is 64 MB, los van de limieten per bestand.

Kies alleen referenties die bijdragen aan de briefing en maak elke bijdrage expliciet. Een duidelijk zicht op het onderwerp is nuttiger dan meerdere tegenstrijdige beelden zonder uitleg. Behoud de volgorde van referenties, snij irrelevant materiaal weg zonder noodzakelijke scènecontext te verwijderen en controleer of korte bronclips de gevraagde actie of stemkarakteristiek bevatten.

Uitvoerformaat en het volledige systeem

De H3-interface van de fabrikant biedt 768P en 2K. Generatie met alleen tekst vereist een concrete verhouding: 21:9, 16:9, 4:3, 1:1, 3:4 of 9:16. Creatie met eerste/laatste frames neemt de beeldverhouding over van de invoerafbeelding; creatie met referenties kan een adaptieve of expliciete verhouding gebruiken. De uitvoerduur bedraagt 4–15 seconden en wordt in gehele seconden opgegeven.

De modelkaart onderscheidt H3-Context-IR, dat de briefing interpreteert en verrijkt, H3-Base, dat audiovisuele inhoud genereert, en H3-Regenerate-2K, dat het resultaat met hogere resolutie maakt. De vrijgegeven basischeckpoints scheiden taken met framebeelden van taken met omnireferenties. De context- en regeneratiecomponenten staan los van die basisgewichten, dus de naam van een open checkpoint alleen bepaalt niet het gedrag van het volledige systeem.

De generatieworkflow van de maker is asynchroon. De interface voor taakopvraging haalt taken uit de voorgaande zeven dagen op. Bewaar de taak-ID tot het daadwerkelijke videoresultaat terugkomt en bewaar daarna de clip zelf, niet alleen een tijdelijk downloadadres. Beoordeel visuele identiteit, kleine tekst, interacties tussen objecten, gesproken inhoud en geluidstiming op de beoogde kijkgrootte. De fabrikant noemt multimodaal begrip en fijne visuele details als verdere verbeterpunten; een gedetailleerde briefing en vergelijking met de bronnen blijven essentieel voor een bruikbaar resultaat.

Beschikbaar in Ailoot · invoer en methoden

Ailoot Ultra · Video POST /v1/videos
Invoer
text, image, audio, video
Uitvoer
video
Uitvoerformaat
oorspronkelijke MP4-bytes; geen normalisatie of transcodering
VeldTypeVereisteWaarden en limietenStandaard
VeldmodelTypestringVereisteVereistWaarden en limieten
minimax/hailuo-3
Standaard—
VeldpromptTypestringVereisteVereistWaarden en limietenStandaard—
VelddurationTypeintegerVereisteVereistWaarden en limieten
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maximum: 600
Standaard—
VeldresolutionTypestringVereisteOptioneelWaarden en limieten
2K
Standaard—
Veldaspect_ratioTypestringVereisteOptioneelWaarden en limieten
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Standaard—
Veldgenerate_audioTypebooleanVereisteOptioneelWaarden en limieten
false, true
Standaard—
Veldframe_imagesTypearrayVereisteOptioneelWaarden en limieten
Minimumaantal items: 1
Maximumaantal items: 2
Invoerinhoud: Array met frameobjecten. Elk object bevat type=image_url, image_url met daarin url, en frame_type. Gebruik een HTTPS-afbeeldings-URL en stel frame_type in op first_frame of last_frame. Elke framerol komt hoogstens één keer voor.
Exacte sleutels: type, image_url, frame_type
Voorwaarden: Deze sleutels beschrijven elk frameobject; image_url bevat alleen url. Laat frame_images weg bij een aanvraag met uitsluitend tekst.
Standaard—
Veldinput_referencesTypearrayVereisteOptioneelWaarden en limietenStandaard—
Veldcallback_urlTypestringVereisteOptioneelWaarden en limieten
Patroon: ^https://
Standaard—
Veldsession_idTypestringVereisteOptioneelWaarden en limietenStandaard—
VeldtraceTypeobjectVereisteOptioneelWaarden en limietenStandaard—
VelduserTypestringVereisteOptioneelWaarden en limietenStandaard—
Combinaties van invoermaterialen

Tekst naar video · Een geschreven prompt. · Vereist: model, prompt, duration

Geef prompt op als tekst en duration als een geheel aantal seconden. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.

model: Type: string · minimax/hailuo-3

prompt: Type: string · Maximumaantal UTF-8-bytes: 10.000 · Ten minste één teken anders dan witruimte vereist: Ja

Afbeelding naar video · Een geschreven prompt en een afbeelding voor het eerste frame. · Vereist: model, prompt, duration, frame_images

frame_images is een array. Elk frameobject bevat type, image_url en frame_type; image_url bevat url. Stel type in op image_url. Gebruik first_frame met een optionele last_frame. Elke framerol komt hoogstens één keer voor. Geef voor elk frame een openbare HTTPS-afbeeldings-URL op. Gebruik in één aanvraag frameafbeeldingen of referentieafbeeldingen; combineer beide niet. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.

Exacte sleutels: type, image_url, frame_type

model: Type: string · minimax/hailuo-3

prompt: Type: string · Maximumaantal UTF-8-bytes: 10.000 · Ten minste één teken anders dan witruimte vereist: Ja

Reference to video · Een geschreven prompt en ondersteunde referenties in de vorm van afbeeldingen, video of audio. · Vereist: model, prompt, duration, input_references

input_references is een array met objecten. Stel type in op image_url, video_url of audio_url en gebruik het overeenkomstige veld dat url bevat. Gebruik openbare HTTPS-URL's. Laat frame_images weg om de referentiemodus te selecteren. De schatting omvat de getoonde component per afbeelding uitsluitend voor referentieafbeeldingen na de eerste vijf. De uiteindelijke aanrekening volgt de werkelijk aangerekende configuratie. Combineer geen referentieafbeeldingen met frameafbeeldingen. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.

model: Type: string · minimax/hailuo-3

prompt: Type: string · Maximumaantal UTF-8-bytes: 10.000 · Ten minste één teken anders dan witruimte vereist: Ja

Methodeparameters en levenscyclus
ParameterContract
Parametercontent_typeContractapplication/json
ParameterrequiredContractmodel, prompt, duration
Parametermaterial_typesContracttext, image, audio, video
Parameteradditional_propertiesContractfalse
Parameteroptional_controlsContractresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user

Levenscyclus: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Tarieven

Zo worden de uiteindelijke kosten berekend

De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.

Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.

Snelle modus
Niet opgegeven Wanneer de snelle modus geselecteerd is
Flex-modus
Niet opgegeven Wanneer de flex-modus geselecteerd is
Maximale redeneerinspanning
Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt

Geschatte tarieven ter vergelijking

Prijzen per configuratie

Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.

ConfiguratieTariefstaffelVerwachte hoeveelheidRekeneenheidFactureringsvoorwaardenKosten
ConfiguratieBasistarieven voor tokensTariefstaffelBasistariefVerwachte hoeveelheid—Rekeneenheid—Factureringsvoorwaarden—Kosten
Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens
Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens
Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens
Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens
Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens
ConfiguratieVideoprijsTariefstaffel—Verwachte hoeveelheid—Rekeneenheidper videosecondeFactureringsvoorwaardenIn deze prijssleutel is geen bijkomende voorwaarde opgegeven.Kosten
Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.26 per videoseconde
ConfiguratiereferentieafbeeldingTariefstaffel—Verwachte hoeveelheid—Rekeneenheidper referentieafbeeldingFactureringsvoorwaarden—Kosten
Invoer · referentieafbeelding · Schatting uitsluitend ter vergelijking $0.08 per referentieafbeelding
ConfiguratieGeschatte generatiekostenTariefstaffel—Verwachte hoeveelheidschatting voor één generatieRekeneenheid—Factureringsvoorwaarden—Kosten
Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $1.3 schatting vóór generatie

Deze raming is geen extra kost of vast tarief voor de voltooide generatie.

Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →

Details van het referentietarief

Referentiestaffels op modelniveau veranderen de methodeselectie, kostenramingen of afschrijvingen niet. Voor de actieve kostenberekening gelden de tarieven van de geselecteerde Ailoot-methode.

Prijsreferenties voor videoconfiguraties

Prijzen per configuratie

Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.

ConfiguratieFactureringsvoorwaardenKosten
ConfiguratieVideoprijsFactureringsvoorwaardenIn deze prijssleutel is geen bijkomende voorwaarde opgegeven.Kosten
Uitvoer · Videoprijs $0.26 per videoseconde

Gepubliceerde prijsreferentie voor de getoonde configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie.

ConfiguratieReferentieafbeeldingen na de eerste vijfFactureringsvoorwaardenIn deze prijssleutel is geen bijkomende voorwaarde opgegeven.Kosten
Invoer · Referentieafbeeldingen na de eerste vijf $0.08 per afbeelding

De eerste vijf referentieafbeeldingen zijn gratis; het vermelde tarief per afbeelding geldt na de eerste vijf. Gepubliceerde prijsreferentie voor de getoonde configuratie. De uiteindelijke aanrekening volgt de werkelijk aangerekende configuratie.

Voorbeeldverzoeken

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","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', 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

Resultaten ophalen en opslaan

Ailoot Ultra · Video

ondertekende inhouds-URL's die je toebehoren

Taakstatus controleren
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
Lezen van andere inhoud
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 voltooide resultaten bewaren

Sla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.

Bewaar alle werkelijke uitvoer die je toebehoort en de teruggestuurde meetgegevens.

Als het oorspronkelijke antwoord moet worden gecontroleerd

503 result_pending_check + oorspronkelijke id + X-Should-Retry:false; voer de oorspronkelijke aanvraag nooit opnieuw uit

Antwoordvelden
VeldTypeBetekenis
VeldindexTypeintegerBetekenisPositie van deze video in de uitvoerlijst, geteld vanaf nul.
Veldcontent_urlTypestringBetekenisOndertekende HTTPS-download-URL voor deze voltooide video.
Veldsha256Typestring | nullBetekenisSHA-256-hash van de oorspronkelijke videobytes; null als die niet beschikbaar is.
Veldsize_bytesTypeinteger | nullBetekenisGrootte van het oorspronkelijke videobestand in bytes; null als die niet beschikbaar is.
Veldduration_msTypeinteger | nullBetekenisGemeten videoduur in milliseconden; null als die niet beschikbaar is.
VeldwidthTypeinteger | nullBetekenisVideobreedte in pixels; null als die niet beschikbaar is.
VeldheightTypeinteger | nullBetekenisVideohoogte in pixels; null als die niet beschikbaar is.
Veldvideo_codecTypestring | nullBetekenisIdentificatiecode van de videocodec; null als die niet is vastgelegd.
Veldhas_audioTypeboolean | nullBetekenisOf de video een audiotrack bevat; null als dit niet is gemeten.
Veldaudio_codecTypestring | nullBetekenisIdentificatiecode van de audiocodec; null als er geen identificatiecode is vastgelegd.
Fouten en vervolgstappen
AntwoordVoorwaardeVolgende stap
Antwoord404 · not_found_errorVoorwaardeToegang tot de video is niet beschikbaar, of deze video-ID werd niet gevonden.Volgende stapControleer de toegang tot de video. Gebruik voor een bestaande video de oorspronkelijke openbare ID en dezelfde API-sleutel.
Antwoord401 · authentication_errorVoorwaardeDe API-sleutel komt niet overeen met het geauthenticeerde account.Volgende stapControleer je API-sleutel en accounttoegang voordat je de aanvraag indient.
Antwoord400 · invalid_request_errorVoorwaardeDe aanvraag kon niet worden gelezen, of de downloadindex is ongeldig.Volgende stapCorrigeer de aanvraaginhoud. Kies voor een download een uitvoerindex die door de oorspronkelijke taak is teruggestuurd.
Antwoord422 · price_unavailableVoorwaardeVoor de geselecteerde videoconfiguratie kan geen prijs worden bepaald.Volgende stapKies een ondersteunde videoconfiguratie en vul alle verplichte opties in voordat je een gecorrigeerde aanvraag indient.
Antwoord422 · invalid_request_errorVoorwaardeEen video-invoer of oorspronkelijke vervolgtaak is ongeldig.Volgende stapGebruik geldige HTTPS-invoer. Gebruik voor een vervolg je voltooide oorspronkelijke openbare video-ID met dezelfde API-sleutel.
Antwoord402 · billing_errorVoorwaardeHet beschikbare saldo of de limieten laten geen reservering toe.Volgende stapControleer je beschikbare saldo en limieten voordat je een nieuwe aanvraag verstuurt.
Antwoord503 · server_errorVoorwaardeVideocontrole, opslag of toegang tot de dienst is tijdelijk niet beschikbaar.Volgende stapWacht tot de dienst beschikbaar is. Als je al een video-ID hebt, controleer dan die oorspronkelijke taak in plaats van een nieuwe generatie aan te maken.
Antwoord503 · result_pending_checkVoorwaardeHet oorspronkelijke videoresultaat en de aanrekening moeten worden gecontroleerd.Volgende stapBewaar de teruggestuurde video-ID en controleer die taak. Verstuur geen vervangende generatieaanvraag zolang de controle loopt.
Antwoord503 · owned_result_unavailableVoorwaardeDe bestaande videodownload is tijdelijk niet beschikbaar.Volgende stapControleer later dezelfde videotaak en download de bestaande uitvoer ervan. Een nieuwe generatie maakt een afzonderlijke operatie aan.
Antwoord409 · video_not_readyVoorwaardeDe video-inhoud is niet gepubliceerd.Volgende stapControleer de oorspronkelijke taakstatus. Download zodra de status completed is; volg bij failed de melding over de controle van de aanrekening.

Aliasnamen

Modelaliasnamen

Ailoot Ultra minimax/hailuo-3

Aliasnamen voor methodepaden

Gebruik de hierboven getoonde methodepaden.

Gerelateerde aanroeper-ID’s

minimax/hailuo-3

", "method_identity": { "effective_request_model_id": "minimax/hailuo-3", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "minimax/hailuo-3", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|minimax%2Fhailuo-3", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.", "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": "Bewaar alle werkelijke uitvoer die je toebehoort en de teruggestuurde meetgegevens.", "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": "Toegang tot de video is niet beschikbaar, of deze video-ID werd niet gevonden.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Controleer de toegang tot de video. Gebruik voor een bestaande video de oorspronkelijke openbare ID en dezelfde API-sleutel.", "type": "not_found_error" }, { "condition": "De API-sleutel komt niet overeen met het geauthenticeerde account.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Controleer je API-sleutel en accounttoegang voordat je de aanvraag indient.", "type": "authentication_error" }, { "condition": "De aanvraag kon niet worden gelezen, of de downloadindex is ongeldig.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrigeer de aanvraaginhoud. Kies voor een download een uitvoerindex die door de oorspronkelijke taak is teruggestuurd.", "type": "invalid_request_error" }, { "condition": "Voor de geselecteerde videoconfiguratie kan geen prijs worden bepaald.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Kies een ondersteunde videoconfiguratie en vul alle verplichte opties in voordat je een gecorrigeerde aanvraag indient.", "type": "price_unavailable" }, { "condition": "Een video-invoer of oorspronkelijke vervolgtaak is ongeldig.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Gebruik geldige HTTPS-invoer. Gebruik voor een vervolg je voltooide oorspronkelijke openbare video-ID met dezelfde API-sleutel.", "type": "invalid_request_error" }, { "condition": "Het beschikbare saldo of de limieten laten geen reservering toe.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Controleer je beschikbare saldo en limieten voordat je een nieuwe aanvraag verstuurt.", "type": "billing_error" }, { "condition": "Videocontrole, opslag of toegang tot de dienst is tijdelijk niet beschikbaar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Wacht tot de dienst beschikbaar is. Als je al een video-ID hebt, controleer dan die oorspronkelijke taak in plaats van een nieuwe generatie aan te maken.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Het oorspronkelijke videoresultaat en de aanrekening moeten worden gecontroleerd.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Bewaar de teruggestuurde video-ID en controleer die taak. Verstuur geen vervangende generatieaanvraag zolang de controle loopt.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "De bestaande videodownload is tijdelijk niet beschikbaar.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Controleer later dezelfde videotaak en download de bestaande uitvoer ervan. Een nieuwe generatie maakt een afzonderlijke operatie aan.", "type": "server_error" }, { "condition": "De video-inhoud is niet gepubliceerd.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Controleer de oorspronkelijke taakstatus. Download zodra de status completed is; volg bij failed de melding over de controle van de aanrekening.", "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 + oorspronkelijke id + X-Should-Retry:false; voer de oorspronkelijke aanvraag nooit opnieuw uit" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Geef prompt op als tekst en duration als een geheel aantal seconden. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.", "required": [ "model", "prompt", "duration" ], "required_material": "Een geschreven prompt." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images is een array. Elk frameobject bevat type, image_url en frame_type; image_url bevat url. Stel type in op image_url. Gebruik first_frame met een optionele last_frame. Elke framerol komt hoogstens één keer voor. Geef voor elk frame een openbare HTTPS-afbeeldings-URL op. Gebruik in één aanvraag frameafbeeldingen of referentieafbeeldingen; combineer beide niet. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Een geschreven prompt en een afbeelding voor het eerste frame." }, { "mode": "Reference to video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references is een array met objecten. Stel type in op image_url, video_url of audio_url en gebruik het overeenkomstige veld dat url bevat. Gebruik openbare HTTPS-URL's. Laat frame_images weg om de referentiemodus te selecteren. De schatting omvat de getoonde component per afbeelding uitsluitend voor referentieafbeeldingen na de eerste vijf. De uiteindelijke aanrekening volgt de werkelijk aangerekende configuratie. Combineer geen referentieafbeeldingen met frameafbeeldingen. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Een geschreven prompt en ondersteunde referenties in de vorm van afbeeldingen, video of audio." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Positie van deze video in de uitvoerlijst, geteld vanaf nul.", "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": "Ondertekende HTTPS-download-URL voor deze voltooide 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-hash van de oorspronkelijke videobytes; null als die niet beschikbaar is.", "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": "Grootte van het oorspronkelijke videobestand in bytes; null als die niet beschikbaar is.", "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": "Gemeten videoduur in milliseconden; null als die niet beschikbaar is.", "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": "Videobreedte in pixels; null als die niet beschikbaar is.", "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": "Videohoogte in pixels; null als die niet beschikbaar is.", "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": "Identificatiecode van de videocodec; null als die niet is vastgelegd.", "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": "Of de video een audiotrack bevat; null als dit niet is gemeten.", "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": "Identificatiecode van de audiocodec; null als er geen identificatiecode is vastgelegd.", "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": "ondertekende inhouds-URL's die je toebehoren", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3" }, "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": [ "2K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "2K" ] }, "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, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Deze sleutels beschrijven elk frameobject; image_url bevat alleen url. Laat frame_images weg bij een aanvraag met uitsluitend tekst.", "content": "Array met frameobjecten. Elk object bevat type=image_url, image_url met daarin url, en frame_type. Gebruik een HTTPS-afbeeldings-URL en stel frame_type in op first_frame of last_frame. Elke framerol komt hoogstens één keer voor.", "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, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "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" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_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" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_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": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "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, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "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" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_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" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_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": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "minimax/hailuo-3" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "2K" ] }, "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.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio", "video" ], "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", "reference_to_video" ], "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": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "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": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "Deze raming is geen extra kost of vast tarief voor de voltooide generatie.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Geschatte generatiekosten", "units": [ { "amount": "1.3", "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": "1.3", "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\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"2K\"}', 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", "audio", "video" ], "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": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "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": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "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": "1.3", "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": "1.3", "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", "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.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "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.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" }, { "amount": "1.3", "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": "1.3", "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", "nativeProvenance": { "input_facts_canonical_sha256": "3199b2e9e50738cf2f6a0ac2d92272737dad7e803198284a5e5e69932f064d81", "input_html_sha256": "7f35640982abda05b2a07f4910676e578530fd2a3c1b39f3b986955047db6b6d", "private_audit_sha256": "2800e3895cec262421c24b671a079b67c22ef7115bcd8cff827982cabd3081e6", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/nl-be/minimax-hailuo-3/", "description": "MiniMax H3 genereert korte video met native stereogeluid op basis van tekst, framebeelden of multimodale referenties. Het ondersteunt creatie met eerste/laatste frames, bewerking met referenties en verbanden met beweging of stem, met uitvoer van 4–15 seconden en een afzonderlijke workflow voor 2K-regeneratie.", "locale": "nl-be", "md_url": "https://ailoot.ai/models/nl-be/minimax-hailuo-3/index.md", "title": "MiniMax: H3 — Ailoot", "url": "https://ailoot.ai/models/nl-be/minimax-hailuo-3/" }, "rawModel": { "about": "Eén audiovisueel resultaat uit een multimodale briefing\n\nMiniMax H3 is het omnimodale videosysteem van MiniMax. Het interpreteert tekst, afbeeldingen, video en audio samen en genereert vervolgens video met native stereogeluid. De maker presenteert het voor kort creatief werk zoals productbeelden, reclame, geanimeerde posters en concepten voor filmtitels, waarbij de relaties tussen referentiematerialen even belangrijk zijn als de scènebeschrijving.\n\nHet gedocumenteerde systeem produceert video van 4–15 seconden bij 24 beelden per seconde met 32 kHz-stereo-audio. H3-Base genereert op 768p; de volledige 2K-workflow genereert dat resultaat opnieuw met de oorspronkelijke multimodale context. Dat gaat verder dan een gewone formaatvergroting: de tweede fase gebruikt het model en de broncontext opnieuw om fijne details te herstellen. H3 Max en H3-Context-IR hebben afzonderlijke rollen en limieten.\n\nCreatie vanuit tekst en framebeelden\n\nInvoer met alleen tekst beschrijft de volledige audiovisuele tijdlijn. Een eerste afbeelding verankert de opening, een laatste de afsluiting, en twee afbeeldingen kunnen beide vastleggen. Begin bij een shot vanuit een eerste frame met de compositie en identiteit in het stilstaande beeld en beschrijf daarna hoe de actie zich ontwikkelt. Beschrijf bij een overgang van eerste naar laatste frame de waarneembare beweging die beide toestanden verbindt, in plaats van twee losstaande afbeeldingsbeschrijvingen te herhalen.\n\nEen praktische productbriefing kan een gesloten verpakking in het openingsframe vastleggen, de hand die ze opent, een rustige camerabeweging en de te bereiken eindtoestand. Behoud de vorm van het object, de plaatsing van het etiket en de belichting in de aangeleverde frames. Creatie met framebeelden en creatie met referenties zijn afzonderlijke invoermodi; de interface van de maker combineert geen eerste/laatste-framerollen met referentiemediarollen in één aanvraag.\n\nGeneratie en bewerking met referenties\n\nDe referentiemodus accepteert tekst met afbeeldingen, videoclips en audioclips. Benoem wat elke bron bijdraagt: het uiterlijk van een personage, een locatie, camerabeweging, de tijdsstructuur van een bronclip of een stem. Een video die alleen als camerabewegingsreferentie dient, is iets anders dan een video die daadwerkelijk moet worden bewerkt of voortgezet. Geef dat verband expliciet aan.\n\nDe referentiegids van de maker onderscheidt onderwerpdefinities, een taaksamenvatting, een analyse van wat behouden blijft, een gedetailleerde shotbeschrijving, het algemene geluidslandschap en achtergrondmuziek die alleen het publiek hoort. Hij onderscheidt behoud van zichtbare inhoud van de overdracht van kenmerken of een brede stijlreferentie. Bij audio is een signaal kopiëren iets anders dan verwijzen naar timbre, ritme of voordracht. Hou die rollen gedurende de briefing gelijk.\n\nLever voor een scène met referenties een personageafbeelding, een korte camerabewegingsreferentie en een stemreferentie als audio aan en beschrijf waar elk ervan het doelshot moet beïnvloeden. Geef aan welke details van kleding, omgeving of object herkenbaar moeten blijven. Vergelijk de afgewerkte clip met die vereisten, inclusief bewegingscontinuïteit en het verband tussen de zichtbare spreker en de gehoorde stem.\n\nSpraak, geluid en shottiming\n\nH3 modelleert dialoog, fysieke geluiden, omgevingsgeluid en muziek gezamenlijk. De modelkaart documenteert stabiele dialoogondersteuning voor Arabisch, Chinees, Engels, Frans, Duits, Italiaans, Japans, Koreaans, Portugees, Russisch en Spaans; voor andere talen varieert de ondersteuning volgens de beschrijving. Geef de exacte gesproken woorden en taal op, met een vaste sprekeridentiteit over de shots heen.\n\nDe promptgidsen van de maker gebruiken Engels voor beschrijvende onderdelen en behouden dialoog en zichtbare tekst in de oorspronkelijke taal. Gesproken inhoud gebruikt `[Language] ...`, met sprekeridentiteit en stembeschrijving buiten het blok. Maak onderscheid tussen spraak in de scène en voice-over buiten beeld en geef aan wanneer een zin over een knip heen doorloopt of door het einde wordt afgebroken. Behoud ook zichtbare tekst exact. Stem de hoeveelheid spraak af op de gekozen duur en controleer de weergegeven woorden en hoorbare zin samen.\n\nBeschrijf camerabeweging als een actie, inclusief bereik en snelheid wanneer die relevant zijn. Nummer shots in afspeelvolgorde en hou kniptijden binnen de videoduur. Scheid scènegeluiden zoals voetstappen of een sluitende deur van achtergrondmuziek die alleen het publiek hoort. Zo wordt een kort shotplan gemakkelijker te interpreteren en met het resultaat te vergelijken.\n\nInvoer voorbereiden en numerieke limieten\n\nHet huidige generatieschema vereist in elke modus niet-lege tekst, met maximaal 7.000 tekens per tekstonderdeel. Afbeeldingen mogen JPG, JPEG, PNG, WebP, HEIC of HEIF zijn, maximaal 30 MB elk, met elke zijde van 256 tot 5.760 pixels en een beeldverhouding van 0.4 tot 2.5. Frame-invoer staat één openings- en één eindafbeelding toe; de referentiemodus staat maximaal negen referentiebeelden toe.\n\nReferentievideo kan maximaal drie MP4- of MOV-clips bevatten, elk 2–15 seconden en samen maximaal 15 seconden. Een clip mag maximaal 50 MB zijn; de videocodec is H.264 of H.265, met AAC- of MP3-audio, zijden van 256 tot 5.760 pixels, verhoudingen van 0.4 tot 2.5 en een beeldsnelheid van 23.976 tot 60. Referentieaudio ondersteunt maximaal drie WAV- of MP3-clips, elk maximaal 15 MB en 2–15 seconden, samen maximaal 15 seconden. De modelkaart beperkt gemengde referentie-invoer tot 12 bestanden. De gedocumenteerde limiet voor de aanvraagbody is 64 MB, los van de limieten per bestand.\n\nKies alleen referenties die bijdragen aan de briefing en maak elke bijdrage expliciet. Een duidelijk zicht op het onderwerp is nuttiger dan meerdere tegenstrijdige beelden zonder uitleg. Behoud de volgorde van referenties, snij irrelevant materiaal weg zonder noodzakelijke scènecontext te verwijderen en controleer of korte bronclips de gevraagde actie of stemkarakteristiek bevatten.\n\nUitvoerformaat en het volledige systeem\n\nDe H3-interface van de fabrikant biedt 768P en 2K. Generatie met alleen tekst vereist een concrete verhouding: 21:9, 16:9, 4:3, 1:1, 3:4 of 9:16. Creatie met eerste/laatste frames neemt de beeldverhouding over van de invoerafbeelding; creatie met referenties kan een adaptieve of expliciete verhouding gebruiken. De uitvoerduur bedraagt 4–15 seconden en wordt in gehele seconden opgegeven.\n\nDe modelkaart onderscheidt H3-Context-IR, dat de briefing interpreteert en verrijkt, H3-Base, dat audiovisuele inhoud genereert, en H3-Regenerate-2K, dat het resultaat met hogere resolutie maakt. De vrijgegeven basischeckpoints scheiden taken met framebeelden van taken met omnireferenties. De context- en regeneratiecomponenten staan los van die basisgewichten, dus de naam van een open checkpoint alleen bepaalt niet het gedrag van het volledige systeem.\n\nDe generatieworkflow van de maker is asynchroon. De interface voor taakopvraging haalt taken uit de voorgaande zeven dagen op. Bewaar de taak-ID tot het daadwerkelijke videoresultaat terugkomt en bewaar daarna de clip zelf, niet alleen een tijdelijk downloadadres. Beoordeel visuele identiteit, kleine tekst, interacties tussen objecten, gesproken inhoud en geluidstiming op de beoogde kijkgrootte. De fabrikant noemt multimodaal begrip en fijne visuele details als verdere verbeterpunten; een gedetailleerde briefing en vergelijking met de bronnen blijven essentieel voor een bruikbaar resultaat.", "alias_of": null, "aliases": [], "author": "MiniMax", "available": null, "canonical_model": "minimax/hailuo-3", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "1.3", "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": "1.3", "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": "De volledige prijsinformatie voor de configuratie vindt u bij de details." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "ffcc346d33bca9e66b22f181", "label": "Prijsreferenties voor videoconfiguraties", "profiles": [ { "basis": "Gepubliceerde prijsreferentie voor de getoonde configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie.", "dimensions": { "conditions": "In deze prijssleutel is geen bijkomende voorwaarde opgegeven." }, "label": "Videoprijs", "units": [ { "amount": "0.26", "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": "De eerste vijf referentieafbeeldingen zijn gratis; het vermelde tarief per afbeelding geldt na de eerste vijf. Gepubliceerde prijsreferentie voor de getoonde configuratie. De uiteindelijke aanrekening volgt de werkelijk aangerekende configuratie.", "dimensions": { "conditions": "In deze prijssleutel is geen bijkomende voorwaarde opgegeven." }, "label": "Referentieafbeeldingen na de eerste vijf", "units": [ { "amount": "0.08", "amount_unit": "usd_per_image", "billing_input": false, "key": "input_image", "label": "Reference images after the first five", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_video_image_reference", "side": "in", "unit": "image" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "minimax/hailuo-3", "input": [ "text", "image", "audio", "video" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.", "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": "Bewaar alle werkelijke uitvoer die je toebehoort en de teruggestuurde meetgegevens.", "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": "Toegang tot de video is niet beschikbaar, of deze video-ID werd niet gevonden.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Controleer de toegang tot de video. Gebruik voor een bestaande video de oorspronkelijke openbare ID en dezelfde API-sleutel.", "type": "not_found_error" }, { "condition": "De API-sleutel komt niet overeen met het geauthenticeerde account.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Controleer je API-sleutel en accounttoegang voordat je de aanvraag indient.", "type": "authentication_error" }, { "condition": "De aanvraag kon niet worden gelezen, of de downloadindex is ongeldig.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrigeer de aanvraaginhoud. Kies voor een download een uitvoerindex die door de oorspronkelijke taak is teruggestuurd.", "type": "invalid_request_error" }, { "condition": "Voor de geselecteerde videoconfiguratie kan geen prijs worden bepaald.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Kies een ondersteunde videoconfiguratie en vul alle verplichte opties in voordat je een gecorrigeerde aanvraag indient.", "type": "price_unavailable" }, { "condition": "Een video-invoer of oorspronkelijke vervolgtaak is ongeldig.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Gebruik geldige HTTPS-invoer. Gebruik voor een vervolg je voltooide oorspronkelijke openbare video-ID met dezelfde API-sleutel.", "type": "invalid_request_error" }, { "condition": "Het beschikbare saldo of de limieten laten geen reservering toe.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Controleer je beschikbare saldo en limieten voordat je een nieuwe aanvraag verstuurt.", "type": "billing_error" }, { "condition": "Videocontrole, opslag of toegang tot de dienst is tijdelijk niet beschikbaar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Wacht tot de dienst beschikbaar is. Als je al een video-ID hebt, controleer dan die oorspronkelijke taak in plaats van een nieuwe generatie aan te maken.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Het oorspronkelijke videoresultaat en de aanrekening moeten worden gecontroleerd.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Bewaar de teruggestuurde video-ID en controleer die taak. Verstuur geen vervangende generatieaanvraag zolang de controle loopt.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "De bestaande videodownload is tijdelijk niet beschikbaar.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Controleer later dezelfde videotaak en download de bestaande uitvoer ervan. Een nieuwe generatie maakt een afzonderlijke operatie aan.", "type": "server_error" }, { "condition": "De video-inhoud is niet gepubliceerd.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Controleer de oorspronkelijke taakstatus. Download zodra de status completed is; volg bij failed de melding over de controle van de aanrekening.", "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 + oorspronkelijke id + X-Should-Retry:false; voer de oorspronkelijke aanvraag nooit opnieuw uit" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Geef prompt op als tekst en duration als een geheel aantal seconden. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.", "required": [ "model", "prompt", "duration" ], "required_material": "Een geschreven prompt." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images is een array. Elk frameobject bevat type, image_url en frame_type; image_url bevat url. Stel type in op image_url. Gebruik first_frame met een optionele last_frame. Elke framerol komt hoogstens één keer voor. Geef voor elk frame een openbare HTTPS-afbeeldings-URL op. Gebruik in één aanvraag frameafbeeldingen of referentieafbeeldingen; combineer beide niet. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Een geschreven prompt en een afbeelding voor het eerste frame." }, { "mode": "Reference to video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references is een array met objecten. Stel type in op image_url, video_url of audio_url en gebruik het overeenkomstige veld dat url bevat. Gebruik openbare HTTPS-URL's. Laat frame_images weg om de referentiemodus te selecteren. De schatting omvat de getoonde component per afbeelding uitsluitend voor referentieafbeeldingen na de eerste vijf. De uiteindelijke aanrekening volgt de werkelijk aangerekende configuratie. Combineer geen referentieafbeeldingen met frameafbeeldingen. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Een geschreven prompt en ondersteunde referenties in de vorm van afbeeldingen, video of audio." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Positie van deze video in de uitvoerlijst, geteld vanaf nul.", "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": "Ondertekende HTTPS-download-URL voor deze voltooide 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-hash van de oorspronkelijke videobytes; null als die niet beschikbaar is.", "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": "Grootte van het oorspronkelijke videobestand in bytes; null als die niet beschikbaar is.", "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": "Gemeten videoduur in milliseconden; null als die niet beschikbaar is.", "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": "Videobreedte in pixels; null als die niet beschikbaar is.", "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": "Videohoogte in pixels; null als die niet beschikbaar is.", "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": "Identificatiecode van de videocodec; null als die niet is vastgelegd.", "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": "Of de video een audiotrack bevat; null als dit niet is gemeten.", "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": "Identificatiecode van de audiocodec; null als er geen identificatiecode is vastgelegd.", "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": "ondertekende inhouds-URL's die je toebehoren", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3" }, "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": [ "2K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "2K" ] }, "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, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Deze sleutels beschrijven elk frameobject; image_url bevat alleen url. Laat frame_images weg bij een aanvraag met uitsluitend tekst.", "content": "Array met frameobjecten. Elk object bevat type=image_url, image_url met daarin url, en frame_type. Gebruik een HTTPS-afbeeldings-URL en stel frame_type in op first_frame of last_frame. Elke framerol komt hoogstens één keer voor.", "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, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "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" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_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" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_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": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "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, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "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" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_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" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_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": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "minimax/hailuo-3" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "2K" ] }, "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.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio", "video" ], "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", "reference_to_video" ], "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": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "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": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "Deze raming is geen extra kost of vast tarief voor de voltooide generatie.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Geschatte generatiekosten", "units": [ { "amount": "1.3", "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": "1.3", "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\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"2K\"}', 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", "audio", "video" ], "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": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "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": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "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": "1.3", "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": "1.3", "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", "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.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "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.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" }, { "amount": "1.3", "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": "1.3", "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", "request_model_id": "minimax/hailuo-3", "route_label": "Ultra" } ], "name": "MiniMax: H3", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 1.3, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 1.3, "varies": false }, "pricing_profiles": [ { "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": 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": "2K" }, "label": "Ultra", "units": [ { "amount": "0.26", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "2K" }, "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": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "768P" }, "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": "2K" }, "label": "Ultra", "units": [ { "amount": "0.26", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "2K" }, "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": 5, "only_additional_images_charged": true, "reference_audio_free": true }, "label": "Ultra", "units": [ { "amount": "0.08", "amount_unit": "usd_per_input_image", "conditions": { "adds_to_output": true, "first_free_reference_images": 5, "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.26", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second", "billing_original_currency": "USD", "billing_original_rate": "0.26", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_physical_unit", "basis": "reference image", "billing_original_currency": "USD", "billing_original_rate": "0.08", "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "quantity": 1, "side": "in", "unit": "reference_image" } ] } ], "public_id": "minimax/hailuo-3", "short": "MiniMax H3 genereert korte video met native stereogeluid op basis van tekst, framebeelden of multimodale referenties. Het ondersteunt creatie met eerste/laatste frames, bewerking met referenties en verbanden met beweging of stem, met uitvoer van 4–15 seconden en een afzonderlijke workflow voor 2K-regeneratie." }, "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 genereert korte video met native stereogeluid op basis van tekst, framebeelden of multimodale referenties. Het ondersteunt creatie met eerste/laatste frames, bewerking met referenties en verbanden met beweging of stem, met uitvoer van 4–15 seconden en een afzonderlijke workflow voor 2K-regeneratie.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "0c114a6d2c83874a5019b32e0ecd31a1cb2771879f27bd52403480f5171cc1a2", "renderer_sha256": "a5aefc67f30427b283b8d8bf7955908a0216c6e5e4ca3cc1887842431e2b1ee6" }, "sourceRevision": "fc5cd83cb41a4031384fe4d4b82d2fb91805323568ae1213c33161c14c5a2da8" }