Eén audiovisueel resultaat uit een multimodale briefing
MiniMax H3 is het omnimodale videosysteem van MiniMax. Het interpreteert tekst, afbeeldingen, video en audio samen en genereert vervolgens video met door het model zelf gegenereerd stereogeluid. De maker presenteert het voor kort creatief werk zoals productbeelden, reclame, geanimeerde posters en concepten voor filmtitels, waarbij de onderlinge relaties tussen referentiematerialen even belangrijk zijn als de scènebeschrijving.
Het gedocumenteerde systeem produceert video's van 4–15 seconden met 24 beelden per seconde en 32 kHz-stereogeluid. H3-Base genereert in 768p; de volledige 2K-procedure genereert dat resultaat opnieuw met de oorspronkelijke multimodale context. Dit gaat verder dan conventioneel vergroten: de tweede fase gebruikt het model en de broncontext opnieuw om fijne details terug te halen. H3 Max en H3-Context-IR hebben afzonderlijke rollen en limieten.
Creatie met tekst en framebegeleiding
Invoer met alleen tekst beschrijft de volledige audiovisuele tijdlijn. Een eerste afbeelding verankert de opening, een laatste afbeelding het einde en twee afbeeldingen kunnen beide vastleggen. Begin voor een shot vanaf het eerste frame met de compositie en identiteit die in het stilstaande beeld zichtbaar zijn en beschrijf daarna de handeling die daaruit ontstaat. Beschrijf voor een overgang van het eerste naar het laatste frame de waarneembare beweging die de twee toestanden verbindt, in plaats van twee losstaande afbeeldingsbeschrijvingen te herhalen.
Een praktische productbriefing kan een gesloten verpakking in het openingsframe specificeren, de hand die deze opent, de rustige beweging van de camera en de gewenste eindtoestand. Behoud de vorm van het object, de plaats van het etiket en de belichting in de aangeleverde frames. Framegestuurde en referentiegestuurde creatie zijn afzonderlijke invoermodi; de interface van de maker mengt rollen voor het eerste/laatste frame niet met rollen voor referentiemedia in één aanvraag.
Referentiegestuurde generatie en bewerking
De referentiemodus accepteert tekst met afbeeldingen, videoclips en audioclips. Benoem wat elke bron bijdraagt: het uiterlijk van een personage, een locatie, camerabeweging, de tijdsstructuur van een bronclip of een stem. Een video die alleen voor camerabeweging wordt gebruikt, verschilt van een video die daadwerkelijk bewerkt of voortgezet moet worden. Benoem die relatie expliciet.
De referentiegids van de maker onderscheidt onderwerpdefinities, een taaksamenvatting, een analyse van wat behouden moet blijven, een gedetailleerde shotbeschrijving, het totale geluidsbeeld en achtergrondmuziek die alleen het publiek hoort. De gids onderscheidt het behouden van zichtbare inhoud van het overnemen van eigenschappen of een brede stijlreferentie. Bij audio verschilt het kopiëren van een signaal van het gebruiken van klankkleur, ritme of voordracht als referentie. Houd die rollen in de hele briefing gelijk.
Lever voor een referentiegestuurde scène een personageafbeelding, een korte referentie voor camerabeweging en een audioreferentie voor de stem aan en beschrijf vervolgens waar elk daarvan het doelshot moet beïnvloeden. Geef aan welke kleding-, omgevings- of objectdetails herkenbaar moeten blijven. Vergelijk de voltooide clip met die eisen, inclusief bewegingscontinuïteit en de relatie tussen de zichtbare spreker en de hoorbare stem.
Spraak, geluid en shottiming
H3 modelleert dialoog, fysieke geluiden, omgevingsgeluid en muziek gezamenlijk. De modelkaart documenteert stabiele dialoogondersteuning voor Arabisch, Chinees, Engels, Frans, Duits, Italiaans, Japans, Koreaans, Portugees, Russisch en Spaans; voor andere talen wordt wisselende ondersteuning beschreven. Geef de exacte gesproken woorden en taal op, met een consistente sprekeridentiteit tussen shots.
De promptgidsen van de maker gebruiken Engels voor beschrijvende onderdelen, terwijl dialoog en zichtbare tekst in hun oorspronkelijke taal behouden blijven. Gesproken inhoud gebruikt <d>[Language] ...</d>, met de sprekeridentiteit en stembeschrijving buiten het blok. Onderscheid fysieke spraak van een voice-over buiten beeld en geef aan wanneer een zin doorloopt over een montageovergang of wordt afgebroken door het einde. Behoud zichtbare tekst eveneens exact. Stem de hoeveelheid spraak af op de gekozen duur en controleer de weergegeven woorden samen met de hoorbare zin.
Beschrijf camerabeweging als een handeling, inclusief bereik en snelheid wanneer die relevant zijn. Nummer shots in afspeelvolgorde en houd de tijdstippen van cuts binnen de videoduur. Onderscheid scènegeluiden zoals voetstappen of een sluitende deur van achtergrondmuziek die alleen het publiek hoort. Deze keuzes maken een kort shotplan gemakkelijker te interpreteren en aan het resultaat te toetsen.
Invoervoorbereiding en numerieke limieten
Het huidige generatieschema vereist niet-lege tekst in elke modus, met maximaal 7000 tekens per tekstonderdeel. Afbeeldingen kunnen JPG, JPEG, PNG, WebP, HEIC of HEIF zijn, maximaal 30 MB per stuk, met elke zijde van 256 tot 5760 pixels en een beeldverhouding van 0,4 tot 2,5. Frame-invoer staat één openings- en één eindafbeelding toe; de referentiemodus staat maximaal negen referentieafbeeldingen toe.
Referentievideo kan maximaal drie MP4- of MOV-clips bevatten, elk 2–15 seconden en samen maximaal 15 seconden. Een clip mag maximaal 50 MB zijn; de videocodec is H.264 of H.265, met AAC- of MP3-audio, zijden van 256 tot 5760 pixels, verhoudingen van 0,4 tot 2,5 en een framerate van 23,976 tot 60. Referentieaudio ondersteunt maximaal drie WAV- of MP3-clips, maximaal 15 MB per stuk, elk 2–15 seconden en samen maximaal 15 seconden. De modelkaart beperkt gemengde referentie-invoer tot 12 bestanden. De gedocumenteerde limiet voor de requestbody is 64 MB, los van de limieten per bestand.
Kies alleen referenties die bijdragen aan de briefing en maak elke bijdrage expliciet. Een duidelijk zicht op het onderwerp is bruikbaarder dan verschillende tegenstrijdige weergaven zonder uitleg. Behoud de referentievolgorde, snijd irrelevant materiaal weg zonder noodzakelijke scènecontext te verwijderen en controleer of korte bronclips de gevraagde handeling of stemkenmerken bevatten.
Uitvoerformaat en het volledige systeem
De H3-interface van de fabrikant biedt 768P en 2K. Generatie met alleen tekst vereist een concrete verhouding: 21:9, 16:9, 4:3, 1:1, 3:4 of 9:16. Creatie met een eerste/laatste frame ontleent de beeldverhouding aan de invoerafbeelding; referentiecreatie kan een adaptieve of expliciete verhouding gebruiken. De uitvoerduur is een geheel aantal seconden van 4 tot 15.
De modelkaart onderscheidt H3-Context-IR, dat de briefing interpreteert en verrijkt, H3-Base, dat audiovisuele inhoud genereert, en H3-Regenerate-2K, dat het resultaat met hogere resolutie maakt. De vrijgegeven basischeckpoints scheiden framegestuurde taken van omnireferentietaken. De context- en regeneratiecomponenten staan los van die basisgewichten, dus alleen de naam van een open checkpoint bewijst niet het gedrag van het volledige systeem.
De generatieprocedure van de maker is asynchroon. Via de taakquery-interface zijn taken uit de voorgaande zeven dagen op te vragen. Bewaar de taak-ID totdat het daadwerkelijke videoresultaat wordt geretourneerd en sla daarna de clip op, in plaats van alleen een tijdelijk downloadadres te bewaren. Beoordeel visuele identiteit, kleine tekst, objectinteracties, gesproken inhoud en geluidstiming op het beoogde kijkformaat. De fabrikant noemt multimodaal begrip en fijne visuele details als gebieden waarop verbetering doorgaat; een gedetailleerde briefing en vergelijking met de bronnen blijven essentieel voor een bruikbaar resultaat.
", "aboutText": "Eén audiovisueel resultaat uit een multimodale briefing\n\nMiniMax H3 is het omnimodale videosysteem van MiniMax. Het interpreteert tekst, afbeeldingen, video en audio samen en genereert vervolgens video met door het model zelf gegenereerd stereogeluid. De maker presenteert het voor kort creatief werk zoals productbeelden, reclame, geanimeerde posters en concepten voor filmtitels, waarbij de onderlinge relaties tussen referentiematerialen even belangrijk zijn als de scènebeschrijving.\n\nHet gedocumenteerde systeem produceert video's van 4–15 seconden met 24 beelden per seconde en 32 kHz-stereogeluid. H3-Base genereert in 768p; de volledige 2K-procedure genereert dat resultaat opnieuw met de oorspronkelijke multimodale context. Dit gaat verder dan conventioneel vergroten: de tweede fase gebruikt het model en de broncontext opnieuw om fijne details terug te halen. H3 Max en H3-Context-IR hebben afzonderlijke rollen en limieten.\n\nCreatie met tekst en framebegeleiding\n\nInvoer met alleen tekst beschrijft de volledige audiovisuele tijdlijn. Een eerste afbeelding verankert de opening, een laatste afbeelding het einde en twee afbeeldingen kunnen beide vastleggen. Begin voor een shot vanaf het eerste frame met de compositie en identiteit die in het stilstaande beeld zichtbaar zijn en beschrijf daarna de handeling die daaruit ontstaat. Beschrijf voor een overgang van het eerste naar het laatste frame de waarneembare beweging die de twee toestanden verbindt, in plaats van twee losstaande afbeeldingsbeschrijvingen te herhalen.\n\nEen praktische productbriefing kan een gesloten verpakking in het openingsframe specificeren, de hand die deze opent, de rustige beweging van de camera en de gewenste eindtoestand. Behoud de vorm van het object, de plaats van het etiket en de belichting in de aangeleverde frames. Framegestuurde en referentiegestuurde creatie zijn afzonderlijke invoermodi; de interface van de maker mengt rollen voor het eerste/laatste frame niet met rollen voor referentiemedia in één aanvraag.\n\nReferentiegestuurde generatie en bewerking\n\nDe referentiemodus accepteert tekst met afbeeldingen, videoclips en audioclips. Benoem wat elke bron bijdraagt: het uiterlijk van een personage, een locatie, camerabeweging, de tijdsstructuur van een bronclip of een stem. Een video die alleen voor camerabeweging wordt gebruikt, verschilt van een video die daadwerkelijk bewerkt of voortgezet moet worden. Benoem die relatie expliciet.\n\nDe referentiegids van de maker onderscheidt onderwerpdefinities, een taaksamenvatting, een analyse van wat behouden moet blijven, een gedetailleerde shotbeschrijving, het totale geluidsbeeld en achtergrondmuziek die alleen het publiek hoort. De gids onderscheidt het behouden van zichtbare inhoud van het overnemen van eigenschappen of een brede stijlreferentie. Bij audio verschilt het kopiëren van een signaal van het gebruiken van klankkleur, ritme of voordracht als referentie. Houd die rollen in de hele briefing gelijk.\n\nLever voor een referentiegestuurde scène een personageafbeelding, een korte referentie voor camerabeweging en een audioreferentie voor de stem aan en beschrijf vervolgens waar elk daarvan het doelshot moet beïnvloeden. Geef aan welke kleding-, omgevings- of objectdetails herkenbaar moeten blijven. Vergelijk de voltooide clip met die eisen, inclusief bewegingscontinuïteit en de relatie tussen de zichtbare spreker en de hoorbare stem.\n\nSpraak, geluid en shottiming\n\nH3 modelleert dialoog, fysieke geluiden, omgevingsgeluid en muziek gezamenlijk. De modelkaart documenteert stabiele dialoogondersteuning voor Arabisch, Chinees, Engels, Frans, Duits, Italiaans, Japans, Koreaans, Portugees, Russisch en Spaans; voor andere talen wordt wisselende ondersteuning beschreven. Geef de exacte gesproken woorden en taal op, met een consistente sprekeridentiteit tussen shots.\n\nDe promptgidsen van de maker gebruiken Engels voor beschrijvende onderdelen, terwijl dialoog en zichtbare tekst in hun oorspronkelijke taal behouden blijven. Gesproken inhoud gebruikt `minimax/hailuo-3MiniMax H3 genereert korte video's met door het model zelf gegenereerd stereogeluid op basis van tekst, frameafbeeldingen of multimodale referenties. Het ondersteunt creatie met een eerste/laatste frame, referentiegestuurde bewerking en relaties rond beweging of stem, met uitvoer van 4–15 seconden en een afzonderlijke procedure voor regeneratie in 2K.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Eén audiovisueel resultaat uit een multimodale briefing
MiniMax H3 is het omnimodale videosysteem van MiniMax. Het interpreteert tekst, afbeeldingen, video en audio samen en genereert vervolgens video met door het model zelf gegenereerd stereogeluid. De maker presenteert het voor kort creatief werk zoals productbeelden, reclame, geanimeerde posters en concepten voor filmtitels, waarbij de onderlinge relaties tussen referentiematerialen even belangrijk zijn als de scènebeschrijving.
Het gedocumenteerde systeem produceert video's van 4–15 seconden met 24 beelden per seconde en 32 kHz-stereogeluid. H3-Base genereert in 768p; de volledige 2K-procedure genereert dat resultaat opnieuw met de oorspronkelijke multimodale context. Dit gaat verder dan conventioneel vergroten: de tweede fase gebruikt het model en de broncontext opnieuw om fijne details terug te halen. H3 Max en H3-Context-IR hebben afzonderlijke rollen en limieten.
Creatie met tekst en framebegeleiding
Invoer met alleen tekst beschrijft de volledige audiovisuele tijdlijn. Een eerste afbeelding verankert de opening, een laatste afbeelding het einde en twee afbeeldingen kunnen beide vastleggen. Begin voor een shot vanaf het eerste frame met de compositie en identiteit die in het stilstaande beeld zichtbaar zijn en beschrijf daarna de handeling die daaruit ontstaat. Beschrijf voor een overgang van het eerste naar het laatste frame de waarneembare beweging die de twee toestanden verbindt, in plaats van twee losstaande afbeeldingsbeschrijvingen te herhalen.
Een praktische productbriefing kan een gesloten verpakking in het openingsframe specificeren, de hand die deze opent, de rustige beweging van de camera en de gewenste eindtoestand. Behoud de vorm van het object, de plaats van het etiket en de belichting in de aangeleverde frames. Framegestuurde en referentiegestuurde creatie zijn afzonderlijke invoermodi; de interface van de maker mengt rollen voor het eerste/laatste frame niet met rollen voor referentiemedia in één aanvraag.
Referentiegestuurde generatie en bewerking
De referentiemodus accepteert tekst met afbeeldingen, videoclips en audioclips. Benoem wat elke bron bijdraagt: het uiterlijk van een personage, een locatie, camerabeweging, de tijdsstructuur van een bronclip of een stem. Een video die alleen voor camerabeweging wordt gebruikt, verschilt van een video die daadwerkelijk bewerkt of voortgezet moet worden. Benoem die relatie expliciet.
De referentiegids van de maker onderscheidt onderwerpdefinities, een taaksamenvatting, een analyse van wat behouden moet blijven, een gedetailleerde shotbeschrijving, het totale geluidsbeeld en achtergrondmuziek die alleen het publiek hoort. De gids onderscheidt het behouden van zichtbare inhoud van het overnemen van eigenschappen of een brede stijlreferentie. Bij audio verschilt het kopiëren van een signaal van het gebruiken van klankkleur, ritme of voordracht als referentie. Houd die rollen in de hele briefing gelijk.
Lever voor een referentiegestuurde scène een personageafbeelding, een korte referentie voor camerabeweging en een audioreferentie voor de stem aan en beschrijf vervolgens waar elk daarvan het doelshot moet beïnvloeden. Geef aan welke kleding-, omgevings- of objectdetails herkenbaar moeten blijven. Vergelijk de voltooide clip met die eisen, inclusief bewegingscontinuïteit en de relatie tussen de zichtbare spreker en de hoorbare stem.
Spraak, geluid en shottiming
H3 modelleert dialoog, fysieke geluiden, omgevingsgeluid en muziek gezamenlijk. De modelkaart documenteert stabiele dialoogondersteuning voor Arabisch, Chinees, Engels, Frans, Duits, Italiaans, Japans, Koreaans, Portugees, Russisch en Spaans; voor andere talen wordt wisselende ondersteuning beschreven. Geef de exacte gesproken woorden en taal op, met een consistente sprekeridentiteit tussen shots.
De promptgidsen van de maker gebruiken Engels voor beschrijvende onderdelen, terwijl dialoog en zichtbare tekst in hun oorspronkelijke taal behouden blijven. Gesproken inhoud gebruikt <d>[Language] ...</d>, met de sprekeridentiteit en stembeschrijving buiten het blok. Onderscheid fysieke spraak van een voice-over buiten beeld en geef aan wanneer een zin doorloopt over een montageovergang of wordt afgebroken door het einde. Behoud zichtbare tekst eveneens exact. Stem de hoeveelheid spraak af op de gekozen duur en controleer de weergegeven woorden samen met de hoorbare zin.
Beschrijf camerabeweging als een handeling, inclusief bereik en snelheid wanneer die relevant zijn. Nummer shots in afspeelvolgorde en houd de tijdstippen van cuts binnen de videoduur. Onderscheid scènegeluiden zoals voetstappen of een sluitende deur van achtergrondmuziek die alleen het publiek hoort. Deze keuzes maken een kort shotplan gemakkelijker te interpreteren en aan het resultaat te toetsen.
Invoervoorbereiding en numerieke limieten
Het huidige generatieschema vereist niet-lege tekst in elke modus, met maximaal 7000 tekens per tekstonderdeel. Afbeeldingen kunnen JPG, JPEG, PNG, WebP, HEIC of HEIF zijn, maximaal 30 MB per stuk, met elke zijde van 256 tot 5760 pixels en een beeldverhouding van 0,4 tot 2,5. Frame-invoer staat één openings- en één eindafbeelding toe; de referentiemodus staat maximaal negen referentieafbeeldingen toe.
Referentievideo kan maximaal drie MP4- of MOV-clips bevatten, elk 2–15 seconden en samen maximaal 15 seconden. Een clip mag maximaal 50 MB zijn; de videocodec is H.264 of H.265, met AAC- of MP3-audio, zijden van 256 tot 5760 pixels, verhoudingen van 0,4 tot 2,5 en een framerate van 23,976 tot 60. Referentieaudio ondersteunt maximaal drie WAV- of MP3-clips, maximaal 15 MB per stuk, elk 2–15 seconden en samen maximaal 15 seconden. De modelkaart beperkt gemengde referentie-invoer tot 12 bestanden. De gedocumenteerde limiet voor de requestbody is 64 MB, los van de limieten per bestand.
Kies alleen referenties die bijdragen aan de briefing en maak elke bijdrage expliciet. Een duidelijk zicht op het onderwerp is bruikbaarder dan verschillende tegenstrijdige weergaven zonder uitleg. Behoud de referentievolgorde, snijd irrelevant materiaal weg zonder noodzakelijke scènecontext te verwijderen en controleer of korte bronclips de gevraagde handeling of stemkenmerken bevatten.
Uitvoerformaat en het volledige systeem
De H3-interface van de fabrikant biedt 768P en 2K. Generatie met alleen tekst vereist een concrete verhouding: 21:9, 16:9, 4:3, 1:1, 3:4 of 9:16. Creatie met een eerste/laatste frame ontleent de beeldverhouding aan de invoerafbeelding; referentiecreatie kan een adaptieve of expliciete verhouding gebruiken. De uitvoerduur is een geheel aantal seconden van 4 tot 15.
De modelkaart onderscheidt H3-Context-IR, dat de briefing interpreteert en verrijkt, H3-Base, dat audiovisuele inhoud genereert, en H3-Regenerate-2K, dat het resultaat met hogere resolutie maakt. De vrijgegeven basischeckpoints scheiden framegestuurde taken van omnireferentietaken. De context- en regeneratiecomponenten staan los van die basisgewichten, dus alleen de naam van een open checkpoint bewijst niet het gedrag van het volledige systeem.
De generatieprocedure van de maker is asynchroon. Via de taakquery-interface zijn taken uit de voorgaande zeven dagen op te vragen. Bewaar de taak-ID totdat het daadwerkelijke videoresultaat wordt geretourneerd en sla daarna de clip op, in plaats van alleen een tijdelijk downloadadres te bewaren. Beoordeel visuele identiteit, kleine tekst, objectinteracties, gesproken inhoud en geluidstiming op het beoogde kijkformaat. De fabrikant noemt multimodaal begrip en fijne visuele details als gebieden waarop verbetering doorgaat; een gedetailleerde briefing en vergelijking met de bronnen blijven essentieel voor een bruikbaar resultaat.
POST /v1/videostext, image, audio, videovideo| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten minimax/hailuo-3 | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldduration | Typeinteger | VereisteVereist | Waarden en limieten 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Standaard— |
Veldresolution | Typestring | VereisteOptioneel | Waarden en limieten 2K | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Standaard— |
Veldgenerate_audio | Typeboolean | VereisteOptioneel | Waarden en limieten false, true | Standaard— |
Veldframe_images | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 2 Invoerinhoud: Array met frameobjecten. Elk object bevat type=image_url, image_url met daarin url, en frame_type. Gebruik een HTTPS-afbeeldings-URL en stel frame_type in op first_frame of last_frame. Elke framerol komt maximaal eenmaal voor. Exacte sleutels: type, image_url, frame_type Voorwaarden: Deze sleutels beschrijven elk frameobject; image_url bevat uitsluitend url. Laat frame_images weg voor een verzoek met uitsluitend tekst. | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldcallback_url | Typestring | VereisteOptioneel | Waarden en limieten Patroon: ^https:// | Standaard— |
Veldsession_id | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldtrace | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Velduser | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Tekst naar video · Een geschreven prompt. · Vereist: model, prompt, duration
Geef prompt als tekst en duration in hele seconden op. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.
model: Type: string · minimax/hailuo-3
prompt: Type: string · Maximumaantal UTF-8-bytes: 10.000 · Ten minste één teken anders dan witruimte vereist: Ja
Afbeelding naar video · Een geschreven prompt en een afbeelding voor het eerste frame. · Vereist: model, prompt, duration, frame_images
frame_images is een array. Elk frameobject bevat type, image_url en frame_type; image_url bevat url. Stel type in op image_url. Gebruik first_frame met een optionele last_frame. Elke framerol komt maximaal eenmaal voor. Geef voor elk frame een openbare HTTPS-afbeeldings-URL op. Gebruik frameafbeeldingen of afbeeldingsreferenties in één verzoek; combineer beide niet. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.
Exacte sleutels: type, image_url, frame_type
model: Type: string · minimax/hailuo-3
prompt: Type: string · Maximumaantal UTF-8-bytes: 10.000 · Ten minste één teken anders dan witruimte vereist: Ja
Reference to video · Een geschreven prompt en ondersteunde afbeeldings-, video- en audioreferenties. · Vereist: model, prompt, duration, input_references
input_references is een array met objecten. Stel type in op image_url, video_url, audio_url en gebruik het bijbehorende veld dat url bevat. Gebruik openbare HTTPS-URLs. Laat frame_images weg om de referentiemodus te selecteren. De schatting omvat de weergegeven component per afbeelding alleen voor referentieafbeeldingen na de eerste vijf. De uiteindelijke kosten volgen de daadwerkelijk gefactureerde configuratie. Combineer afbeeldingsreferenties niet met frameafbeeldingen. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.
model: Type: string · minimax/hailuo-3
prompt: Type: string · Maximumaantal UTF-8-bytes: 10.000 · Ten minste één teken anders dan witruimte vereist: Ja
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt, duration |
Parametermaterial_types | Contracttext, image, audio, video |
Parameteradditional_properties | Contractfalse |
Parameteroptional_controls | Contractresolution, 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
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Factureringsvoorwaarden | Kosten |
|---|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Factureringsvoorwaarden— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieVideoprijs | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper videoseconde | FactureringsvoorwaardenIn deze prijssleutel is geen aanvullende voorwaarde vastgelegd. | Kosten Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.26 per videoseconde |
| Configuratiereferentieafbeelding | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper referentieafbeelding | Factureringsvoorwaarden— | Kosten Invoer · referentieafbeelding · Schatting uitsluitend ter vergelijking $0.08 per referentieafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Factureringsvoorwaarden— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $1.3 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Referentiestaffels op modelniveau veranderen de methodeselectie, kostenramingen of afschrijvingen niet. Voor de actieve kostenberekening gelden de tarieven van de geselecteerde Ailoot-methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| ConfiguratieVideoprijs | FactureringsvoorwaardenIn deze prijssleutel is geen aanvullende voorwaarde vastgelegd. | Kosten Uitvoer · Videoprijs $0.26 per videoseconde Gepubliceerde prijsreferentie voor de weergegeven configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie. |
| ConfiguratieReferentieafbeeldingen na de eerste vijf | FactureringsvoorwaardenIn deze prijssleutel is geen aanvullende voorwaarde vastgelegd. | Kosten Invoer · Referentieafbeeldingen na de eerste vijf $0.08 per afbeelding De eerste vijf referentieafbeeldingen zijn gratis; het vermelde tarief per afbeelding geldt na de eerste vijf. Gepubliceerde prijsreferentie voor de getoonde configuratie. De uiteindelijke kosten volgen de daadwerkelijk gefactureerde configuratie. |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\nondertekende inhouds-URLs die u bezit
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/contentset -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\nset -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\nSla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.
Bewaar alle daadwerkelijke uitvoer die u bezit en de geretourneerde gemeten metadata.
503 result_pending_check + oorspronkelijke id + X-Should-Retry:false; herhaal het oorspronkelijke verzoek nooit
| Veld | Type | Betekenis |
|---|---|---|
Veldindex | Typeinteger | BetekenisPositie van deze video in de uitvoerlijst, geteld vanaf nul. |
Veldcontent_url | Typestring | BetekenisOndertekende HTTPS-download-URL voor deze voltooide video. |
Veldsha256 | Typestring | null | BetekenisSHA-256-digest van de oorspronkelijke videobytes; null indien niet beschikbaar. |
Veldsize_bytes | Typeinteger | null | BetekenisGrootte van het oorspronkelijke videobestand in bytes; null indien niet beschikbaar. |
Veldduration_ms | Typeinteger | null | BetekenisGemeten videoduur in milliseconden; null indien niet beschikbaar. |
Veldwidth | Typeinteger | null | BetekenisVideobreedte in pixels; null indien niet beschikbaar. |
Veldheight | Typeinteger | null | BetekenisVideohoogte in pixels; null indien niet beschikbaar. |
Veldvideo_codec | Typestring | null | BetekenisVideocodec-identificatie; null indien niet vastgelegd. |
Veldhas_audio | Typeboolean | null | BetekenisOf de video een audiotrack bevat; null indien niet gemeten. |
Veldaudio_codec | Typestring | null | BetekenisAudiocodec-identificatie; null wanneer geen identificatie is vastgelegd. |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord404 · not_found_error | VoorwaardeVideotoegang is niet beschikbaar of deze video-ID is niet gevonden. | Volgende stapControleer videotoegang. Gebruik voor een bestaande video de oorspronkelijke openbare ID en dezelfde API-sleutel. |
Antwoord401 · authentication_error | VoorwaardeDe API-sleutel komt niet overeen met het geauthenticeerde account. | Volgende stapControleer uw API-sleutel en accounttoegang voordat u indient. |
Antwoord400 · invalid_request_error | VoorwaardeHet verzoek kon niet worden gelezen of de downloadindex is ongeldig. | Volgende stapCorrigeer de verzoekbody. Kies voor een download een uitvoerindex die door de oorspronkelijke taak is geretourneerd. |
Antwoord422 · price_unavailable | VoorwaardeDe geselecteerde videoconfiguratie kan niet worden geprijsd. | Volgende stapKies een ondersteunde videoconfiguratie en vul de vereiste opties in voordat u een gecorrigeerd verzoek indient. |
Antwoord422 · invalid_request_error | VoorwaardeEen videoinvoer of oorspronkelijke vervolgtaak is ongeldig. | Volgende stapGebruik geldige HTTPS-invoer. Gebruik voor een vervolg uw voltooide oorspronkelijke openbare video-ID met dezelfde API-sleutel. |
Antwoord402 · billing_error | VoorwaardeHet beschikbare saldo of de limieten staan geen reservering toe. | Volgende stapControleer uw beschikbare saldo en limieten voordat u een nieuw verzoek verstuurt. |
Antwoord503 · server_error | VoorwaardeVideoverificatie, opslag of servicetoegang is tijdelijk niet beschikbaar. | Volgende stapWacht tot de service beschikbaar is. Als u al een video-ID hebt, controleert u die oorspronkelijke taak in plaats van een nieuwe generatie aan te maken. |
Antwoord503 · result_pending_check | VoorwaardeHet oorspronkelijke videoresultaat en de kosten moeten worden gecontroleerd. | Volgende stapBewaar de geretourneerde video-ID en controleer die taak. Verstuur geen vervangend generatieverzoek terwijl deze wordt gecontroleerd. |
Antwoord503 · owned_result_unavailable | VoorwaardeDe bestaande videodownload is tijdelijk niet beschikbaar. | Volgende stapControleer dezelfde videotaak later en download de bestaande uitvoer. Een nieuwe generatie maakt een afzonderlijke operatie aan. |
Antwoord409 · video_not_ready | VoorwaardeDe video-inhoud is niet gepubliceerd. | Volgende stapControleer de oorspronkelijke taakstatus. Download nadat deze completed meldt; als deze failed meldt, volgt u de melding over kostencontrole. |
Ailoot Ultra minimax/hailuo-3
Gebruik de hierboven getoonde methodepaden.