{ "aboutHtml": "

Een snelle H3-variant met verdere training

MiniMax H3 Max is een verder getrainde 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 aanvullende training na de basistraining. Hij behoudt een geïntegreerde multimodale context en standaard gesynchroniseerd beeld en geluid. Snelheid is een ontwerpprioriteit, geen vaste voltooiingstijd voor elke prompt, duur of toepassing.

Maak onderscheid tussen Max, het oorspronkelijke H3-systeem en de afzonderlijke Max Turbo-variant. De huidige interface van MiniMax vermeldt voor Max 480P of 768P, met 768P als standaard, 24 beelden per seconde en een duur van 5 tot 15 seconden, opgegeven in gehele seconden. De gedocumenteerde Max-workflow biedt geen 2K-instelling of uitvoer van vier seconden zoals het oorspronkelijke H3-systeem.

Van prompt naar shot

Elke generatie bevat een niet-lege tekstbriefing, met maximaal 7.000 tekens per tekstonderdeel. Beschrijf onderwerp, begincompositie, actie en resultaat en geef vervolgens duidelijke camera- en geluidsaanwijzingen. Bepaal voor een korte onthulling van een object wat de kijker eerst 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 plaatst, een kleine camerabeweging naar voren en het geluid van keramiek op hout. Hou de actie beperkt genoeg voor de gekozen duur en controleer of de beweging en het geluid in het resultaat dezelfde gebeurtenis volgen.

Creatie met framebeelden

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 tussendoor een onverenigbare scène introduceert.

Uitvoer op basis van framebeelden neemt de beeldverhouding over van 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. Werk op basis van referenties kan een adaptieve verhouding of een van de gedocumenteerde expliciete opties gebruiken. Stem de referentie of geschreven scène af op het doelformaat; ga er niet van uit dat dezelfde opstelling even goed werkt in staand en liggend formaat.

Multimodale referenties

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

Duid bij een personageshot de uiterlijke referentie en de bewegingsreferentie afzonderlijk aan en geef daarna de beoogde actie en gesproken zin. Een stemreferentie die de voordracht bepaalt, is iets anders dan het volledige audiosignaal kopiëren. Wees expliciet over de te behouden kenmerken en gewenste wijzigingen en vergelijk de daadwerkelijke audiovisuele clip met elke referentierol.

Promptuitbreiding

De Max-specifieke instelling voor uitbreiding biedt disabled, balanced en quality, met balanced als standaard. Kies disabled wanneer de aangeleverde briefing zonder uitbreiding moet worden verwerkt; gebruik een gedocumenteerde uitbreidingsmodus wanneer extra interpretatie gewenst is. Bewaar de oorspronkelijke briefing om een door de uitbreiding ingevoerde wijziging te kunnen onderscheiden van de gevraagde inhoud.

Beschrijf geluid als deel van de scène. Benoem fysieke geluiden, omgevingsgeluid en gesproken woorden en onderscheid die van achtergrondmuziek die alleen het publiek hoort. Geef de exacte zin en bedoelde spreker op in plaats van onbepaalde dialoog te vragen. Beluister het resultaat ook; een overtuigend beeld bewijst niet dat de gesproken formulering of timing juist is.

Invoer voorbereiden en limieten

Het huidige schema van de fabrikant accepteert JPG-, JPEG-, PNG-, WebP-, HEIC- of HEIF-afbeeldingen van maximaal 30 MB elk, met zijden van 256 tot 5.760 pixels en verhoudingen van 0.4 tot 2.5. De openings- en eindrol staan elk één afbeelding toe; de referentiemodus staat maximaal negen afbeeldingen toe. Zorg voor een duidelijk zicht op het onderwerp en 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. Gedocumenteerd zijn H.264- of H.265-video, AAC- of MP3-audio, zijden van 256 tot 5.760 pixels, verhoudingen van 0.4 tot 2.5 en een beeldsnelheid van 23.976 tot 60. Referentieaudio staat maximaal drie WAV- of MP3-clips toe, elk maximaal 15 MB en 2–15 seconden, samen maximaal 15 seconden. De aanvraagbody heeft een afzonderlijke limiet van 64 MB.

Gebruik alleen referenties die bijdragen aan het shot 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 beoogde duur en uitvoerresolutie expliciet, zodat je het resultaat met dezelfde briefing kan vergelijken.

Het afgewerkte resultaat

De asynchrone workflow van de maker geeft een taak-ID terug voordat de voltooide video beschikbaar is. Met de interface voor taakopvraging kan je taken uit de voorgaande zeven dagen ophalen. Bewaar de daadwerkelijke teruggestuurde clip en de specificaties 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 wil behouden.

Beoordeel continuïteit van het onderwerp, beweging, zichtbare tekst, dialoog en geluidstiming op de grootte waarop de clip zal worden gebruikt. Gebruik concrete feedback voor een volgende creatieve briefing: het veranderde gebaar, de weggelaten zin of de kadrering die moet worden aangepast. Het bruikbare resultaat is een kort audiovisueel shot dat aansluit op de aangeleverde inhoud en de expliciet beschreven relaties met referenties.

", "aboutText": "Een snelle H3-variant met verdere training\n\nMiniMax H3 Max is een verder getrainde 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 aanvullende training na de basistraining. Hij behoudt een geïntegreerde multimodale context en standaard gesynchroniseerd beeld en geluid. Snelheid is een ontwerpprioriteit, geen vaste voltooiingstijd voor elke prompt, duur of toepassing.\n\nMaak onderscheid tussen Max, het oorspronkelijke H3-systeem en de afzonderlijke Max Turbo-variant. De huidige interface van MiniMax vermeldt voor Max 480P of 768P, met 768P als standaard, 24 beelden per seconde en een duur van 5 tot 15 seconden, opgegeven in gehele seconden. De gedocumenteerde Max-workflow biedt geen 2K-instelling of uitvoer van vier seconden zoals het oorspronkelijke H3-systeem.\n\nVan prompt naar shot\n\nElke generatie bevat een niet-lege tekstbriefing, met maximaal 7.000 tekens per tekstonderdeel. Beschrijf onderwerp, begincompositie, actie en resultaat en geef vervolgens duidelijke camera- en geluidsaanwijzingen. Bepaal voor een korte onthulling van een object wat de kijker eerst 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 plaatst, een kleine camerabeweging naar voren en het geluid van keramiek op hout. Hou de actie beperkt genoeg voor de gekozen duur en controleer of de beweging en het geluid in het resultaat dezelfde gebeurtenis volgen.\n\nCreatie met framebeelden\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 tussendoor een onverenigbare scène introduceert.\n\nUitvoer op basis van framebeelden neemt de beeldverhouding over van 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. Werk op basis van referenties kan een adaptieve verhouding of een van de gedocumenteerde expliciete opties gebruiken. Stem de referentie of geschreven scène af op het doelformaat; ga er niet van uit dat dezelfde opstelling even goed werkt in staand en liggend formaat.\n\nMultimodale referenties\n\nHet huidige Max-generatieschema van MiniMax documenteert ook referentiebeelden, video en audio. Geef aan wat elk element moet beïnvloeden: de identiteit van een personage, een omgeving, een bewegingspatroon, een cameratraject, een stemtimbre of een geluidskenmerk. Rollen als eerste/laatste frame en rollen als referentiemedia sluiten elkaar in die interface uit.\n\nDuid bij een personageshot de uiterlijke referentie en de bewegingsreferentie afzonderlijk aan en geef daarna de beoogde actie en gesproken zin. Een stemreferentie die de voordracht bepaalt, is iets anders dan het volledige audiosignaal kopiëren. Wees expliciet over de te behouden kenmerken en gewenste wijzigingen en vergelijk de daadwerkelijke audiovisuele clip met elke referentierol.\n\nPromptuitbreiding\n\nDe Max-specifieke instelling voor uitbreiding biedt disabled, balanced en quality, met balanced als standaard. Kies disabled wanneer de aangeleverde briefing zonder uitbreiding moet worden verwerkt; gebruik een gedocumenteerde uitbreidingsmodus wanneer extra interpretatie gewenst is. Bewaar de oorspronkelijke briefing om een door de uitbreiding ingevoerde wijziging te kunnen onderscheiden van de gevraagde inhoud.\n\nBeschrijf geluid als deel van de scène. Benoem fysieke geluiden, omgevingsgeluid en gesproken woorden en onderscheid die van achtergrondmuziek die alleen het publiek hoort. Geef de exacte zin en bedoelde spreker op in plaats van onbepaalde dialoog te vragen. Beluister het resultaat ook; een overtuigend beeld bewijst niet dat de gesproken formulering of timing juist is.\n\nInvoer voorbereiden en limieten\n\nHet huidige schema van de fabrikant accepteert JPG-, JPEG-, PNG-, WebP-, HEIC- of HEIF-afbeeldingen van maximaal 30 MB elk, met zijden van 256 tot 5.760 pixels en verhoudingen van 0.4 tot 2.5. De openings- en eindrol staan elk één afbeelding toe; de referentiemodus staat maximaal negen afbeeldingen toe. Zorg voor een duidelijk zicht op het onderwerp en 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. Gedocumenteerd zijn H.264- of H.265-video, AAC- of MP3-audio, zijden van 256 tot 5.760 pixels, verhoudingen van 0.4 tot 2.5 en een beeldsnelheid van 23.976 tot 60. Referentieaudio staat maximaal drie WAV- of MP3-clips toe, elk maximaal 15 MB en 2–15 seconden, samen maximaal 15 seconden. De aanvraagbody heeft een afzonderlijke limiet van 64 MB.\n\nGebruik alleen referenties die bijdragen aan het shot 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 beoogde duur en uitvoerresolutie expliciet, zodat je het resultaat met dezelfde briefing kan vergelijken.\n\nHet afgewerkte resultaat\n\nDe asynchrone workflow van de maker geeft een taak-ID terug voordat de voltooide video beschikbaar is. Met de interface voor taakopvraging kan je taken uit de voorgaande zeven dagen ophalen. Bewaar de daadwerkelijke teruggestuurde clip en de specificaties 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 wil behouden.\n\nBeoordeel continuïteit van het onderwerp, beweging, zichtbare tekst, dialoog en geluidstiming op de grootte waarop de clip zal worden gebruikt. Gebruik concrete feedback voor een volgende creatieve briefing: het veranderde gebaar, de weggelaten zin of de kadrering die moet worden aangepast. Het bruikbare resultaat is een kort audiovisueel shot dat aansluit op de aangeleverde inhoud en de expliciet beschreven relaties met referenties.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "3317f91558cff36dea95f7c6f8b906d93ad4b1c7c7b5af4028a8aa607e47cda9", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl-be", "methods": [ { "html": "
MM

MiniMax: H3 Max

MiniMax /minimax/hailuo-3-max

Aan de slag

MiniMax H3 Max is een snelle H3-variant die achteraf verder is getraind, voor korte video met gesynchroniseerde audio. De gedocumenteerde workflow van MiniMax ondersteunt tekst, framebeelden 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 H3-variant met verdere training

MiniMax H3 Max is een verder getrainde 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 aanvullende training na de basistraining. Hij behoudt een geïntegreerde multimodale context en standaard gesynchroniseerd beeld en geluid. Snelheid is een ontwerpprioriteit, geen vaste voltooiingstijd voor elke prompt, duur of toepassing.

Maak onderscheid tussen Max, het oorspronkelijke H3-systeem en de afzonderlijke Max Turbo-variant. De huidige interface van MiniMax vermeldt voor Max 480P of 768P, met 768P als standaard, 24 beelden per seconde en een duur van 5 tot 15 seconden, opgegeven in gehele seconden. De gedocumenteerde Max-workflow biedt geen 2K-instelling of uitvoer van vier seconden zoals het oorspronkelijke H3-systeem.

Van prompt naar shot

Elke generatie bevat een niet-lege tekstbriefing, met maximaal 7.000 tekens per tekstonderdeel. Beschrijf onderwerp, begincompositie, actie en resultaat en geef vervolgens duidelijke camera- en geluidsaanwijzingen. Bepaal voor een korte onthulling van een object wat de kijker eerst 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 plaatst, een kleine camerabeweging naar voren en het geluid van keramiek op hout. Hou de actie beperkt genoeg voor de gekozen duur en controleer of de beweging en het geluid in het resultaat dezelfde gebeurtenis volgen.

Creatie met framebeelden

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 tussendoor een onverenigbare scène introduceert.

Uitvoer op basis van framebeelden neemt de beeldverhouding over van 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. Werk op basis van referenties kan een adaptieve verhouding of een van de gedocumenteerde expliciete opties gebruiken. Stem de referentie of geschreven scène af op het doelformaat; ga er niet van uit dat dezelfde opstelling even goed werkt in staand en liggend formaat.

Multimodale referenties

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

Duid bij een personageshot de uiterlijke referentie en de bewegingsreferentie afzonderlijk aan en geef daarna de beoogde actie en gesproken zin. Een stemreferentie die de voordracht bepaalt, is iets anders dan het volledige audiosignaal kopiëren. Wees expliciet over de te behouden kenmerken en gewenste wijzigingen en vergelijk de daadwerkelijke audiovisuele clip met elke referentierol.

Promptuitbreiding

De Max-specifieke instelling voor uitbreiding biedt disabled, balanced en quality, met balanced als standaard. Kies disabled wanneer de aangeleverde briefing zonder uitbreiding moet worden verwerkt; gebruik een gedocumenteerde uitbreidingsmodus wanneer extra interpretatie gewenst is. Bewaar de oorspronkelijke briefing om een door de uitbreiding ingevoerde wijziging te kunnen onderscheiden van de gevraagde inhoud.

Beschrijf geluid als deel van de scène. Benoem fysieke geluiden, omgevingsgeluid en gesproken woorden en onderscheid die van achtergrondmuziek die alleen het publiek hoort. Geef de exacte zin en bedoelde spreker op in plaats van onbepaalde dialoog te vragen. Beluister het resultaat ook; een overtuigend beeld bewijst niet dat de gesproken formulering of timing juist is.

Invoer voorbereiden en limieten

Het huidige schema van de fabrikant accepteert JPG-, JPEG-, PNG-, WebP-, HEIC- of HEIF-afbeeldingen van maximaal 30 MB elk, met zijden van 256 tot 5.760 pixels en verhoudingen van 0.4 tot 2.5. De openings- en eindrol staan elk één afbeelding toe; de referentiemodus staat maximaal negen afbeeldingen toe. Zorg voor een duidelijk zicht op het onderwerp en 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. Gedocumenteerd zijn H.264- of H.265-video, AAC- of MP3-audio, zijden van 256 tot 5.760 pixels, verhoudingen van 0.4 tot 2.5 en een beeldsnelheid van 23.976 tot 60. Referentieaudio staat maximaal drie WAV- of MP3-clips toe, elk maximaal 15 MB en 2–15 seconden, samen maximaal 15 seconden. De aanvraagbody heeft een afzonderlijke limiet van 64 MB.

Gebruik alleen referenties die bijdragen aan het shot 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 beoogde duur en uitvoerresolutie expliciet, zodat je het resultaat met dezelfde briefing kan vergelijken.

Het afgewerkte resultaat

De asynchrone workflow van de maker geeft een taak-ID terug voordat de voltooide video beschikbaar is. Met de interface voor taakopvraging kan je taken uit de voorgaande zeven dagen ophalen. Bewaar de daadwerkelijke teruggestuurde clip en de specificaties 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 wil behouden.

Beoordeel continuïteit van het onderwerp, beweging, zichtbare tekst, dialoog en geluidstiming op de grootte waarop de clip zal worden gebruikt. Gebruik concrete feedback voor een volgende creatieve briefing: het veranderde gebaar, de weggelaten zin of de kadrering die moet worden aangepast. Het bruikbare resultaat is een kort audiovisueel shot dat aansluit op de aangeleverde inhoud en de expliciet beschreven relaties met referenties.

Beschikbaar in Ailoot · invoer en methoden

Ailoot Ultra · Video POST /v1/videos
Invoer
text, image
Uitvoer
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 hoogstens één keer voor.
Exacte sleutels: type, image_url, frame_type
Voorwaarden: Deze sleutels beschrijven elk frameobject; image_url bevat alleen url. Laat frame_images weg bij een aanvraag met uitsluitend tekst.
Standaard—
Veldinput_referencesTypearrayVereisteOptioneelWaarden en limietenStandaard—
Veldcallback_urlTypestringVereisteOptioneelWaarden en limieten
Patroon: ^https://
Standaard—
Veldsession_idTypestringVereisteOptioneelWaarden en limietenStandaard—
VeldtraceTypeobjectVereisteOptioneelWaarden en limietenStandaard—
VelduserTypestringVereisteOptioneelWaarden en limietenStandaard—
Combinaties van invoermaterialen

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

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

model: Type: string · minimax/hailuo-3-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 hoogstens één keer 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 getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.

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

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

Geschatte tarieven ter vergelijking

Prijzen per configuratie

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

ConfiguratieTariefstaffelVerwachte 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
ConfiguratieVideouitvoer · 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 raming is geen extra kost of vast tarief voor de voltooide generatie.

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

Details van het referentietarief

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

Prijsreferenties voor videoconfiguraties

Prijzen per configuratie

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

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

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

ConfiguratieVideoprijsFactureringsvoorwaardenresolution: 480pKosten
Uitvoer · Videoprijs $0.1 per videoseconde

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

ConfiguratieVideoprijsFactureringsvoorwaardenresolution: 768pKosten
Uitvoer · Videoprijs $0.16 per videoseconde

Gepubliceerde prijsreferentie voor de getoonde 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-URL's die je toebehoren

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

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

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

Als het oorspronkelijke antwoord moet worden gecontroleerd

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

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

Aliasnamen

Modelaliasnamen

Ailoot Ultra minimax/hailuo-3-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 getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Bewaar alle werkelijke uitvoer die je toebehoort en de teruggestuurde meetgegevens.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Toegang tot de video is niet beschikbaar, of deze video-ID werd niet gevonden.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Controleer de toegang tot de video. Gebruik voor een bestaande video de oorspronkelijke openbare ID en dezelfde API-sleutel.", "type": "not_found_error" }, { "condition": "De API-sleutel komt niet overeen met het geauthenticeerde account.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Controleer je API-sleutel en accounttoegang voordat je de aanvraag indient.", "type": "authentication_error" }, { "condition": "De aanvraag kon niet worden gelezen, of de downloadindex is ongeldig.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrigeer de aanvraaginhoud. Kies voor een download een uitvoerindex die door de oorspronkelijke taak is teruggestuurd.", "type": "invalid_request_error" }, { "condition": "Voor de geselecteerde videoconfiguratie kan geen prijs worden bepaald.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Kies een ondersteunde videoconfiguratie en vul alle verplichte opties in voordat je een gecorrigeerde aanvraag indient.", "type": "price_unavailable" }, { "condition": "Een video-invoer of oorspronkelijke vervolgtaak is ongeldig.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Gebruik geldige HTTPS-invoer. Gebruik voor een vervolg je voltooide oorspronkelijke openbare video-ID met dezelfde API-sleutel.", "type": "invalid_request_error" }, { "condition": "Het beschikbare saldo of de limieten laten geen reservering toe.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Controleer je beschikbare saldo en limieten voordat je een nieuwe aanvraag verstuurt.", "type": "billing_error" }, { "condition": "Videocontrole, opslag of toegang tot de dienst is tijdelijk niet beschikbaar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Wacht tot de dienst beschikbaar is. Als je al een video-ID hebt, controleer dan die oorspronkelijke taak in plaats van een nieuwe generatie aan te maken.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Het oorspronkelijke videoresultaat en de aanrekening moeten worden gecontroleerd.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Bewaar de teruggestuurde video-ID en controleer die taak. Verstuur geen vervangende generatieaanvraag zolang de controle loopt.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "De bestaande videodownload is tijdelijk niet beschikbaar.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Controleer later dezelfde videotaak en download de bestaande uitvoer ervan. Een nieuwe generatie maakt een afzonderlijke operatie aan.", "type": "server_error" }, { "condition": "De video-inhoud is niet gepubliceerd.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Controleer de oorspronkelijke taakstatus. Download zodra de status completed is; volg bij failed de melding over de controle van de aanrekening.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + oorspronkelijke id + X-Should-Retry:false; voer de oorspronkelijke aanvraag nooit opnieuw uit" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Geef prompt op als tekst en duration als een geheel aantal seconden. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.", "required": [ "model", "prompt", "duration" ], "required_material": "Een geschreven prompt." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3-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 hoogstens één keer 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-hash van de oorspronkelijke videobytes; null als die niet beschikbaar is.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Grootte van het oorspronkelijke videobestand in bytes; null als die niet beschikbaar is.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Gemeten videoduur in milliseconden; null als die niet beschikbaar is.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videobreedte in pixels; null als die niet beschikbaar is.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videohoogte in pixels; null als die niet beschikbaar is.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identificatiecode van de videocodec; null als die niet is vastgelegd.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Of de video een audiotrack bevat; null als dit niet is gemeten.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identificatiecode van de audiocodec; null als er geen identificatiecode is vastgelegd.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "ondertekende inhouds-URL's die je toebehoren", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-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 alleen url. Laat frame_images weg bij een aanvraag met uitsluitend tekst.", "content": "Array met frameobjecten. Elk object bevat type=image_url, image_url met daarin url, en frame_type. Gebruik een HTTPS-afbeeldings-URL en stel frame_type in op first_frame of last_frame. Elke framerol komt hoogstens één keer voor.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "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": "Videouitvoer · 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 raming is geen extra kost 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": "bd9889160fdb38f2dbce36db4afb6b4061ce0a5b5e70d0f3cc4886feb22504d2", "input_html_sha256": "01a3240cfc33be0b2d95e5f11863b48012b6d67925ca61fc528c93382115bcec", "private_audit_sha256": "848a98813ecd56473c8990bcd776845517a533c91492945dfe09c2cd5f3b1f9a", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/nl-be/minimax-hailuo-3-max/", "description": "MiniMax H3 Max is een snelle H3-variant die achteraf verder is getraind, voor korte video met gesynchroniseerde audio. De gedocumenteerde workflow van MiniMax ondersteunt tekst, framebeelden en multimodale referenties, met uitvoer in 480P of 768P, een duur van 5–15 seconden en eigen opties voor promptuitbreiding.", "locale": "nl-be", "md_url": "https://ailoot.ai/models/nl-be/minimax-hailuo-3-max/index.md", "title": "MiniMax: H3 Max — Ailoot", "url": "https://ailoot.ai/models/nl-be/minimax-hailuo-3-max/" }, "rawModel": { "about": "Een snelle H3-variant met verdere training\n\nMiniMax H3 Max is een verder getrainde 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 aanvullende training na de basistraining. Hij behoudt een geïntegreerde multimodale context en standaard gesynchroniseerd beeld en geluid. Snelheid is een ontwerpprioriteit, geen vaste voltooiingstijd voor elke prompt, duur of toepassing.\n\nMaak onderscheid tussen Max, het oorspronkelijke H3-systeem en de afzonderlijke Max Turbo-variant. De huidige interface van MiniMax vermeldt voor Max 480P of 768P, met 768P als standaard, 24 beelden per seconde en een duur van 5 tot 15 seconden, opgegeven in gehele seconden. De gedocumenteerde Max-workflow biedt geen 2K-instelling of uitvoer van vier seconden zoals het oorspronkelijke H3-systeem.\n\nVan prompt naar shot\n\nElke generatie bevat een niet-lege tekstbriefing, met maximaal 7.000 tekens per tekstonderdeel. Beschrijf onderwerp, begincompositie, actie en resultaat en geef vervolgens duidelijke camera- en geluidsaanwijzingen. Bepaal voor een korte onthulling van een object wat de kijker eerst 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 plaatst, een kleine camerabeweging naar voren en het geluid van keramiek op hout. Hou de actie beperkt genoeg voor de gekozen duur en controleer of de beweging en het geluid in het resultaat dezelfde gebeurtenis volgen.\n\nCreatie met framebeelden\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 tussendoor een onverenigbare scène introduceert.\n\nUitvoer op basis van framebeelden neemt de beeldverhouding over van 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. Werk op basis van referenties kan een adaptieve verhouding of een van de gedocumenteerde expliciete opties gebruiken. Stem de referentie of geschreven scène af op het doelformaat; ga er niet van uit dat dezelfde opstelling even goed werkt in staand en liggend formaat.\n\nMultimodale referenties\n\nHet huidige Max-generatieschema van MiniMax documenteert ook referentiebeelden, video en audio. Geef aan wat elk element moet beïnvloeden: de identiteit van een personage, een omgeving, een bewegingspatroon, een cameratraject, een stemtimbre of een geluidskenmerk. Rollen als eerste/laatste frame en rollen als referentiemedia sluiten elkaar in die interface uit.\n\nDuid bij een personageshot de uiterlijke referentie en de bewegingsreferentie afzonderlijk aan en geef daarna de beoogde actie en gesproken zin. Een stemreferentie die de voordracht bepaalt, is iets anders dan het volledige audiosignaal kopiëren. Wees expliciet over de te behouden kenmerken en gewenste wijzigingen en vergelijk de daadwerkelijke audiovisuele clip met elke referentierol.\n\nPromptuitbreiding\n\nDe Max-specifieke instelling voor uitbreiding biedt disabled, balanced en quality, met balanced als standaard. Kies disabled wanneer de aangeleverde briefing zonder uitbreiding moet worden verwerkt; gebruik een gedocumenteerde uitbreidingsmodus wanneer extra interpretatie gewenst is. Bewaar de oorspronkelijke briefing om een door de uitbreiding ingevoerde wijziging te kunnen onderscheiden van de gevraagde inhoud.\n\nBeschrijf geluid als deel van de scène. Benoem fysieke geluiden, omgevingsgeluid en gesproken woorden en onderscheid die van achtergrondmuziek die alleen het publiek hoort. Geef de exacte zin en bedoelde spreker op in plaats van onbepaalde dialoog te vragen. Beluister het resultaat ook; een overtuigend beeld bewijst niet dat de gesproken formulering of timing juist is.\n\nInvoer voorbereiden en limieten\n\nHet huidige schema van de fabrikant accepteert JPG-, JPEG-, PNG-, WebP-, HEIC- of HEIF-afbeeldingen van maximaal 30 MB elk, met zijden van 256 tot 5.760 pixels en verhoudingen van 0.4 tot 2.5. De openings- en eindrol staan elk één afbeelding toe; de referentiemodus staat maximaal negen afbeeldingen toe. Zorg voor een duidelijk zicht op het onderwerp en 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. Gedocumenteerd zijn H.264- of H.265-video, AAC- of MP3-audio, zijden van 256 tot 5.760 pixels, verhoudingen van 0.4 tot 2.5 en een beeldsnelheid van 23.976 tot 60. Referentieaudio staat maximaal drie WAV- of MP3-clips toe, elk maximaal 15 MB en 2–15 seconden, samen maximaal 15 seconden. De aanvraagbody heeft een afzonderlijke limiet van 64 MB.\n\nGebruik alleen referenties die bijdragen aan het shot 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 beoogde duur en uitvoerresolutie expliciet, zodat je het resultaat met dezelfde briefing kan vergelijken.\n\nHet afgewerkte resultaat\n\nDe asynchrone workflow van de maker geeft een taak-ID terug voordat de voltooide video beschikbaar is. Met de interface voor taakopvraging kan je taken uit de voorgaande zeven dagen ophalen. Bewaar de daadwerkelijke teruggestuurde clip en de specificaties 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 wil behouden.\n\nBeoordeel continuïteit van het onderwerp, beweging, zichtbare tekst, dialoog en geluidstiming op de grootte waarop de clip zal worden gebruikt. Gebruik concrete feedback voor een volgende creatieve briefing: het veranderde gebaar, de weggelaten zin of de kadrering die moet worden aangepast. Het bruikbare resultaat is een kort audiovisueel shot dat aansluit op de aangeleverde inhoud en de expliciet beschreven relaties met 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 getoonde configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie.", "dimensions": { "conditions": "In deze prijssleutel is geen bijkomende voorwaarde opgegeven." }, "label": "Videoprijs", "units": [ { "amount": "0.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 getoonde 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 getoonde 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 getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Bewaar alle werkelijke uitvoer die je toebehoort en de teruggestuurde meetgegevens.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Toegang tot de video is niet beschikbaar, of deze video-ID werd niet gevonden.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Controleer de toegang tot de video. Gebruik voor een bestaande video de oorspronkelijke openbare ID en dezelfde API-sleutel.", "type": "not_found_error" }, { "condition": "De API-sleutel komt niet overeen met het geauthenticeerde account.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Controleer je API-sleutel en accounttoegang voordat je de aanvraag indient.", "type": "authentication_error" }, { "condition": "De aanvraag kon niet worden gelezen, of de downloadindex is ongeldig.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrigeer de aanvraaginhoud. Kies voor een download een uitvoerindex die door de oorspronkelijke taak is teruggestuurd.", "type": "invalid_request_error" }, { "condition": "Voor de geselecteerde videoconfiguratie kan geen prijs worden bepaald.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Kies een ondersteunde videoconfiguratie en vul alle verplichte opties in voordat je een gecorrigeerde aanvraag indient.", "type": "price_unavailable" }, { "condition": "Een video-invoer of oorspronkelijke vervolgtaak is ongeldig.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Gebruik geldige HTTPS-invoer. Gebruik voor een vervolg je voltooide oorspronkelijke openbare video-ID met dezelfde API-sleutel.", "type": "invalid_request_error" }, { "condition": "Het beschikbare saldo of de limieten laten geen reservering toe.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Controleer je beschikbare saldo en limieten voordat je een nieuwe aanvraag verstuurt.", "type": "billing_error" }, { "condition": "Videocontrole, opslag of toegang tot de dienst is tijdelijk niet beschikbaar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Wacht tot de dienst beschikbaar is. Als je al een video-ID hebt, controleer dan die oorspronkelijke taak in plaats van een nieuwe generatie aan te maken.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Het oorspronkelijke videoresultaat en de aanrekening moeten worden gecontroleerd.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Bewaar de teruggestuurde video-ID en controleer die taak. Verstuur geen vervangende generatieaanvraag zolang de controle loopt.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "De bestaande videodownload is tijdelijk niet beschikbaar.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Controleer later dezelfde videotaak en download de bestaande uitvoer ervan. Een nieuwe generatie maakt een afzonderlijke operatie aan.", "type": "server_error" }, { "condition": "De video-inhoud is niet gepubliceerd.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Controleer de oorspronkelijke taakstatus. Download zodra de status completed is; volg bij failed de melding over de controle van de aanrekening.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + oorspronkelijke id + X-Should-Retry:false; voer de oorspronkelijke aanvraag nooit opnieuw uit" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Geef prompt op als tekst en duration als een geheel aantal seconden. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.", "required": [ "model", "prompt", "duration" ], "required_material": "Een geschreven prompt." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3-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 hoogstens één keer 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-hash van de oorspronkelijke videobytes; null als die niet beschikbaar is.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Grootte van het oorspronkelijke videobestand in bytes; null als die niet beschikbaar is.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Gemeten videoduur in milliseconden; null als die niet beschikbaar is.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videobreedte in pixels; null als die niet beschikbaar is.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videohoogte in pixels; null als die niet beschikbaar is.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identificatiecode van de videocodec; null als die niet is vastgelegd.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Of de video een audiotrack bevat; null als dit niet is gemeten.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identificatiecode van de audiocodec; null als er geen identificatiecode is vastgelegd.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "ondertekende inhouds-URL's die je toebehoren", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-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 alleen url. Laat frame_images weg bij een aanvraag met uitsluitend tekst.", "content": "Array met frameobjecten. Elk object bevat type=image_url, image_url met daarin url, en frame_type. Gebruik een HTTPS-afbeeldings-URL en stel frame_type in op first_frame of last_frame. Elke framerol komt hoogstens één keer voor.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "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": "Videouitvoer · 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 raming is geen extra kost 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 H3-variant die achteraf verder is getraind, voor korte video met gesynchroniseerde audio. De gedocumenteerde workflow van MiniMax ondersteunt tekst, framebeelden 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 H3-variant die achteraf verder is getraind, voor korte video met gesynchroniseerde audio. De gedocumenteerde workflow van MiniMax ondersteunt tekst, framebeelden 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": "f2a953c3cad78b42e3b76c42aa7633bb9a280fd917bd10b3d8e93b31c6acd157", "renderer_sha256": "a5aefc67f30427b283b8d8bf7955908a0216c6e5e4ca3cc1887842431e2b1ee6" }, "sourceRevision": "51861aa910d701f29b9c97d81d41949be15ce69dabeaddf380d1f5c371623fe5" }