{ "aboutHtml": "

Een snelle, verder getrainde H3-variant

MiniMax H3 Max is een via post-training ontwikkelde variant van het MiniMax H3-basismodel, geoptimaliseerd voor snellere generatie, het volgen van prompts en audiovisuele kwaliteit. De variant is door fal Research ontwikkeld via post-training. Hij behoudt uniforme multimodale context en inherent gesynchroniseerd beeld en geluid. Snelheid is een ontwerpprioriteit en geen vaste voltooiingstijd voor elke prompt, duur of toepassing.

Onderscheid Max van het oorspronkelijke H3-systeem en van de afzonderlijke Max Turbo-variant. De huidige interface van MiniMax vermeldt Max in 480P of 768P, met standaard 768P, 24 beelden per seconde en een geheel aantal seconden van 5 tot 15. De gedocumenteerde Max-procedure biedt niet de 2K-instelling van het oorspronkelijke H3-systeem of uitvoer van vier seconden.

Van een prompt naar een shot

Elke generatie bevat een niet-lege tekstbriefing, met maximaal 7000 tekens per tekstonderdeel. Beschrijf het onderwerp, de begincompositie, de handeling en het resultaat en maak vervolgens de camera- en geluidsaanwijzingen duidelijk. Benoem voor een korte objectonthulling wat de kijker als eerste moet zien, hoe het object in beeld komt en hoe het shot moet eindigen.

Een bruikbare briefing voor vijf seconden kan een keramische kop op een houten tafel beschrijven, een hand die er een schoteltje naast zet, een kleine voorwaartse camerabeweging en het geluid van keramiek op hout. Houd de handeling klein genoeg voor de gekozen duur en controleer of de geretourneerde beweging en het geluid dezelfde gebeurtenis volgen.

Creatie met framebegeleiding

De fabrikant documenteert een openingsframe, een eindframe of beide. Een eerste afbeelding bepaalt waar de clip begint; een laatste afbeelding bepaalt de uiteindelijke visuele toestand. Leg de verbindende beweging uit, inclusief veranderingen in houding, objectpositie, camera of belichting. Vermijd bij een overgang tussen twee frames een briefing die tussen de eindpunten een onverenigbare scène introduceert.

Uitvoer met framebegeleiding ontleent de beeldverhouding aan de invoerafbeelding. Kies voor werk met alleen tekst een concrete verhouding uit 21:9, 16:9, 4:3, 1:1, 3:4 of 9:16. Referentiegestuurd werk kan een adaptieve verhouding of een van de gedocumenteerde expliciete opties gebruiken. Stem de referentie of geschreven scène af op het doelformaat in plaats van aan te nemen dat dezelfde indeling even goed werkt in portret- en landschapsformaat.

Multimodale referenties

Het huidige Max-generatieschema van MiniMax documenteert ook referentieafbeeldingen, video en audio. Geef aan wat elk onderdeel moet beïnvloeden: personage-identiteit, een omgeving, een bewegingspatroon, een cameratraject, stemklank of een geluidskenmerk. Rollen voor het eerste/laatste frame en rollen voor referentiemedia sluiten elkaar in die interface uit.

Benoem voor een personageshot de uiterlijke referentie en de bewegingsreferentie afzonderlijk en geef daarna de doelhandeling en gesproken zin op. Een stemreferentie die de voordracht bepaalt, verschilt van het kopiëren van het volledige audiosignaal. Maak in de briefing expliciet welke kenmerken behouden moeten blijven en welke veranderingen nodig zijn en beoordeel de daadwerkelijke audiovisuele clip aan de hand van elke referentierol.

Promptuitbreiding

De Max-specifieke uitbreidingsinstelling biedt de opties disabled, balanced en quality, met standaard balanced. Kies disabled wanneer de aangeleverde briefing zonder uitbreiding moet worden doorgegeven; gebruik een gedocumenteerde uitbreidingsmodus wanneer aanvullende interpretatie gewenst is. Bewaar de oorspronkelijke briefing zodat een tijdens de uitbreiding geïntroduceerde wijziging kan worden onderscheiden van de gevraagde inhoud.

Beschrijf geluid als onderdeel van de scène. Benoem fysieke geluiden, omgevingsgeluid en eventuele gesproken woorden en onderscheid die van achtergrondmuziek die alleen het publiek hoort. Geef de exacte zin en de beoogde spreker op in plaats van om onbepaalde dialoog te vragen. Luister naar het resultaat en bekijk het ook; een overtuigend beeld bewijst niet dat de gesproken woorden of timing kloppen.

Invoervoorbereiding en limieten

Het huidige schema van de fabrikant accepteert JPG-, JPEG-, PNG-, WebP-, HEIC- of HEIF-afbeeldingen, maximaal 30 MB per stuk, met zijden van 256 tot 5760 pixels en verhoudingen van 0,4 tot 2,5. Voor de openings- en eindrol is elk één afbeelding toegestaan; de referentiemodus staat maximaal negen afbeeldingen toe. Zorg voor een duidelijk zicht op het onderwerp en op de details die herkenbaar moeten blijven.

Referentievideo staat maximaal drie MP4- of MOV-clips toe, elk 2–15 seconden en samen maximaal 15 seconden, met een limiet van 50 MB per bestand. Het schema documenteert H.264- of H.265-video, AAC- of MP3-audio, zijden van 256 tot 5760 pixels, verhoudingen van 0,4 tot 2,5 en een framerate van 23,976 tot 60. Referentieaudio staat maximaal drie WAV- of MP3-clips toe, elk maximaal 15 MB en 2–15 seconden, samen maximaal 15 seconden. De requestbody heeft een afzonderlijke limiet van 64 MB.

Gebruik alleen referenties die aan het shot bijdragen en benoem elke bijdrage in de tekst. Een korte, relevante bewegingsclip is gemakkelijker als aanwijzing te gebruiken dan een lange verzameling ongerelateerde gebeurtenissen. Vermeld de gewenste duur en uitvoerresolutie expliciet, zodat het resultaat met dezelfde briefing kan worden vergeleken.

Het voltooide resultaat

De asynchrone procedure van de maker retourneert een taak-ID voordat de voltooide video beschikbaar is. Via de taakquery-interface zijn taken uit de voorgaande zeven dagen op te vragen. Bewaar de daadwerkelijk geretourneerde clip en de specificatie voor montage of verdere beoordeling; een taak-ID is niet het audiovisuele resultaat. Downloadadressen zijn tijdelijk geldig, dus bewaar het bestand zelf wanneer je een gekozen resultaat wilt behouden.

Beoordeel de continuïteit van het onderwerp, beweging, zichtbare tekst, dialoog en geluidstiming op het formaat waarop de clip wordt gebruikt. Geef concrete feedback voor een volgende creatieve briefing: het gebaar dat veranderde, de weggelaten zin of de kadrering die moet worden aangepast. Het bruikbare resultaat is een kort audiovisueel shot dat gekoppeld is aan de aangeleverde inhoud en de expliciete relaties tussen referenties.

", "aboutText": "Een snelle, verder getrainde H3-variant\n\nMiniMax H3 Max is een via post-training ontwikkelde variant van het MiniMax H3-basismodel, geoptimaliseerd voor snellere generatie, het volgen van prompts en audiovisuele kwaliteit. De variant is door fal Research ontwikkeld via post-training. Hij behoudt uniforme multimodale context en inherent gesynchroniseerd beeld en geluid. Snelheid is een ontwerpprioriteit en geen vaste voltooiingstijd voor elke prompt, duur of toepassing.\n\nOnderscheid Max van het oorspronkelijke H3-systeem en van de afzonderlijke Max Turbo-variant. De huidige interface van MiniMax vermeldt Max in 480P of 768P, met standaard 768P, 24 beelden per seconde en een geheel aantal seconden van 5 tot 15. De gedocumenteerde Max-procedure biedt niet de 2K-instelling van het oorspronkelijke H3-systeem of uitvoer van vier seconden.\n\nVan een prompt naar een shot\n\nElke generatie bevat een niet-lege tekstbriefing, met maximaal 7000 tekens per tekstonderdeel. Beschrijf het onderwerp, de begincompositie, de handeling en het resultaat en maak vervolgens de camera- en geluidsaanwijzingen duidelijk. Benoem voor een korte objectonthulling wat de kijker als eerste moet zien, hoe het object in beeld komt en hoe het shot moet eindigen.\n\nEen bruikbare briefing voor vijf seconden kan een keramische kop op een houten tafel beschrijven, een hand die er een schoteltje naast zet, een kleine voorwaartse camerabeweging en het geluid van keramiek op hout. Houd de handeling klein genoeg voor de gekozen duur en controleer of de geretourneerde beweging en het geluid dezelfde gebeurtenis volgen.\n\nCreatie met framebegeleiding\n\nDe fabrikant documenteert een openingsframe, een eindframe of beide. Een eerste afbeelding bepaalt waar de clip begint; een laatste afbeelding bepaalt de uiteindelijke visuele toestand. Leg de verbindende beweging uit, inclusief veranderingen in houding, objectpositie, camera of belichting. Vermijd bij een overgang tussen twee frames een briefing die tussen de eindpunten een onverenigbare scène introduceert.\n\nUitvoer met framebegeleiding ontleent de beeldverhouding aan de invoerafbeelding. Kies voor werk met alleen tekst een concrete verhouding uit 21:9, 16:9, 4:3, 1:1, 3:4 of 9:16. Referentiegestuurd werk kan een adaptieve verhouding of een van de gedocumenteerde expliciete opties gebruiken. Stem de referentie of geschreven scène af op het doelformaat in plaats van aan te nemen dat dezelfde indeling even goed werkt in portret- en landschapsformaat.\n\nMultimodale referenties\n\nHet huidige Max-generatieschema van MiniMax documenteert ook referentieafbeeldingen, video en audio. Geef aan wat elk onderdeel moet beïnvloeden: personage-identiteit, een omgeving, een bewegingspatroon, een cameratraject, stemklank of een geluidskenmerk. Rollen voor het eerste/laatste frame en rollen voor referentiemedia sluiten elkaar in die interface uit.\n\nBenoem voor een personageshot de uiterlijke referentie en de bewegingsreferentie afzonderlijk en geef daarna de doelhandeling en gesproken zin op. Een stemreferentie die de voordracht bepaalt, verschilt van het kopiëren van het volledige audiosignaal. Maak in de briefing expliciet welke kenmerken behouden moeten blijven en welke veranderingen nodig zijn en beoordeel de daadwerkelijke audiovisuele clip aan de hand van elke referentierol.\n\nPromptuitbreiding\n\nDe Max-specifieke uitbreidingsinstelling biedt de opties disabled, balanced en quality, met standaard balanced. Kies disabled wanneer de aangeleverde briefing zonder uitbreiding moet worden doorgegeven; gebruik een gedocumenteerde uitbreidingsmodus wanneer aanvullende interpretatie gewenst is. Bewaar de oorspronkelijke briefing zodat een tijdens de uitbreiding geïntroduceerde wijziging kan worden onderscheiden van de gevraagde inhoud.\n\nBeschrijf geluid als onderdeel van de scène. Benoem fysieke geluiden, omgevingsgeluid en eventuele gesproken woorden en onderscheid die van achtergrondmuziek die alleen het publiek hoort. Geef de exacte zin en de beoogde spreker op in plaats van om onbepaalde dialoog te vragen. Luister naar het resultaat en bekijk het ook; een overtuigend beeld bewijst niet dat de gesproken woorden of timing kloppen.\n\nInvoervoorbereiding en limieten\n\nHet huidige schema van de fabrikant accepteert JPG-, JPEG-, PNG-, WebP-, HEIC- of HEIF-afbeeldingen, maximaal 30 MB per stuk, met zijden van 256 tot 5760 pixels en verhoudingen van 0,4 tot 2,5. Voor de openings- en eindrol is elk één afbeelding toegestaan; de referentiemodus staat maximaal negen afbeeldingen toe. Zorg voor een duidelijk zicht op het onderwerp en op de details die herkenbaar moeten blijven.\n\nReferentievideo staat maximaal drie MP4- of MOV-clips toe, elk 2–15 seconden en samen maximaal 15 seconden, met een limiet van 50 MB per bestand. Het schema documenteert H.264- of H.265-video, AAC- of MP3-audio, zijden van 256 tot 5760 pixels, verhoudingen van 0,4 tot 2,5 en een framerate van 23,976 tot 60. Referentieaudio staat maximaal drie WAV- of MP3-clips toe, elk maximaal 15 MB en 2–15 seconden, samen maximaal 15 seconden. De requestbody heeft een afzonderlijke limiet van 64 MB.\n\nGebruik alleen referenties die aan het shot bijdragen en benoem elke bijdrage in de tekst. Een korte, relevante bewegingsclip is gemakkelijker als aanwijzing te gebruiken dan een lange verzameling ongerelateerde gebeurtenissen. Vermeld de gewenste duur en uitvoerresolutie expliciet, zodat het resultaat met dezelfde briefing kan worden vergeleken.\n\nHet voltooide resultaat\n\nDe asynchrone procedure van de maker retourneert een taak-ID voordat de voltooide video beschikbaar is. Via de taakquery-interface zijn taken uit de voorgaande zeven dagen op te vragen. Bewaar de daadwerkelijk geretourneerde clip en de specificatie voor montage of verdere beoordeling; een taak-ID is niet het audiovisuele resultaat. Downloadadressen zijn tijdelijk geldig, dus bewaar het bestand zelf wanneer je een gekozen resultaat wilt behouden.\n\nBeoordeel de continuïteit van het onderwerp, beweging, zichtbare tekst, dialoog en geluidstiming op het formaat waarop de clip wordt gebruikt. Geef concrete feedback voor een volgende creatieve briefing: het gebaar dat veranderde, de weggelaten zin of de kadrering die moet worden aangepast. Het bruikbare resultaat is een kort audiovisueel shot dat gekoppeld is aan de aangeleverde inhoud en de expliciete relaties tussen referenties.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "5528ff62b2d7433333fc53944e3fa109b92a9266a3c9b15b280579907b62eade", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl", "methods": [ { "html": "
MM

MiniMax: H3 Max

MiniMax /minimax/hailuo-3-max

Aan de slag

MiniMax H3 Max is een snelle, verder getrainde H3-variant voor korte video's met gesynchroniseerd geluid. De gedocumenteerde procedure van MiniMax ondersteunt tekst, frameafbeeldingen en multimodale referenties, met uitvoer in 480P of 768P, een duur van 5–15 seconden en eigen opties voor promptuitbreiding.

Toegestane invoer
Tekst · Afbeeldingen
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.

Een snelle, verder getrainde H3-variant

MiniMax H3 Max is een via post-training ontwikkelde variant van het MiniMax H3-basismodel, geoptimaliseerd voor snellere generatie, het volgen van prompts en audiovisuele kwaliteit. De variant is door fal Research ontwikkeld via post-training. Hij behoudt uniforme multimodale context en inherent gesynchroniseerd beeld en geluid. Snelheid is een ontwerpprioriteit en geen vaste voltooiingstijd voor elke prompt, duur of toepassing.

Onderscheid Max van het oorspronkelijke H3-systeem en van de afzonderlijke Max Turbo-variant. De huidige interface van MiniMax vermeldt Max in 480P of 768P, met standaard 768P, 24 beelden per seconde en een geheel aantal seconden van 5 tot 15. De gedocumenteerde Max-procedure biedt niet de 2K-instelling van het oorspronkelijke H3-systeem of uitvoer van vier seconden.

Van een prompt naar een shot

Elke generatie bevat een niet-lege tekstbriefing, met maximaal 7000 tekens per tekstonderdeel. Beschrijf het onderwerp, de begincompositie, de handeling en het resultaat en maak vervolgens de camera- en geluidsaanwijzingen duidelijk. Benoem voor een korte objectonthulling wat de kijker als eerste moet zien, hoe het object in beeld komt en hoe het shot moet eindigen.

Een bruikbare briefing voor vijf seconden kan een keramische kop op een houten tafel beschrijven, een hand die er een schoteltje naast zet, een kleine voorwaartse camerabeweging en het geluid van keramiek op hout. Houd de handeling klein genoeg voor de gekozen duur en controleer of de geretourneerde beweging en het geluid dezelfde gebeurtenis volgen.

Creatie met framebegeleiding

De fabrikant documenteert een openingsframe, een eindframe of beide. Een eerste afbeelding bepaalt waar de clip begint; een laatste afbeelding bepaalt de uiteindelijke visuele toestand. Leg de verbindende beweging uit, inclusief veranderingen in houding, objectpositie, camera of belichting. Vermijd bij een overgang tussen twee frames een briefing die tussen de eindpunten een onverenigbare scène introduceert.

Uitvoer met framebegeleiding ontleent de beeldverhouding aan de invoerafbeelding. Kies voor werk met alleen tekst een concrete verhouding uit 21:9, 16:9, 4:3, 1:1, 3:4 of 9:16. Referentiegestuurd werk kan een adaptieve verhouding of een van de gedocumenteerde expliciete opties gebruiken. Stem de referentie of geschreven scène af op het doelformaat in plaats van aan te nemen dat dezelfde indeling even goed werkt in portret- en landschapsformaat.

Multimodale referenties

Het huidige Max-generatieschema van MiniMax documenteert ook referentieafbeeldingen, video en audio. Geef aan wat elk onderdeel moet beïnvloeden: personage-identiteit, een omgeving, een bewegingspatroon, een cameratraject, stemklank of een geluidskenmerk. Rollen voor het eerste/laatste frame en rollen voor referentiemedia sluiten elkaar in die interface uit.

Benoem voor een personageshot de uiterlijke referentie en de bewegingsreferentie afzonderlijk en geef daarna de doelhandeling en gesproken zin op. Een stemreferentie die de voordracht bepaalt, verschilt van het kopiëren van het volledige audiosignaal. Maak in de briefing expliciet welke kenmerken behouden moeten blijven en welke veranderingen nodig zijn en beoordeel de daadwerkelijke audiovisuele clip aan de hand van elke referentierol.

Promptuitbreiding

De Max-specifieke uitbreidingsinstelling biedt de opties disabled, balanced en quality, met standaard balanced. Kies disabled wanneer de aangeleverde briefing zonder uitbreiding moet worden doorgegeven; gebruik een gedocumenteerde uitbreidingsmodus wanneer aanvullende interpretatie gewenst is. Bewaar de oorspronkelijke briefing zodat een tijdens de uitbreiding geïntroduceerde wijziging kan worden onderscheiden van de gevraagde inhoud.

Beschrijf geluid als onderdeel van de scène. Benoem fysieke geluiden, omgevingsgeluid en eventuele gesproken woorden en onderscheid die van achtergrondmuziek die alleen het publiek hoort. Geef de exacte zin en de beoogde spreker op in plaats van om onbepaalde dialoog te vragen. Luister naar het resultaat en bekijk het ook; een overtuigend beeld bewijst niet dat de gesproken woorden of timing kloppen.

Invoervoorbereiding en limieten

Het huidige schema van de fabrikant accepteert JPG-, JPEG-, PNG-, WebP-, HEIC- of HEIF-afbeeldingen, maximaal 30 MB per stuk, met zijden van 256 tot 5760 pixels en verhoudingen van 0,4 tot 2,5. Voor de openings- en eindrol is elk één afbeelding toegestaan; de referentiemodus staat maximaal negen afbeeldingen toe. Zorg voor een duidelijk zicht op het onderwerp en op de details die herkenbaar moeten blijven.

Referentievideo staat maximaal drie MP4- of MOV-clips toe, elk 2–15 seconden en samen maximaal 15 seconden, met een limiet van 50 MB per bestand. Het schema documenteert H.264- of H.265-video, AAC- of MP3-audio, zijden van 256 tot 5760 pixels, verhoudingen van 0,4 tot 2,5 en een framerate van 23,976 tot 60. Referentieaudio staat maximaal drie WAV- of MP3-clips toe, elk maximaal 15 MB en 2–15 seconden, samen maximaal 15 seconden. De requestbody heeft een afzonderlijke limiet van 64 MB.

Gebruik alleen referenties die aan het shot bijdragen en benoem elke bijdrage in de tekst. Een korte, relevante bewegingsclip is gemakkelijker als aanwijzing te gebruiken dan een lange verzameling ongerelateerde gebeurtenissen. Vermeld de gewenste duur en uitvoerresolutie expliciet, zodat het resultaat met dezelfde briefing kan worden vergeleken.

Het voltooide resultaat

De asynchrone procedure van de maker retourneert een taak-ID voordat de voltooide video beschikbaar is. Via de taakquery-interface zijn taken uit de voorgaande zeven dagen op te vragen. Bewaar de daadwerkelijk geretourneerde clip en de specificatie voor montage of verdere beoordeling; een taak-ID is niet het audiovisuele resultaat. Downloadadressen zijn tijdelijk geldig, dus bewaar het bestand zelf wanneer je een gekozen resultaat wilt behouden.

Beoordeel de continuïteit van het onderwerp, beweging, zichtbare tekst, dialoog en geluidstiming op het formaat waarop de clip wordt gebruikt. Geef concrete feedback voor een volgende creatieve briefing: het gebaar dat veranderde, de weggelaten zin of de kadrering die moet worden aangepast. Het bruikbare resultaat is een kort audiovisueel shot dat gekoppeld is aan de aangeleverde inhoud en de expliciete relaties tussen referenties.

Beschikbaar in Ailoot · invoer en methoden

Ailoot Ultra · Video POST /v1/videos
Invoertypen
text, image
Uitvoertypen
video
Uitvoerformaat
oorspronkelijke MP4-bytes; geen normalisatie of transcodering
VeldTypeVereisteWaarden en limietenStandaard
VeldmodelTypestringVereisteVereistWaarden en limieten
minimax/hailuo-3-max
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
768p, 480p
Standaard—
Veldaspect_ratioTypestringVereisteOptioneelWaarden en limieten
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Standaard—
Veldgenerate_audioTypebooleanVereisteOptioneelWaarden en limieten
false
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 maximaal eenmaal voor.
Exacte sleutels: type, image_url, frame_type
Voorwaarden: Deze sleutels beschrijven elk frameobject; image_url bevat uitsluitend url. Laat frame_images weg voor een verzoek 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 als tekst en duration in hele seconden op. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.

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

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 maximaal eenmaal voor. Geef voor elk frame een openbare HTTPS-afbeeldings-URL op. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.

Exacte sleutels: type, image_url, frame_type

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

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
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 weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn 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 is geselecteerd
Flexmodus
Niet opgegeven Wanneer de modus flex is geselecteerd
Maximale redeneerinspanning
Niet opgegeven Wanneer bij 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 hoeveelheidKostencomponentRekeneenheidFactureringsvoorwaardenKosten
ConfiguratieBasistarieven voor tokensTariefstaffelBasistariefVerwachte hoeveelheid—Kostencomponent—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
ConfiguratieVideo-uitvoer · referentietariefTariefstaffel—Verwachte hoeveelheid—Kostencomponentreference_output_rateRekeneenheidper uitvoersecondeFactureringsvoorwaarden—Kosten
Uitvoer · Referentietarief per seconde video-uitvoer · Schatting uitsluitend ter vergelijking $0.16 per uitvoerseconde
ConfiguratieVideoprijsTariefstaffel—Verwachte hoeveelheid—Kostencomponent—Rekeneenheidper videosecondeFactureringsvoorwaardenresolution: 480pKosten
Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.1 per videoseconde
ConfiguratieVideoprijsTariefstaffel—Verwachte hoeveelheid—Kostencomponent—Rekeneenheidper videosecondeFactureringsvoorwaardenresolution: 768pKosten
Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.16 per videoseconde
ConfiguratieGeschatte generatiekostenTariefstaffel—Verwachte hoeveelheidschatting voor één generatieKostencomponent—Rekeneenheid—Factureringsvoorwaarden—Kosten
Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.5 schatting vóór generatie

Deze schatting is geen extra bedrag 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 aanvullende voorwaarde vastgelegd.Kosten
Uitvoer · Videoprijs $0.16 per videoseconde

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

ConfiguratieVideoprijsFactureringsvoorwaardenresolution: 480pKosten
Uitvoer · Videoprijs $0.1 per videoseconde

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

ConfiguratieVideoprijsFactureringsvoorwaardenresolution: 768pKosten
Uitvoer · Videoprijs $0.16 per videoseconde

Gepubliceerde prijsreferentie voor de weergegeven configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde 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-max","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

Resultaten ophalen en opslaan

Ailoot Ultra · Video

ondertekende inhouds-URLs die u bezit

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 daadwerkelijke uitvoer die u bezit en de geretourneerde gemeten metadata.

Als het oorspronkelijke antwoord moet worden gecontroleerd

503 result_pending_check + oorspronkelijke id + X-Should-Retry:false; herhaal het oorspronkelijke verzoek nooit

Antwoordvelden
VeldTypeBetekenis
VeldindexTypeintegerBetekenisPositie van deze video in de uitvoerlijst, geteld vanaf nul.
Veldcontent_urlTypestringBetekenisOndertekende HTTPS-download-URL voor deze voltooide video.
Veldsha256Typestring | nullBetekenisSHA-256-digest van de oorspronkelijke videobytes; null indien niet beschikbaar.
Veldsize_bytesTypeinteger | nullBetekenisGrootte van het oorspronkelijke videobestand in bytes; null indien niet beschikbaar.
Veldduration_msTypeinteger | nullBetekenisGemeten videoduur in milliseconden; null indien niet beschikbaar.
VeldwidthTypeinteger | nullBetekenisVideobreedte in pixels; null indien niet beschikbaar.
VeldheightTypeinteger | nullBetekenisVideohoogte in pixels; null indien niet beschikbaar.
Veldvideo_codecTypestring | nullBetekenisVideocodec-identificatie; null indien niet vastgelegd.
Veldhas_audioTypeboolean | nullBetekenisOf de video een audiotrack bevat; null indien niet gemeten.
Veldaudio_codecTypestring | nullBetekenisAudiocodec-identificatie; null wanneer geen identificatie is vastgelegd.
Fouten en vervolgstappen
AntwoordVoorwaardeVolgende stap
Antwoord404 · not_found_errorVoorwaardeVideotoegang is niet beschikbaar of deze video-ID is niet gevonden.Volgende stapControleer videotoegang. 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 uw API-sleutel en accounttoegang voordat u indient.
Antwoord400 · invalid_request_errorVoorwaardeHet verzoek kon niet worden gelezen of de downloadindex is ongeldig.Volgende stapCorrigeer de verzoekbody. Kies voor een download een uitvoerindex die door de oorspronkelijke taak is geretourneerd.
Antwoord422 · price_unavailableVoorwaardeDe geselecteerde videoconfiguratie kan niet worden geprijsd.Volgende stapKies een ondersteunde videoconfiguratie en vul de vereiste opties in voordat u een gecorrigeerd verzoek indient.
Antwoord422 · invalid_request_errorVoorwaardeEen videoinvoer of oorspronkelijke vervolgtaak is ongeldig.Volgende stapGebruik geldige HTTPS-invoer. Gebruik voor een vervolg uw voltooide oorspronkelijke openbare video-ID met dezelfde API-sleutel.
Antwoord402 · billing_errorVoorwaardeHet beschikbare saldo of de limieten staan geen reservering toe.Volgende stapControleer uw beschikbare saldo en limieten voordat u een nieuw verzoek verstuurt.
Antwoord503 · server_errorVoorwaardeVideoverificatie, opslag of servicetoegang is tijdelijk niet beschikbaar.Volgende stapWacht tot de service beschikbaar is. Als u al een video-ID hebt, controleert u die oorspronkelijke taak in plaats van een nieuwe generatie aan te maken.
Antwoord503 · result_pending_checkVoorwaardeHet oorspronkelijke videoresultaat en de kosten moeten worden gecontroleerd.Volgende stapBewaar de geretourneerde video-ID en controleer die taak. Verstuur geen vervangend generatieverzoek terwijl deze wordt gecontroleerd.
Antwoord503 · owned_result_unavailableVoorwaardeDe bestaande videodownload is tijdelijk niet beschikbaar.Volgende stapControleer dezelfde videotaak later en download de bestaande uitvoer. Een nieuwe generatie maakt een afzonderlijke operatie aan.
Antwoord409 · video_not_readyVoorwaardeDe video-inhoud is niet gepubliceerd.Volgende stapControleer de oorspronkelijke taakstatus. Download nadat deze completed meldt; als deze failed meldt, volgt u de melding over kostencontrole.

Aliasnamen

Modelaliasnamen

Ailoot Ultra minimax/hailuo-3-max

Aliasnamen voor methodepaden

Gebruik de hierboven getoonde methodepaden.

Gerelateerde aanroeper-ID’s

minimax/hailuo-3-max

", "method_identity": { "effective_request_model_id": "minimax/hailuo-3-max", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|minimax%2Fhailuo-3-max", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn 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 daadwerkelijke uitvoer die u bezit en de geretourneerde gemeten metadata.", "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": "Videotoegang is niet beschikbaar of deze video-ID is niet gevonden.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Controleer videotoegang. 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 uw API-sleutel en accounttoegang voordat u indient.", "type": "authentication_error" }, { "condition": "Het verzoek kon niet worden gelezen of de downloadindex is ongeldig.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrigeer de verzoekbody. Kies voor een download een uitvoerindex die door de oorspronkelijke taak is geretourneerd.", "type": "invalid_request_error" }, { "condition": "De geselecteerde videoconfiguratie kan niet worden geprijsd.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Kies een ondersteunde videoconfiguratie en vul de vereiste opties in voordat u een gecorrigeerd verzoek indient.", "type": "price_unavailable" }, { "condition": "Een videoinvoer of oorspronkelijke vervolgtaak is ongeldig.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Gebruik geldige HTTPS-invoer. Gebruik voor een vervolg uw voltooide oorspronkelijke openbare video-ID met dezelfde API-sleutel.", "type": "invalid_request_error" }, { "condition": "Het beschikbare saldo of de limieten staan geen reservering toe.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Controleer uw beschikbare saldo en limieten voordat u een nieuw verzoek verstuurt.", "type": "billing_error" }, { "condition": "Videoverificatie, opslag of servicetoegang is tijdelijk niet beschikbaar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Wacht tot de service beschikbaar is. Als u al een video-ID hebt, controleert u 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 kosten moeten worden gecontroleerd.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Bewaar de geretourneerde video-ID en controleer die taak. Verstuur geen vervangend generatieverzoek terwijl deze wordt gecontroleerd.", "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 dezelfde videotaak later en download de bestaande uitvoer. 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 nadat deze completed meldt; als deze failed meldt, volgt u de melding over kostencontrole.", "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; herhaal het oorspronkelijke verzoek nooit" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Geef prompt als tekst en duration in hele seconden op. 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-max" ], "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 maximaal eenmaal voor. Geef voor elk frame een openbare HTTPS-afbeeldings-URL op. 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." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "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-digest van de oorspronkelijke videobytes; null indien niet beschikbaar.", "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 indien niet beschikbaar.", "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 indien niet beschikbaar.", "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 indien niet beschikbaar.", "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 indien niet beschikbaar.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Videocodec-identificatie; null indien niet 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 indien niet 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": "Audiocodec-identificatie; null wanneer geen identificatie 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-URLs die u bezit", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3-max" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "768p", "480p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "768p", "480p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Deze sleutels beschrijven elk frameobject; image_url bevat uitsluitend url. Laat frame_images weg voor een verzoek 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 maximaal eenmaal 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, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "minimax/hailuo-3-max" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "768p", "480p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video-uitvoer · referentietarief", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Videoprijs", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Geschatte generatiekosten", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3-max\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"480p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video output · reference rate", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" }, { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "minimax/hailuo-3-max", "nativeProvenance": { "input_facts_canonical_sha256": "93c80b0c84aa3ed2f0958a485b47c40c3b867d797f4fd727acab40be40ffde55", "input_html_sha256": "cbfc5e607cd3b9511d3ad41eb37fa2e9c3daf4d45ffe7fcb992ad33c88e928cc", "private_audit_sha256": "6756075a84c33cb38e5939ce85ee04344c4136a7ad984a85ad2767d27ee2e3ec", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/nl/minimax-hailuo-3-max/", "description": "MiniMax H3 Max is een snelle, verder getrainde H3-variant voor korte video's met gesynchroniseerd geluid. De gedocumenteerde procedure van MiniMax ondersteunt tekst, frameafbeeldingen en multimodale referenties, met uitvoer in 480P of 768P, een duur van 5–15 seconden en eigen opties voor promptuitbreiding.", "locale": "nl", "md_url": "https://ailoot.ai/models/nl/minimax-hailuo-3-max/index.md", "title": "MiniMax: H3 Max — Ailoot", "url": "https://ailoot.ai/models/nl/minimax-hailuo-3-max/" }, "rawModel": { "about": "Een snelle, verder getrainde H3-variant\n\nMiniMax H3 Max is een via post-training ontwikkelde variant van het MiniMax H3-basismodel, geoptimaliseerd voor snellere generatie, het volgen van prompts en audiovisuele kwaliteit. De variant is door fal Research ontwikkeld via post-training. Hij behoudt uniforme multimodale context en inherent gesynchroniseerd beeld en geluid. Snelheid is een ontwerpprioriteit en geen vaste voltooiingstijd voor elke prompt, duur of toepassing.\n\nOnderscheid Max van het oorspronkelijke H3-systeem en van de afzonderlijke Max Turbo-variant. De huidige interface van MiniMax vermeldt Max in 480P of 768P, met standaard 768P, 24 beelden per seconde en een geheel aantal seconden van 5 tot 15. De gedocumenteerde Max-procedure biedt niet de 2K-instelling van het oorspronkelijke H3-systeem of uitvoer van vier seconden.\n\nVan een prompt naar een shot\n\nElke generatie bevat een niet-lege tekstbriefing, met maximaal 7000 tekens per tekstonderdeel. Beschrijf het onderwerp, de begincompositie, de handeling en het resultaat en maak vervolgens de camera- en geluidsaanwijzingen duidelijk. Benoem voor een korte objectonthulling wat de kijker als eerste moet zien, hoe het object in beeld komt en hoe het shot moet eindigen.\n\nEen bruikbare briefing voor vijf seconden kan een keramische kop op een houten tafel beschrijven, een hand die er een schoteltje naast zet, een kleine voorwaartse camerabeweging en het geluid van keramiek op hout. Houd de handeling klein genoeg voor de gekozen duur en controleer of de geretourneerde beweging en het geluid dezelfde gebeurtenis volgen.\n\nCreatie met framebegeleiding\n\nDe fabrikant documenteert een openingsframe, een eindframe of beide. Een eerste afbeelding bepaalt waar de clip begint; een laatste afbeelding bepaalt de uiteindelijke visuele toestand. Leg de verbindende beweging uit, inclusief veranderingen in houding, objectpositie, camera of belichting. Vermijd bij een overgang tussen twee frames een briefing die tussen de eindpunten een onverenigbare scène introduceert.\n\nUitvoer met framebegeleiding ontleent de beeldverhouding aan de invoerafbeelding. Kies voor werk met alleen tekst een concrete verhouding uit 21:9, 16:9, 4:3, 1:1, 3:4 of 9:16. Referentiegestuurd werk kan een adaptieve verhouding of een van de gedocumenteerde expliciete opties gebruiken. Stem de referentie of geschreven scène af op het doelformaat in plaats van aan te nemen dat dezelfde indeling even goed werkt in portret- en landschapsformaat.\n\nMultimodale referenties\n\nHet huidige Max-generatieschema van MiniMax documenteert ook referentieafbeeldingen, video en audio. Geef aan wat elk onderdeel moet beïnvloeden: personage-identiteit, een omgeving, een bewegingspatroon, een cameratraject, stemklank of een geluidskenmerk. Rollen voor het eerste/laatste frame en rollen voor referentiemedia sluiten elkaar in die interface uit.\n\nBenoem voor een personageshot de uiterlijke referentie en de bewegingsreferentie afzonderlijk en geef daarna de doelhandeling en gesproken zin op. Een stemreferentie die de voordracht bepaalt, verschilt van het kopiëren van het volledige audiosignaal. Maak in de briefing expliciet welke kenmerken behouden moeten blijven en welke veranderingen nodig zijn en beoordeel de daadwerkelijke audiovisuele clip aan de hand van elke referentierol.\n\nPromptuitbreiding\n\nDe Max-specifieke uitbreidingsinstelling biedt de opties disabled, balanced en quality, met standaard balanced. Kies disabled wanneer de aangeleverde briefing zonder uitbreiding moet worden doorgegeven; gebruik een gedocumenteerde uitbreidingsmodus wanneer aanvullende interpretatie gewenst is. Bewaar de oorspronkelijke briefing zodat een tijdens de uitbreiding geïntroduceerde wijziging kan worden onderscheiden van de gevraagde inhoud.\n\nBeschrijf geluid als onderdeel van de scène. Benoem fysieke geluiden, omgevingsgeluid en eventuele gesproken woorden en onderscheid die van achtergrondmuziek die alleen het publiek hoort. Geef de exacte zin en de beoogde spreker op in plaats van om onbepaalde dialoog te vragen. Luister naar het resultaat en bekijk het ook; een overtuigend beeld bewijst niet dat de gesproken woorden of timing kloppen.\n\nInvoervoorbereiding en limieten\n\nHet huidige schema van de fabrikant accepteert JPG-, JPEG-, PNG-, WebP-, HEIC- of HEIF-afbeeldingen, maximaal 30 MB per stuk, met zijden van 256 tot 5760 pixels en verhoudingen van 0,4 tot 2,5. Voor de openings- en eindrol is elk één afbeelding toegestaan; de referentiemodus staat maximaal negen afbeeldingen toe. Zorg voor een duidelijk zicht op het onderwerp en op de details die herkenbaar moeten blijven.\n\nReferentievideo staat maximaal drie MP4- of MOV-clips toe, elk 2–15 seconden en samen maximaal 15 seconden, met een limiet van 50 MB per bestand. Het schema documenteert H.264- of H.265-video, AAC- of MP3-audio, zijden van 256 tot 5760 pixels, verhoudingen van 0,4 tot 2,5 en een framerate van 23,976 tot 60. Referentieaudio staat maximaal drie WAV- of MP3-clips toe, elk maximaal 15 MB en 2–15 seconden, samen maximaal 15 seconden. De requestbody heeft een afzonderlijke limiet van 64 MB.\n\nGebruik alleen referenties die aan het shot bijdragen en benoem elke bijdrage in de tekst. Een korte, relevante bewegingsclip is gemakkelijker als aanwijzing te gebruiken dan een lange verzameling ongerelateerde gebeurtenissen. Vermeld de gewenste duur en uitvoerresolutie expliciet, zodat het resultaat met dezelfde briefing kan worden vergeleken.\n\nHet voltooide resultaat\n\nDe asynchrone procedure van de maker retourneert een taak-ID voordat de voltooide video beschikbaar is. Via de taakquery-interface zijn taken uit de voorgaande zeven dagen op te vragen. Bewaar de daadwerkelijk geretourneerde clip en de specificatie voor montage of verdere beoordeling; een taak-ID is niet het audiovisuele resultaat. Downloadadressen zijn tijdelijk geldig, dus bewaar het bestand zelf wanneer je een gekozen resultaat wilt behouden.\n\nBeoordeel de continuïteit van het onderwerp, beweging, zichtbare tekst, dialoog en geluidstiming op het formaat waarop de clip wordt gebruikt. Geef concrete feedback voor een volgende creatieve briefing: het gebaar dat veranderde, de weggelaten zin of de kadrering die moet worden aangepast. Het bruikbare resultaat is een kort audiovisueel shot dat gekoppeld is aan de aangeleverde inhoud en de expliciete relaties tussen referenties.", "alias_of": null, "aliases": [], "author": "MiniMax", "available": null, "canonical_model": "minimax/hailuo-3-max", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "De volledige prijsinformatie voor de configuratie vindt u bij de details." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "c3ee132fc5b4cd02f24f5c4d", "label": "Prijsreferenties voor videoconfiguraties", "profiles": [ { "basis": "Gepubliceerde prijsreferentie voor de weergegeven configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie.", "dimensions": { "conditions": "In deze prijssleutel is geen aanvullende voorwaarde vastgelegd." }, "label": "Videoprijs", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Gepubliceerde prijsreferentie voor de weergegeven configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie.", "dimensions": { "conditions": "resolution: 480p" }, "label": "Videoprijs", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Gepubliceerde prijsreferentie voor de weergegeven configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie.", "dimensions": { "conditions": "resolution: 768p" }, "label": "Videoprijs", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "minimax/hailuo-3-max", "input": [ "text", "image" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn 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 daadwerkelijke uitvoer die u bezit en de geretourneerde gemeten metadata.", "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": "Videotoegang is niet beschikbaar of deze video-ID is niet gevonden.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Controleer videotoegang. 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 uw API-sleutel en accounttoegang voordat u indient.", "type": "authentication_error" }, { "condition": "Het verzoek kon niet worden gelezen of de downloadindex is ongeldig.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrigeer de verzoekbody. Kies voor een download een uitvoerindex die door de oorspronkelijke taak is geretourneerd.", "type": "invalid_request_error" }, { "condition": "De geselecteerde videoconfiguratie kan niet worden geprijsd.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Kies een ondersteunde videoconfiguratie en vul de vereiste opties in voordat u een gecorrigeerd verzoek indient.", "type": "price_unavailable" }, { "condition": "Een videoinvoer of oorspronkelijke vervolgtaak is ongeldig.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Gebruik geldige HTTPS-invoer. Gebruik voor een vervolg uw voltooide oorspronkelijke openbare video-ID met dezelfde API-sleutel.", "type": "invalid_request_error" }, { "condition": "Het beschikbare saldo of de limieten staan geen reservering toe.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Controleer uw beschikbare saldo en limieten voordat u een nieuw verzoek verstuurt.", "type": "billing_error" }, { "condition": "Videoverificatie, opslag of servicetoegang is tijdelijk niet beschikbaar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Wacht tot de service beschikbaar is. Als u al een video-ID hebt, controleert u 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 kosten moeten worden gecontroleerd.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Bewaar de geretourneerde video-ID en controleer die taak. Verstuur geen vervangend generatieverzoek terwijl deze wordt gecontroleerd.", "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 dezelfde videotaak later en download de bestaande uitvoer. 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 nadat deze completed meldt; als deze failed meldt, volgt u de melding over kostencontrole.", "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; herhaal het oorspronkelijke verzoek nooit" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Geef prompt als tekst en duration in hele seconden op. 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-max" ], "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 maximaal eenmaal voor. Geef voor elk frame een openbare HTTPS-afbeeldings-URL op. 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." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "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-digest van de oorspronkelijke videobytes; null indien niet beschikbaar.", "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 indien niet beschikbaar.", "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 indien niet beschikbaar.", "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 indien niet beschikbaar.", "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 indien niet beschikbaar.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Videocodec-identificatie; null indien niet 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 indien niet 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": "Audiocodec-identificatie; null wanneer geen identificatie 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-URLs die u bezit", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3-max" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "768p", "480p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "768p", "480p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Deze sleutels beschrijven elk frameobject; image_url bevat uitsluitend url. Laat frame_images weg voor een verzoek 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 maximaal eenmaal 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, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "minimax/hailuo-3-max" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "768p", "480p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video-uitvoer · referentietarief", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Videoprijs", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Geschatte generatiekosten", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3-max\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"480p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video output · reference rate", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" }, { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "minimax/hailuo-3-max", "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra" } ], "name": "MiniMax: H3 Max", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.5, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.5, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "480P" }, "label": "Ultra", "units": [ { "amount": "0.10", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "480P" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "768P" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "480P" }, "label": "Ultra", "units": [ { "amount": "0.1106", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "480P" }, "key": "input_video", "label": "input video", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.286", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "768P" }, "key": "input_video", "label": "input video", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "first_free_reference_images": 2, "only_additional_images_charged": true, "reference_audio_free": true }, "label": "Ultra", "units": [ { "amount": "0.148", "amount_unit": "usd_per_input_image", "conditions": { "adds_to_output": true, "first_free_reference_images": 2, "only_additional_images_charged": true, "reference_audio_free": true }, "key": "input_image", "label": "input image", "profile_index": 4, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_image" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.16", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.10", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=480p", "billing_original_currency": "USD", "billing_original_rate": "0.10", "key": "duration_seconds_480p", "label": "output second", "native_amount_usd_per_unit": "0.10", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=768p", "billing_original_currency": "USD", "billing_original_rate": "0.16", "key": "duration_seconds_768p", "label": "output second", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "minimax/hailuo-3-max", "short": "MiniMax H3 Max is een snelle, verder getrainde H3-variant voor korte video's met gesynchroniseerd geluid. De gedocumenteerde procedure van MiniMax ondersteunt tekst, frameafbeeldingen en multimodale referenties, met uitvoer in 480P of 768P, een duur van 5–15 seconden en eigen opties voor promptuitbreiding." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "MiniMax H3 Max is een snelle, verder getrainde H3-variant voor korte video's met gesynchroniseerd geluid. De gedocumenteerde procedure van MiniMax ondersteunt tekst, frameafbeeldingen en multimodale referenties, met uitvoer in 480P of 768P, een duur van 5–15 seconden en eigen opties voor promptuitbreiding.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "ee031506bb8be541e09375cdabd1f9c9eeb93dfa973b72fff999807ac931d77d", "renderer_sha256": "be7649af06bb0ae446191041c6cfb8a9b83a53896c8c6e9173e76a39d513e829" }, "sourceRevision": "3bfcd2743e363351ac6faf626365123840755d89c82aadc85c319ecefd8e4bea" }