{ "aboutHtml": "

Nopea, jälkikoulutettu H3-muunnelma

MiniMax H3 Max on MiniMax H3 -perusmallin jälkikoulutettu muunnelma, joka on optimoitu nopeampaan generointiin, kehotteen noudattamiseen ja audiovisuaaliseen laatuun. Muunnelman kehitti jälkikoulutuksella fal Research. Se säilyttää yhtenäisen multimodaalisen kontekstin sekä luontaisesti synkronoidun kuvan ja äänen. Nopeus on suunnittelun painopiste, ei kiinteä valmistumisaika jokaiselle kehotteelle, kestolle tai sovellukselle.

Pidä Max erillään alkuperäisestä H3-järjestelmästä ja erillisestä Max Turbo -muunnelmasta. MiniMaxin nykyinen rajapinta tarjoaa Maxille 480P- tai 768P-tarkkuuden, oletuksena 768P:n, 24 kuvaa sekunnissa ja kokonaislukuna ilmaistun 5–15 sekunnin keston. Dokumentoitu Max-työnkulku ei tarjoa alkuperäisen H3-järjestelmän 2K-asetusta eikä neljän sekunnin tulosta.

Kehotteesta otokseksi

Jokainen generointi sisältää tekstiohjeen, joka ei saa olla tyhjä; yhden tekstikohdan pituus on enintään 7 000 merkkiä. Kuvaile kohde, aloitussommittelu, toiminta ja tulos ja määrittele sitten kameran ja äänen ohjeet selvästi. Lyhyessä esineen paljastuksessa kerro, mitä katsojan tulee nähdä ensin, miten esine tulee näkyviin ja miten otoksen tulee päättyä.

Hyödyllinen viiden sekunnin ohje voi kuvata keraamisen kupin puupöydällä, käden asettamassa aluslautasta sen viereen, kameran pienen lähestymisen sekä keramiikan ja puun kosketusäänen. Rajaa toiminta valittuun kestoon sopivaksi ja tarkista, seuraavatko palautettu liike ja ääni samaa tapahtumaa.

Ruutukuvien ohjaama luominen

Valmistaja dokumentoi aloitusruudun, lopetusruudun tai molempien käytön. Ensimmäinen kuva määrittelee leikkeen alun, viimeinen kuva lopullisen visuaalisen tilan. Selitä ne yhdistävä liike, mukaan lukien asennon, esineen sijainnin, kameran tai valaistuksen muutokset. Vältä kahden ruudun siirtymässä ohjetta, joka tuo päätepisteiden väliin yhteensopimattoman kohtauksen.

Ruutukuvien ohjaama tulos saa kuvasuhteensa syötekuvasta. Pelkkään tekstiin perustuvassa työssä valitse tarkka kuvasuhde vaihtoehdoista 21:9, 16:9, 4:3, 1:1, 3:4 tai 9:16. Viitteiden ohjaamassa työssä voidaan käyttää mukautuvaa suhdetta tai jotakin dokumentoiduista täsmällisistä vaihtoehdoista. Sommittele viite tai kirjallinen kohtaus kohderuutua varten äläkä oleta saman järjestelyn toimivan yhtä hyvin pysty- ja vaakamuodossa.

Multimodaaliset viitteet

MiniMaxin nykyinen Max-generointiskeema dokumentoi myös viitekuvat, videot ja äänet. Kerro, mihin kunkin tulee vaikuttaa: hahmon identiteettiin, ympäristöön, liikerataan, kameran kulkuun, äänenväriin tai äänen ominaisuuteen. Ensimmäisen ja viimeisen ruudun roolit sekä viitemedian roolit sulkevat toisensa pois tässä rajapinnassa.

Yksilöi hahmo-otoksessa ulkonäköviite ja liikeviite erikseen ja anna sitten haluttu toiminta ja puhuttu repliikki. Esitystapaa määrittelevä ääniviite on eri asia kuin sen koko äänisignaalin kopiointi. Määrittele ohjeessa selvästi säilytettävät piirteet ja tehtävät muutokset ja vertaa varsinaista audiovisuaalista leikettä jokaiseen viiterooliin.

Kehotteen laajennus

Maxin oma laajennusasetus tarjoaa vaihtoehdot disabled, balanced ja quality, joista balanced on oletus. Valitse disabled, kun annetun ohjeen tulee välittyä ilman laajennusta; käytä dokumentoitua laajennustilaa, kun haluat lisätulkintaa. Säilytä alkuperäinen ohje, jotta laajennuksessa syntynyt muutos voidaan erottaa pyydetystä sisällöstä.

Kuvaile ääni osana kohtausta. Yksilöi fyysiset äänet, taustaäänet ja mahdolliset puhutut sanat ja erota ne vain yleisölle kuuluvasta taustamusiikista. Anna tarkka repliikki ja tarkoitettu puhuja sen sijaan, että pyytäisit määrittelemätöntä vuoropuhelua. Kuuntele tulos katsomisen lisäksi; vakuuttava kuva ei osoita, että puheen sanamuoto tai ajoitus olisi oikein.

Syötteiden valmistelu ja rajat

Valmistajan nykyinen skeema hyväksyy JPG-, JPEG-, PNG-, WebP-, HEIC- tai HEIF-kuvat, enintään 30 MB kukin, sivupituuksilla 256–5 760 pikseliä ja kuvasuhteilla 0.4–2.5. Aloitus- ja lopetusrooliin sallitaan kumpaankin yksi kuva; viitetila sallii enintään yhdeksän kuvaa. Säilytä selkeä näkymä kohteeseen ja tunnistettavina pysyviin yksityiskohtiin.

Viitevideona sallitaan enintään kolme MP4- tai MOV-leikettä, kukin 2–15 sekuntia ja yhteensä enintään 15 sekuntia; tiedostokohtainen raja on 50 MB. Dokumentoituina ovat H.264- tai H.265-video, AAC- tai MP3-ääni, sivupituudet 256–5 760 pikseliä, kuvasuhteet 0.4–2.5 ja kuvanopeus 23.976–60. Viiteäänenä sallitaan enintään kolme WAV- tai MP3-leikettä, kukin enintään 15 MB ja 2–15 sekuntia, yhteensä enintään 15 sekuntia. Pyynnön rungolle on erillinen 64 MB:n raja.

Käytä vain otokseen vaikuttavia viitteitä ja yksilöi kunkin vaikutus tekstissä. Lyhyttä, olennaista liikeleikettä on helpompi käyttää ohjeena kuin pitkää kokoelmaa toisistaan irrallisia tapahtumia. Määrittele haluttu kesto ja tulostarkkuus selvästi, jotta tulosta voidaan verrata samaan ohjeeseen.

Valmis tulos

Valmistajan asynkroninen työnkulku palauttaa tehtävän tunnisteen ennen valmiin videon saatavuutta. Tehtäväkyselyrajapinta hakee tehtäviä edeltäviltä seitsemältä päivältä. Tallenna varsinainen palautettu leike ja sen määrittely muokkausta tai jatkoarviointia varten; tehtävätunniste ei ole audiovisuaalinen lopputulos. Latausosoitteet ovat määräaikaisia, joten säilytä itse tiedosto valittua tulosta säilyttäessäsi.

Arvioi kohteen jatkuvuus, liike, näkyvä teksti, vuoropuhelu ja äänen ajoitus siinä koossa, jossa leikettä käytetään. Anna seuraavaa luovaa ohjetta varten konkreettinen palaute: muuttunut ele, pois jäänyt repliikki tai korjausta vaativa rajaus. Hyödyllinen tulos on lyhyt audiovisuaalinen otos, joka liittyy annettuun sisältöön ja sen selvästi määriteltyihin viitesuhteisiin.

", "aboutText": "Nopea, jälkikoulutettu H3-muunnelma\n\nMiniMax H3 Max on MiniMax H3 -perusmallin jälkikoulutettu muunnelma, joka on optimoitu nopeampaan generointiin, kehotteen noudattamiseen ja audiovisuaaliseen laatuun. Muunnelman kehitti jälkikoulutuksella fal Research. Se säilyttää yhtenäisen multimodaalisen kontekstin sekä luontaisesti synkronoidun kuvan ja äänen. Nopeus on suunnittelun painopiste, ei kiinteä valmistumisaika jokaiselle kehotteelle, kestolle tai sovellukselle.\n\nPidä Max erillään alkuperäisestä H3-järjestelmästä ja erillisestä Max Turbo -muunnelmasta. MiniMaxin nykyinen rajapinta tarjoaa Maxille 480P- tai 768P-tarkkuuden, oletuksena 768P:n, 24 kuvaa sekunnissa ja kokonaislukuna ilmaistun 5–15 sekunnin keston. Dokumentoitu Max-työnkulku ei tarjoa alkuperäisen H3-järjestelmän 2K-asetusta eikä neljän sekunnin tulosta.\n\nKehotteesta otokseksi\n\nJokainen generointi sisältää tekstiohjeen, joka ei saa olla tyhjä; yhden tekstikohdan pituus on enintään 7 000 merkkiä. Kuvaile kohde, aloitussommittelu, toiminta ja tulos ja määrittele sitten kameran ja äänen ohjeet selvästi. Lyhyessä esineen paljastuksessa kerro, mitä katsojan tulee nähdä ensin, miten esine tulee näkyviin ja miten otoksen tulee päättyä.\n\nHyödyllinen viiden sekunnin ohje voi kuvata keraamisen kupin puupöydällä, käden asettamassa aluslautasta sen viereen, kameran pienen lähestymisen sekä keramiikan ja puun kosketusäänen. Rajaa toiminta valittuun kestoon sopivaksi ja tarkista, seuraavatko palautettu liike ja ääni samaa tapahtumaa.\n\nRuutukuvien ohjaama luominen\n\nValmistaja dokumentoi aloitusruudun, lopetusruudun tai molempien käytön. Ensimmäinen kuva määrittelee leikkeen alun, viimeinen kuva lopullisen visuaalisen tilan. Selitä ne yhdistävä liike, mukaan lukien asennon, esineen sijainnin, kameran tai valaistuksen muutokset. Vältä kahden ruudun siirtymässä ohjetta, joka tuo päätepisteiden väliin yhteensopimattoman kohtauksen.\n\nRuutukuvien ohjaama tulos saa kuvasuhteensa syötekuvasta. Pelkkään tekstiin perustuvassa työssä valitse tarkka kuvasuhde vaihtoehdoista 21:9, 16:9, 4:3, 1:1, 3:4 tai 9:16. Viitteiden ohjaamassa työssä voidaan käyttää mukautuvaa suhdetta tai jotakin dokumentoiduista täsmällisistä vaihtoehdoista. Sommittele viite tai kirjallinen kohtaus kohderuutua varten äläkä oleta saman järjestelyn toimivan yhtä hyvin pysty- ja vaakamuodossa.\n\nMultimodaaliset viitteet\n\nMiniMaxin nykyinen Max-generointiskeema dokumentoi myös viitekuvat, videot ja äänet. Kerro, mihin kunkin tulee vaikuttaa: hahmon identiteettiin, ympäristöön, liikerataan, kameran kulkuun, äänenväriin tai äänen ominaisuuteen. Ensimmäisen ja viimeisen ruudun roolit sekä viitemedian roolit sulkevat toisensa pois tässä rajapinnassa.\n\nYksilöi hahmo-otoksessa ulkonäköviite ja liikeviite erikseen ja anna sitten haluttu toiminta ja puhuttu repliikki. Esitystapaa määrittelevä ääniviite on eri asia kuin sen koko äänisignaalin kopiointi. Määrittele ohjeessa selvästi säilytettävät piirteet ja tehtävät muutokset ja vertaa varsinaista audiovisuaalista leikettä jokaiseen viiterooliin.\n\nKehotteen laajennus\n\nMaxin oma laajennusasetus tarjoaa vaihtoehdot disabled, balanced ja quality, joista balanced on oletus. Valitse disabled, kun annetun ohjeen tulee välittyä ilman laajennusta; käytä dokumentoitua laajennustilaa, kun haluat lisätulkintaa. Säilytä alkuperäinen ohje, jotta laajennuksessa syntynyt muutos voidaan erottaa pyydetystä sisällöstä.\n\nKuvaile ääni osana kohtausta. Yksilöi fyysiset äänet, taustaäänet ja mahdolliset puhutut sanat ja erota ne vain yleisölle kuuluvasta taustamusiikista. Anna tarkka repliikki ja tarkoitettu puhuja sen sijaan, että pyytäisit määrittelemätöntä vuoropuhelua. Kuuntele tulos katsomisen lisäksi; vakuuttava kuva ei osoita, että puheen sanamuoto tai ajoitus olisi oikein.\n\nSyötteiden valmistelu ja rajat\n\nValmistajan nykyinen skeema hyväksyy JPG-, JPEG-, PNG-, WebP-, HEIC- tai HEIF-kuvat, enintään 30 MB kukin, sivupituuksilla 256–5 760 pikseliä ja kuvasuhteilla 0.4–2.5. Aloitus- ja lopetusrooliin sallitaan kumpaankin yksi kuva; viitetila sallii enintään yhdeksän kuvaa. Säilytä selkeä näkymä kohteeseen ja tunnistettavina pysyviin yksityiskohtiin.\n\nViitevideona sallitaan enintään kolme MP4- tai MOV-leikettä, kukin 2–15 sekuntia ja yhteensä enintään 15 sekuntia; tiedostokohtainen raja on 50 MB. Dokumentoituina ovat H.264- tai H.265-video, AAC- tai MP3-ääni, sivupituudet 256–5 760 pikseliä, kuvasuhteet 0.4–2.5 ja kuvanopeus 23.976–60. Viiteäänenä sallitaan enintään kolme WAV- tai MP3-leikettä, kukin enintään 15 MB ja 2–15 sekuntia, yhteensä enintään 15 sekuntia. Pyynnön rungolle on erillinen 64 MB:n raja.\n\nKäytä vain otokseen vaikuttavia viitteitä ja yksilöi kunkin vaikutus tekstissä. Lyhyttä, olennaista liikeleikettä on helpompi käyttää ohjeena kuin pitkää kokoelmaa toisistaan irrallisia tapahtumia. Määrittele haluttu kesto ja tulostarkkuus selvästi, jotta tulosta voidaan verrata samaan ohjeeseen.\n\nValmis tulos\n\nValmistajan asynkroninen työnkulku palauttaa tehtävän tunnisteen ennen valmiin videon saatavuutta. Tehtäväkyselyrajapinta hakee tehtäviä edeltäviltä seitsemältä päivältä. Tallenna varsinainen palautettu leike ja sen määrittely muokkausta tai jatkoarviointia varten; tehtävätunniste ei ole audiovisuaalinen lopputulos. Latausosoitteet ovat määräaikaisia, joten säilytä itse tiedosto valittua tulosta säilyttäessäsi.\n\nArvioi kohteen jatkuvuus, liike, näkyvä teksti, vuoropuhelu ja äänen ajoitus siinä koossa, jossa leikettä käytetään. Anna seuraavaa luovaa ohjetta varten konkreettinen palaute: muuttunut ele, pois jäänyt repliikki tai korjausta vaativa rajaus. Hyödyllinen tulos on lyhyt audiovisuaalinen otos, joka liittyy annettuun sisältöön ja sen selvästi määriteltyihin viitesuhteisiin.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "3acb4c328e68bbb774f1d60a854115818c4398c2c42a841c82766679d7076865", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "
MM

MiniMax: H3 Max

MiniMax /minimax/hailuo-3-max

Aloitus

MiniMax H3 Max on nopea, jälkikoulutettu H3-muunnelma lyhyisiin videoihin, joissa on synkronoitu ääni. MiniMaxin dokumentoitu työnkulku tukee tekstiä, ruutukuvia ja multimodaalisia viitteitä, 480P- tai 768P-tulostarkkuutta, 5–15 sekunnin kestoa sekä omia kehotteen laajennusvaihtoehtoja.

Hyväksytyt syötteet
Teksti · Kuvat
Tulokset
Video
Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

Nopea, jälkikoulutettu H3-muunnelma

MiniMax H3 Max on MiniMax H3 -perusmallin jälkikoulutettu muunnelma, joka on optimoitu nopeampaan generointiin, kehotteen noudattamiseen ja audiovisuaaliseen laatuun. Muunnelman kehitti jälkikoulutuksella fal Research. Se säilyttää yhtenäisen multimodaalisen kontekstin sekä luontaisesti synkronoidun kuvan ja äänen. Nopeus on suunnittelun painopiste, ei kiinteä valmistumisaika jokaiselle kehotteelle, kestolle tai sovellukselle.

Pidä Max erillään alkuperäisestä H3-järjestelmästä ja erillisestä Max Turbo -muunnelmasta. MiniMaxin nykyinen rajapinta tarjoaa Maxille 480P- tai 768P-tarkkuuden, oletuksena 768P:n, 24 kuvaa sekunnissa ja kokonaislukuna ilmaistun 5–15 sekunnin keston. Dokumentoitu Max-työnkulku ei tarjoa alkuperäisen H3-järjestelmän 2K-asetusta eikä neljän sekunnin tulosta.

Kehotteesta otokseksi

Jokainen generointi sisältää tekstiohjeen, joka ei saa olla tyhjä; yhden tekstikohdan pituus on enintään 7 000 merkkiä. Kuvaile kohde, aloitussommittelu, toiminta ja tulos ja määrittele sitten kameran ja äänen ohjeet selvästi. Lyhyessä esineen paljastuksessa kerro, mitä katsojan tulee nähdä ensin, miten esine tulee näkyviin ja miten otoksen tulee päättyä.

Hyödyllinen viiden sekunnin ohje voi kuvata keraamisen kupin puupöydällä, käden asettamassa aluslautasta sen viereen, kameran pienen lähestymisen sekä keramiikan ja puun kosketusäänen. Rajaa toiminta valittuun kestoon sopivaksi ja tarkista, seuraavatko palautettu liike ja ääni samaa tapahtumaa.

Ruutukuvien ohjaama luominen

Valmistaja dokumentoi aloitusruudun, lopetusruudun tai molempien käytön. Ensimmäinen kuva määrittelee leikkeen alun, viimeinen kuva lopullisen visuaalisen tilan. Selitä ne yhdistävä liike, mukaan lukien asennon, esineen sijainnin, kameran tai valaistuksen muutokset. Vältä kahden ruudun siirtymässä ohjetta, joka tuo päätepisteiden väliin yhteensopimattoman kohtauksen.

Ruutukuvien ohjaama tulos saa kuvasuhteensa syötekuvasta. Pelkkään tekstiin perustuvassa työssä valitse tarkka kuvasuhde vaihtoehdoista 21:9, 16:9, 4:3, 1:1, 3:4 tai 9:16. Viitteiden ohjaamassa työssä voidaan käyttää mukautuvaa suhdetta tai jotakin dokumentoiduista täsmällisistä vaihtoehdoista. Sommittele viite tai kirjallinen kohtaus kohderuutua varten äläkä oleta saman järjestelyn toimivan yhtä hyvin pysty- ja vaakamuodossa.

Multimodaaliset viitteet

MiniMaxin nykyinen Max-generointiskeema dokumentoi myös viitekuvat, videot ja äänet. Kerro, mihin kunkin tulee vaikuttaa: hahmon identiteettiin, ympäristöön, liikerataan, kameran kulkuun, äänenväriin tai äänen ominaisuuteen. Ensimmäisen ja viimeisen ruudun roolit sekä viitemedian roolit sulkevat toisensa pois tässä rajapinnassa.

Yksilöi hahmo-otoksessa ulkonäköviite ja liikeviite erikseen ja anna sitten haluttu toiminta ja puhuttu repliikki. Esitystapaa määrittelevä ääniviite on eri asia kuin sen koko äänisignaalin kopiointi. Määrittele ohjeessa selvästi säilytettävät piirteet ja tehtävät muutokset ja vertaa varsinaista audiovisuaalista leikettä jokaiseen viiterooliin.

Kehotteen laajennus

Maxin oma laajennusasetus tarjoaa vaihtoehdot disabled, balanced ja quality, joista balanced on oletus. Valitse disabled, kun annetun ohjeen tulee välittyä ilman laajennusta; käytä dokumentoitua laajennustilaa, kun haluat lisätulkintaa. Säilytä alkuperäinen ohje, jotta laajennuksessa syntynyt muutos voidaan erottaa pyydetystä sisällöstä.

Kuvaile ääni osana kohtausta. Yksilöi fyysiset äänet, taustaäänet ja mahdolliset puhutut sanat ja erota ne vain yleisölle kuuluvasta taustamusiikista. Anna tarkka repliikki ja tarkoitettu puhuja sen sijaan, että pyytäisit määrittelemätöntä vuoropuhelua. Kuuntele tulos katsomisen lisäksi; vakuuttava kuva ei osoita, että puheen sanamuoto tai ajoitus olisi oikein.

Syötteiden valmistelu ja rajat

Valmistajan nykyinen skeema hyväksyy JPG-, JPEG-, PNG-, WebP-, HEIC- tai HEIF-kuvat, enintään 30 MB kukin, sivupituuksilla 256–5 760 pikseliä ja kuvasuhteilla 0.4–2.5. Aloitus- ja lopetusrooliin sallitaan kumpaankin yksi kuva; viitetila sallii enintään yhdeksän kuvaa. Säilytä selkeä näkymä kohteeseen ja tunnistettavina pysyviin yksityiskohtiin.

Viitevideona sallitaan enintään kolme MP4- tai MOV-leikettä, kukin 2–15 sekuntia ja yhteensä enintään 15 sekuntia; tiedostokohtainen raja on 50 MB. Dokumentoituina ovat H.264- tai H.265-video, AAC- tai MP3-ääni, sivupituudet 256–5 760 pikseliä, kuvasuhteet 0.4–2.5 ja kuvanopeus 23.976–60. Viiteäänenä sallitaan enintään kolme WAV- tai MP3-leikettä, kukin enintään 15 MB ja 2–15 sekuntia, yhteensä enintään 15 sekuntia. Pyynnön rungolle on erillinen 64 MB:n raja.

Käytä vain otokseen vaikuttavia viitteitä ja yksilöi kunkin vaikutus tekstissä. Lyhyttä, olennaista liikeleikettä on helpompi käyttää ohjeena kuin pitkää kokoelmaa toisistaan irrallisia tapahtumia. Määrittele haluttu kesto ja tulostarkkuus selvästi, jotta tulosta voidaan verrata samaan ohjeeseen.

Valmis tulos

Valmistajan asynkroninen työnkulku palauttaa tehtävän tunnisteen ennen valmiin videon saatavuutta. Tehtäväkyselyrajapinta hakee tehtäviä edeltäviltä seitsemältä päivältä. Tallenna varsinainen palautettu leike ja sen määrittely muokkausta tai jatkoarviointia varten; tehtävätunniste ei ole audiovisuaalinen lopputulos. Latausosoitteet ovat määräaikaisia, joten säilytä itse tiedosto valittua tulosta säilyttäessäsi.

Arvioi kohteen jatkuvuus, liike, näkyvä teksti, vuoropuhelu ja äänen ajoitus siinä koossa, jossa leikettä käytetään. Anna seuraavaa luovaa ohjetta varten konkreettinen palaute: muuttunut ele, pois jäänyt repliikki tai korjausta vaativa rajaus. Hyödyllinen tulos on lyhyt audiovisuaalinen otos, joka liittyy annettuun sisältöön ja sen selvästi määriteltyihin viitesuhteisiin.

Saatavilla Ailootissa · syötteet & menetelmät

Ailoot Ultra · Video POST /v1/videos
Syötetyypit
text, image
Tulostyypit
video
Tulosteen muoto
alkuperäiset MP4-tavut; ei normalisointia eikä uudelleenkoodausta
KenttäTyyppiVaatimusArvot & rajatOletus
KenttämodelTyyppistringVaatimusPakollinenArvot & rajat
minimax/hailuo-3-max
Oletus—
KenttäpromptTyyppistringVaatimusPakollinenArvot & rajatOletus—
KenttädurationTyyppiintegerVaatimusPakollinenArvot & rajat
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Vähimmäismäärä: 1
Enimmäismäärä: 600
Oletus—
KenttäresolutionTyyppistringVaatimusValinnainenArvot & rajat
768p, 480p
Oletus—
Kenttäaspect_ratioTyyppistringVaatimusValinnainenArvot & rajat
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Oletus—
Kenttägenerate_audioTyyppibooleanVaatimusValinnainenArvot & rajat
false
Oletus—
Kenttäframe_imagesTyyppiarrayVaatimusValinnainenArvot & rajat
Kohteiden vähimmäismäärä: 1
Kohteiden enimmäismäärä: 2
Syötteen sisältö: Kuvaolioiden taulukko. Jokaisessa oliossa on type=image_url, url-kentän sisältävä image_url ja frame_type. Käytä HTTPS-kuvan URL-osoitetta ja aseta frame_type-kentän arvoksi first_frame tai last_frame. Kukin kuvan rooli esiintyy enintään kerran.
Tarkat avaimet: type, image_url, frame_type
Ehdot: Nämä avaimet kuvaavat jokaista kuvaoliota; image_url sisältää vain url-kentän. Jätä frame_images pois pelkkää tekstiä sisältävästä pyynnöstä.
Oletus—
Kenttäinput_referencesTyyppiarrayVaatimusValinnainenArvot & rajatOletus—
Kenttäcallback_urlTyyppistringVaatimusValinnainenArvot & rajat
Merkkijonomalli: ^https://
Oletus—
Kenttäsession_idTyyppistringVaatimusValinnainenArvot & rajatOletus—
KenttätraceTyyppiobjectVaatimusValinnainenArvot & rajatOletus—
KenttäuserTyyppistringVaatimusValinnainenArvot & rajatOletus—
Syöteaineistojen yhdistelmät

Tekstistä videoksi · Kirjoitettu kehote. · Pakollinen: model, prompt, duration

Anna kehote tekstinä ja kesto kokonaisina sekunteina. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.

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

prompt: Tyyppi: string · UTF-8-tavujen enimmäismäärä: 10 000 · Vaaditaan muu merkki kuin tyhjämerkki: Kyllä

Kuvasta videoksi · Kirjoitettu kehote ja ensimmäisen ruudun kuva. · Pakollinen: model, prompt, duration, frame_images

frame_images on taulukko. Jokaisessa kuvaoliossa on type, image_url ja frame_type; image_url sisältää url-kentän. Aseta type-kentän arvoksi image_url. Käytä first_frame-arvoa ja halutessasi last_frame-arvoa. Kukin kuvan rooli esiintyy enintään kerran. Anna jokaiselle kuvalle julkinen HTTPS-kuvan URL-osoite. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.

Tarkat avaimet: type, image_url, frame_type

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

prompt: Tyyppi: string · UTF-8-tavujen enimmäismäärä: 10 000 · Vaaditaan muu merkki kuin tyhjämerkki: Kyllä

Menetelmän parametrit ja elinkaari
ParametriSopimus
Parametricontent_typeSopimusapplication/json
ParametrirequiredSopimusmodel, prompt, duration
Parametrimaterial_typesSopimustext, image
Parametriadditional_propertiesSopimusfalse
Parametrioptional_controlsSopimusresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user

Elinkaari: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Hinnoittelu

Lopullisen veloituksen laskenta

Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.

Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.

Nopea tila
Ei määritetty Kun nopea tila on valittu
Flex-tila
Ei määritetty Kun flex-tila on valittu
Päättelyn enimmäisteho
Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä

Arvioidut vertailuhinnat

Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

AsetuksetHinnastoEnnustettu määräVeloituskomponenttiLaskutusyksikköLaskutusehdotVeloitus
AsetuksetTokenien perushinnatHinnastoPerushintaEnnustettu määrä—Veloituskomponentti—Laskutusyksikkö—Laskutusehdot—Veloitus
Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia
Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia
Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia
Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia
Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia
AsetuksetVideotulos · viitehintaHinnasto—Ennustettu määrä—Veloituskomponenttireference_output_rateLaskutusyksikkötulossekuntia kohdenLaskutusehdot—Veloitus
Tuloste · Videotulosteen viitehinta sekunnilta · Arvio vain vertailua varten $0.16 tulossekuntia kohden
AsetuksetVideon hintaHinnasto—Ennustettu määrä—Veloituskomponentti—Laskutusyksikkövideosekuntia kohdenLaskutusehdotresolution: 480pVeloitus
Tuloste · Videon hinta · Arvio vain vertailua varten $0.1 videosekuntia kohden
AsetuksetVideon hintaHinnasto—Ennustettu määrä—Veloituskomponentti—Laskutusyksikkövideosekuntia kohdenLaskutusehdotresolution: 768pVeloitus
Tuloste · Videon hinta · Arvio vain vertailua varten $0.16 videosekuntia kohden
AsetuksetArvioitu luontikustannusHinnasto—Ennustettu määräyhden generoinnin arvioVeloituskomponentti—Laskutusyksikkö—Laskutusehdot—Veloitus
Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.5 arvio ennen generointia

Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →

Viitehinnaston tiedot

Mallitason viitehinnastot eivät muuta menetelmän valintaa, hinta-arvioita tai veloituksia. Käytössä olevat veloitukset käyttävät valitun Ailoot-menetelmän hintoja.

Videokokoonpanojen hintaviitteet

Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

AsetuksetLaskutusehdotVeloitus
AsetuksetVideon hintaLaskutusehdotTässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa.Veloitus
Tuloste · Videon hinta $0.16 videosekuntia kohden

Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan.

AsetuksetVideon hintaLaskutusehdotresolution: 480pVeloitus
Tuloste · Videon hinta $0.1 videosekuntia kohden

Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan.

AsetuksetVideon hintaLaskutusehdotresolution: 768pVeloitus
Tuloste · Videon hinta $0.16 videosekuntia kohden

Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan.

Esimerkkipyynnöt

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

Vastaanota ja tallenna tulokset

Ailoot Ultra · Video

allekirjoitetut käyttäjälle kuuluvan sisällön osoitteet

Tarkista työn tila
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
Muut sisällön lukukerrat
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
Säilytä kaikki valmistuneet tulokset

Tallenna jokainen valmistunut video tai palautettu tiedosto; nouda jokainen todellinen palautettu aineiston URL.

Säilytä jokainen todellinen käyttäjälle kuuluva tulos ja sen mukana palautetut mitatut metatiedot.

Jos alkuperäinen vastaus on tarkistettava

503 result_pending_check + alkuperäinen id + X-Should-Retry:false; älä koskaan toista alkuperäistä pyyntöä

Vastauksen kentät
KenttäTyyppiMerkitys
KenttäindexTyyppiintegerMerkitysTämän videon nollasta alkava sijainti tulosluettelossa.
Kenttäcontent_urlTyyppistringMerkitysAllekirjoitettu HTTPS-latauksen URL-osoite tälle valmistuneelle videolle.
Kenttäsha256Tyyppistring | nullMerkitysAlkuperäisten videotavujen SHA-256-tiiviste; null, jos tietoa ei ole saatavilla.
Kenttäsize_bytesTyyppiinteger | nullMerkitysAlkuperäisen videotiedoston koko tavuina; null, jos tietoa ei ole saatavilla.
Kenttäduration_msTyyppiinteger | nullMerkitysVideon mitattu kesto millisekunteina; null, jos tietoa ei ole saatavilla.
KenttäwidthTyyppiinteger | nullMerkitysVideon leveys pikseleinä; null, jos tietoa ei ole saatavilla.
KenttäheightTyyppiinteger | nullMerkitysVideon korkeus pikseleinä; null, jos tietoa ei ole saatavilla.
Kenttävideo_codecTyyppistring | nullMerkitysVideokoodekin tunniste; null, jos sitä ei ole kirjattu.
Kenttähas_audioTyyppiboolean | nullMerkitysSisältääkö video ääniraidan; null, jos asiaa ei ole mitattu.
Kenttäaudio_codecTyyppistring | nullMerkitysÄänikoodekin tunniste; null, jos tunnistetta ei ole kirjattu.
Virheet ja seuraavat vaiheet
VastausEhtoSeuraava vaihe
Vastaus404 · not_found_errorEhtoVideoon ei päästä käsiksi tai tätä videon tunnistetta ei löytynyt.Seuraava vaiheTarkista videon käyttöoikeus. Käytä olemassa olevan videon alkuperäistä julkista tunnistetta ja samaa API-avainta.
Vastaus401 · authentication_errorEhtoAPI-avain ei vastaa todennettua tiliä.Seuraava vaiheTarkista API-avaimesi ja tilisi käyttöoikeus ennen lähettämistä.
Vastaus400 · invalid_request_errorEhtoPyyntöä ei voitu lukea tai latausindeksi on virheellinen.Seuraava vaiheKorjaa pyyntösisältö. Valitse latausta varten alkuperäisen tehtävän palauttama tulosindeksi.
Vastaus422 · price_unavailableEhtoValittua videokokoonpanoa ei voida hinnoitella.Seuraava vaiheValitse tuettu videokokoonpano ja täytä sen pakolliset asetukset ennen korjatun pyynnön lähettämistä.
Vastaus422 · invalid_request_errorEhtoVideosyöte tai alkuperäinen jatkotehtävä on virheellinen.Seuraava vaiheKäytä kelvollisia HTTPS-syötteitä. Käytä jatkamiseen valmistuneen alkuperäisen videosi julkista tunnistetta samalla API-avaimella.
Vastaus402 · billing_errorEhtoKäytettävissä oleva saldo tai rajoitukset eivät salli katevarausta.Seuraava vaiheTarkista käytettävissä oleva saldosi ja rajoitukset ennen uuden pyynnön lähettämistä.
Vastaus503 · server_errorEhtoVideon tarkistus, tallennus tai palvelun käyttö ei ole tilapäisesti saatavilla.Seuraava vaiheOdota palvelun saatavuutta. Jos sinulla on jo videon tunniste, tarkista alkuperäinen tehtävä uuden luontipyynnön lähettämisen sijaan.
Vastaus503 · result_pending_checkEhtoAlkuperäinen videotulos ja veloitus on tarkistettava.Seuraava vaiheSäilytä palautettu videon tunniste ja tarkista kyseinen tehtävä. Älä lähetä korvaavaa videon luontipyyntöä tarkistuksen aikana.
Vastaus503 · owned_result_unavailableEhtoOlemassa olevan videon lataus ei ole tilapäisesti saatavilla.Seuraava vaiheTarkista sama videotehtävä myöhemmin ja lataa sen olemassa oleva tulos. Uusi luontipyyntö luo erillisen operaation.
Vastaus409 · video_not_readyEhtoVideosisältöä ei ole julkaistu.Seuraava vaiheTarkista alkuperäisen tehtävän tila. Lataa, kun tila on completed; jos tila on failed, noudata sen veloituksen tarkistusilmoitusta.

Aliakset

Mallin aliakset

Ailoot Ultra minimax/hailuo-3-max

Menetelmäpolkujen aliakset

Käytä yllä näytettyjä menetelmäpolkuja.

Liittyvät kutsujan ID:t

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": "Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.", "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": "Säilytä jokainen todellinen käyttäjälle kuuluva tulos ja sen mukana palautetut mitatut metatiedot.", "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": "Videoon ei päästä käsiksi tai tätä videon tunnistetta ei löytynyt.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Tarkista videon käyttöoikeus. Käytä olemassa olevan videon alkuperäistä julkista tunnistetta ja samaa API-avainta.", "type": "not_found_error" }, { "condition": "API-avain ei vastaa todennettua tiliä.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Tarkista API-avaimesi ja tilisi käyttöoikeus ennen lähettämistä.", "type": "authentication_error" }, { "condition": "Pyyntöä ei voitu lukea tai latausindeksi on virheellinen.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Korjaa pyyntösisältö. Valitse latausta varten alkuperäisen tehtävän palauttama tulosindeksi.", "type": "invalid_request_error" }, { "condition": "Valittua videokokoonpanoa ei voida hinnoitella.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Valitse tuettu videokokoonpano ja täytä sen pakolliset asetukset ennen korjatun pyynnön lähettämistä.", "type": "price_unavailable" }, { "condition": "Videosyöte tai alkuperäinen jatkotehtävä on virheellinen.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Käytä kelvollisia HTTPS-syötteitä. Käytä jatkamiseen valmistuneen alkuperäisen videosi julkista tunnistetta samalla API-avaimella.", "type": "invalid_request_error" }, { "condition": "Käytettävissä oleva saldo tai rajoitukset eivät salli katevarausta.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Tarkista käytettävissä oleva saldosi ja rajoitukset ennen uuden pyynnön lähettämistä.", "type": "billing_error" }, { "condition": "Videon tarkistus, tallennus tai palvelun käyttö ei ole tilapäisesti saatavilla.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Odota palvelun saatavuutta. Jos sinulla on jo videon tunniste, tarkista alkuperäinen tehtävä uuden luontipyynnön lähettämisen sijaan.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Alkuperäinen videotulos ja veloitus on tarkistettava.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Säilytä palautettu videon tunniste ja tarkista kyseinen tehtävä. Älä lähetä korvaavaa videon luontipyyntöä tarkistuksen aikana.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Olemassa olevan videon lataus ei ole tilapäisesti saatavilla.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Tarkista sama videotehtävä myöhemmin ja lataa sen olemassa oleva tulos. Uusi luontipyyntö luo erillisen operaation.", "type": "server_error" }, { "condition": "Videosisältöä ei ole julkaistu.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Tarkista alkuperäisen tehtävän tila. Lataa, kun tila on completed; jos tila on failed, noudata sen veloituksen tarkistusilmoitusta.", "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 + alkuperäinen id + X-Should-Retry:false; älä koskaan toista alkuperäistä pyyntöä" }, "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": "Anna kehote tekstinä ja kesto kokonaisina sekunteina. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.", "required": [ "model", "prompt", "duration" ], "required_material": "Kirjoitettu kehote." }, { "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 on taulukko. Jokaisessa kuvaoliossa on type, image_url ja frame_type; image_url sisältää url-kentän. Aseta type-kentän arvoksi image_url. Käytä first_frame-arvoa ja halutessasi last_frame-arvoa. Kukin kuvan rooli esiintyy enintään kerran. Anna jokaiselle kuvalle julkinen HTTPS-kuvan URL-osoite. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Kirjoitettu kehote ja ensimmäisen ruudun kuva." } ], "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": "Tämän videon nollasta alkava sijainti tulosluettelossa.", "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": "Allekirjoitettu HTTPS-latauksen URL-osoite tälle valmistuneelle videolle.", "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": "Alkuperäisten videotavujen SHA-256-tiiviste; null, jos tietoa ei ole saatavilla.", "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": "Alkuperäisen videotiedoston koko tavuina; null, jos tietoa ei ole saatavilla.", "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": "Videon mitattu kesto millisekunteina; null, jos tietoa ei ole saatavilla.", "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": "Videon leveys pikseleinä; null, jos tietoa ei ole saatavilla.", "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": "Videon korkeus pikseleinä; null, jos tietoa ei ole saatavilla.", "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": "Videokoodekin tunniste; null, jos sitä ei ole kirjattu.", "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": "Sisältääkö video ääniraidan; null, jos asiaa ei ole mitattu.", "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": "Äänikoodekin tunniste; null, jos tunnistetta ei ole kirjattu.", "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": "allekirjoitetut käyttäjälle kuuluvan sisällön osoitteet", "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": "Nämä avaimet kuvaavat jokaista kuvaoliota; image_url sisältää vain url-kentän. Jätä frame_images pois pelkkää tekstiä sisältävästä pyynnöstä.", "content": "Kuvaolioiden taulukko. Jokaisessa oliossa on type=image_url, url-kentän sisältävä image_url ja frame_type. Käytä HTTPS-kuvan URL-osoitetta ja aseta frame_type-kentän arvoksi first_frame tai last_frame. Kukin kuvan rooli esiintyy enintään kerran.", "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": "Videotulos · viitehinta", "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": "Videon hinta", "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": "Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Arvioitu luontikustannus", "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": "10991b9b11027e795382706bc7ded26ca53ec73daec735dc8a2028a08d5a5b56", "input_html_sha256": "c2298027bbab78382d796f5aa771a6a9a35075179ce784e193a17f50939f2092", "private_audit_sha256": "a8263b391ef0d60d7947d3c30c815c49d6bccc87f677fba7a1d44646a649a88b", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/fi/minimax-hailuo-3-max/", "description": "MiniMax H3 Max on nopea, jälkikoulutettu H3-muunnelma lyhyisiin videoihin, joissa on synkronoitu ääni. MiniMaxin dokumentoitu työnkulku tukee tekstiä, ruutukuvia ja multimodaalisia viitteitä, 480P- tai 768P-tulostarkkuutta, 5–15 sekunnin kestoa sekä omia kehotteen laajennusvaihtoehtoja.", "locale": "fi", "md_url": "https://ailoot.ai/models/fi/minimax-hailuo-3-max/index.md", "title": "MiniMax: H3 Max — Ailoot", "url": "https://ailoot.ai/models/fi/minimax-hailuo-3-max/" }, "rawModel": { "about": "Nopea, jälkikoulutettu H3-muunnelma\n\nMiniMax H3 Max on MiniMax H3 -perusmallin jälkikoulutettu muunnelma, joka on optimoitu nopeampaan generointiin, kehotteen noudattamiseen ja audiovisuaaliseen laatuun. Muunnelman kehitti jälkikoulutuksella fal Research. Se säilyttää yhtenäisen multimodaalisen kontekstin sekä luontaisesti synkronoidun kuvan ja äänen. Nopeus on suunnittelun painopiste, ei kiinteä valmistumisaika jokaiselle kehotteelle, kestolle tai sovellukselle.\n\nPidä Max erillään alkuperäisestä H3-järjestelmästä ja erillisestä Max Turbo -muunnelmasta. MiniMaxin nykyinen rajapinta tarjoaa Maxille 480P- tai 768P-tarkkuuden, oletuksena 768P:n, 24 kuvaa sekunnissa ja kokonaislukuna ilmaistun 5–15 sekunnin keston. Dokumentoitu Max-työnkulku ei tarjoa alkuperäisen H3-järjestelmän 2K-asetusta eikä neljän sekunnin tulosta.\n\nKehotteesta otokseksi\n\nJokainen generointi sisältää tekstiohjeen, joka ei saa olla tyhjä; yhden tekstikohdan pituus on enintään 7 000 merkkiä. Kuvaile kohde, aloitussommittelu, toiminta ja tulos ja määrittele sitten kameran ja äänen ohjeet selvästi. Lyhyessä esineen paljastuksessa kerro, mitä katsojan tulee nähdä ensin, miten esine tulee näkyviin ja miten otoksen tulee päättyä.\n\nHyödyllinen viiden sekunnin ohje voi kuvata keraamisen kupin puupöydällä, käden asettamassa aluslautasta sen viereen, kameran pienen lähestymisen sekä keramiikan ja puun kosketusäänen. Rajaa toiminta valittuun kestoon sopivaksi ja tarkista, seuraavatko palautettu liike ja ääni samaa tapahtumaa.\n\nRuutukuvien ohjaama luominen\n\nValmistaja dokumentoi aloitusruudun, lopetusruudun tai molempien käytön. Ensimmäinen kuva määrittelee leikkeen alun, viimeinen kuva lopullisen visuaalisen tilan. Selitä ne yhdistävä liike, mukaan lukien asennon, esineen sijainnin, kameran tai valaistuksen muutokset. Vältä kahden ruudun siirtymässä ohjetta, joka tuo päätepisteiden väliin yhteensopimattoman kohtauksen.\n\nRuutukuvien ohjaama tulos saa kuvasuhteensa syötekuvasta. Pelkkään tekstiin perustuvassa työssä valitse tarkka kuvasuhde vaihtoehdoista 21:9, 16:9, 4:3, 1:1, 3:4 tai 9:16. Viitteiden ohjaamassa työssä voidaan käyttää mukautuvaa suhdetta tai jotakin dokumentoiduista täsmällisistä vaihtoehdoista. Sommittele viite tai kirjallinen kohtaus kohderuutua varten äläkä oleta saman järjestelyn toimivan yhtä hyvin pysty- ja vaakamuodossa.\n\nMultimodaaliset viitteet\n\nMiniMaxin nykyinen Max-generointiskeema dokumentoi myös viitekuvat, videot ja äänet. Kerro, mihin kunkin tulee vaikuttaa: hahmon identiteettiin, ympäristöön, liikerataan, kameran kulkuun, äänenväriin tai äänen ominaisuuteen. Ensimmäisen ja viimeisen ruudun roolit sekä viitemedian roolit sulkevat toisensa pois tässä rajapinnassa.\n\nYksilöi hahmo-otoksessa ulkonäköviite ja liikeviite erikseen ja anna sitten haluttu toiminta ja puhuttu repliikki. Esitystapaa määrittelevä ääniviite on eri asia kuin sen koko äänisignaalin kopiointi. Määrittele ohjeessa selvästi säilytettävät piirteet ja tehtävät muutokset ja vertaa varsinaista audiovisuaalista leikettä jokaiseen viiterooliin.\n\nKehotteen laajennus\n\nMaxin oma laajennusasetus tarjoaa vaihtoehdot disabled, balanced ja quality, joista balanced on oletus. Valitse disabled, kun annetun ohjeen tulee välittyä ilman laajennusta; käytä dokumentoitua laajennustilaa, kun haluat lisätulkintaa. Säilytä alkuperäinen ohje, jotta laajennuksessa syntynyt muutos voidaan erottaa pyydetystä sisällöstä.\n\nKuvaile ääni osana kohtausta. Yksilöi fyysiset äänet, taustaäänet ja mahdolliset puhutut sanat ja erota ne vain yleisölle kuuluvasta taustamusiikista. Anna tarkka repliikki ja tarkoitettu puhuja sen sijaan, että pyytäisit määrittelemätöntä vuoropuhelua. Kuuntele tulos katsomisen lisäksi; vakuuttava kuva ei osoita, että puheen sanamuoto tai ajoitus olisi oikein.\n\nSyötteiden valmistelu ja rajat\n\nValmistajan nykyinen skeema hyväksyy JPG-, JPEG-, PNG-, WebP-, HEIC- tai HEIF-kuvat, enintään 30 MB kukin, sivupituuksilla 256–5 760 pikseliä ja kuvasuhteilla 0.4–2.5. Aloitus- ja lopetusrooliin sallitaan kumpaankin yksi kuva; viitetila sallii enintään yhdeksän kuvaa. Säilytä selkeä näkymä kohteeseen ja tunnistettavina pysyviin yksityiskohtiin.\n\nViitevideona sallitaan enintään kolme MP4- tai MOV-leikettä, kukin 2–15 sekuntia ja yhteensä enintään 15 sekuntia; tiedostokohtainen raja on 50 MB. Dokumentoituina ovat H.264- tai H.265-video, AAC- tai MP3-ääni, sivupituudet 256–5 760 pikseliä, kuvasuhteet 0.4–2.5 ja kuvanopeus 23.976–60. Viiteäänenä sallitaan enintään kolme WAV- tai MP3-leikettä, kukin enintään 15 MB ja 2–15 sekuntia, yhteensä enintään 15 sekuntia. Pyynnön rungolle on erillinen 64 MB:n raja.\n\nKäytä vain otokseen vaikuttavia viitteitä ja yksilöi kunkin vaikutus tekstissä. Lyhyttä, olennaista liikeleikettä on helpompi käyttää ohjeena kuin pitkää kokoelmaa toisistaan irrallisia tapahtumia. Määrittele haluttu kesto ja tulostarkkuus selvästi, jotta tulosta voidaan verrata samaan ohjeeseen.\n\nValmis tulos\n\nValmistajan asynkroninen työnkulku palauttaa tehtävän tunnisteen ennen valmiin videon saatavuutta. Tehtäväkyselyrajapinta hakee tehtäviä edeltäviltä seitsemältä päivältä. Tallenna varsinainen palautettu leike ja sen määrittely muokkausta tai jatkoarviointia varten; tehtävätunniste ei ole audiovisuaalinen lopputulos. Latausosoitteet ovat määräaikaisia, joten säilytä itse tiedosto valittua tulosta säilyttäessäsi.\n\nArvioi kohteen jatkuvuus, liike, näkyvä teksti, vuoropuhelu ja äänen ajoitus siinä koossa, jossa leikettä käytetään. Anna seuraavaa luovaa ohjetta varten konkreettinen palaute: muuttunut ele, pois jäänyt repliikki tai korjausta vaativa rajaus. Hyödyllinen tulos on lyhyt audiovisuaalinen otos, joka liittyy annettuun sisältöön ja sen selvästi määriteltyihin viitesuhteisiin.", "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": "Konfiguraation täydet hintatiedot lisätiedoissa." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "c3ee132fc5b4cd02f24f5c4d", "label": "Videokokoonpanojen hintaviitteet", "profiles": [ { "basis": "Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan.", "dimensions": { "conditions": "Tässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa." }, "label": "Videon hinta", "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": "Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan.", "dimensions": { "conditions": "resolution: 480p" }, "label": "Videon hinta", "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": "Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan.", "dimensions": { "conditions": "resolution: 768p" }, "label": "Videon hinta", "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": "Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.", "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": "Säilytä jokainen todellinen käyttäjälle kuuluva tulos ja sen mukana palautetut mitatut metatiedot.", "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": "Videoon ei päästä käsiksi tai tätä videon tunnistetta ei löytynyt.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Tarkista videon käyttöoikeus. Käytä olemassa olevan videon alkuperäistä julkista tunnistetta ja samaa API-avainta.", "type": "not_found_error" }, { "condition": "API-avain ei vastaa todennettua tiliä.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Tarkista API-avaimesi ja tilisi käyttöoikeus ennen lähettämistä.", "type": "authentication_error" }, { "condition": "Pyyntöä ei voitu lukea tai latausindeksi on virheellinen.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Korjaa pyyntösisältö. Valitse latausta varten alkuperäisen tehtävän palauttama tulosindeksi.", "type": "invalid_request_error" }, { "condition": "Valittua videokokoonpanoa ei voida hinnoitella.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Valitse tuettu videokokoonpano ja täytä sen pakolliset asetukset ennen korjatun pyynnön lähettämistä.", "type": "price_unavailable" }, { "condition": "Videosyöte tai alkuperäinen jatkotehtävä on virheellinen.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Käytä kelvollisia HTTPS-syötteitä. Käytä jatkamiseen valmistuneen alkuperäisen videosi julkista tunnistetta samalla API-avaimella.", "type": "invalid_request_error" }, { "condition": "Käytettävissä oleva saldo tai rajoitukset eivät salli katevarausta.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Tarkista käytettävissä oleva saldosi ja rajoitukset ennen uuden pyynnön lähettämistä.", "type": "billing_error" }, { "condition": "Videon tarkistus, tallennus tai palvelun käyttö ei ole tilapäisesti saatavilla.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Odota palvelun saatavuutta. Jos sinulla on jo videon tunniste, tarkista alkuperäinen tehtävä uuden luontipyynnön lähettämisen sijaan.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Alkuperäinen videotulos ja veloitus on tarkistettava.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Säilytä palautettu videon tunniste ja tarkista kyseinen tehtävä. Älä lähetä korvaavaa videon luontipyyntöä tarkistuksen aikana.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Olemassa olevan videon lataus ei ole tilapäisesti saatavilla.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Tarkista sama videotehtävä myöhemmin ja lataa sen olemassa oleva tulos. Uusi luontipyyntö luo erillisen operaation.", "type": "server_error" }, { "condition": "Videosisältöä ei ole julkaistu.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Tarkista alkuperäisen tehtävän tila. Lataa, kun tila on completed; jos tila on failed, noudata sen veloituksen tarkistusilmoitusta.", "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 + alkuperäinen id + X-Should-Retry:false; älä koskaan toista alkuperäistä pyyntöä" }, "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": "Anna kehote tekstinä ja kesto kokonaisina sekunteina. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.", "required": [ "model", "prompt", "duration" ], "required_material": "Kirjoitettu kehote." }, { "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 on taulukko. Jokaisessa kuvaoliossa on type, image_url ja frame_type; image_url sisältää url-kentän. Aseta type-kentän arvoksi image_url. Käytä first_frame-arvoa ja halutessasi last_frame-arvoa. Kukin kuvan rooli esiintyy enintään kerran. Anna jokaiselle kuvalle julkinen HTTPS-kuvan URL-osoite. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Kirjoitettu kehote ja ensimmäisen ruudun kuva." } ], "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": "Tämän videon nollasta alkava sijainti tulosluettelossa.", "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": "Allekirjoitettu HTTPS-latauksen URL-osoite tälle valmistuneelle videolle.", "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": "Alkuperäisten videotavujen SHA-256-tiiviste; null, jos tietoa ei ole saatavilla.", "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": "Alkuperäisen videotiedoston koko tavuina; null, jos tietoa ei ole saatavilla.", "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": "Videon mitattu kesto millisekunteina; null, jos tietoa ei ole saatavilla.", "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": "Videon leveys pikseleinä; null, jos tietoa ei ole saatavilla.", "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": "Videon korkeus pikseleinä; null, jos tietoa ei ole saatavilla.", "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": "Videokoodekin tunniste; null, jos sitä ei ole kirjattu.", "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": "Sisältääkö video ääniraidan; null, jos asiaa ei ole mitattu.", "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": "Äänikoodekin tunniste; null, jos tunnistetta ei ole kirjattu.", "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": "allekirjoitetut käyttäjälle kuuluvan sisällön osoitteet", "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": "Nämä avaimet kuvaavat jokaista kuvaoliota; image_url sisältää vain url-kentän. Jätä frame_images pois pelkkää tekstiä sisältävästä pyynnöstä.", "content": "Kuvaolioiden taulukko. Jokaisessa oliossa on type=image_url, url-kentän sisältävä image_url ja frame_type. Käytä HTTPS-kuvan URL-osoitetta ja aseta frame_type-kentän arvoksi first_frame tai last_frame. Kukin kuvan rooli esiintyy enintään kerran.", "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": "Videotulos · viitehinta", "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": "Videon hinta", "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": "Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Arvioitu luontikustannus", "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 on nopea, jälkikoulutettu H3-muunnelma lyhyisiin videoihin, joissa on synkronoitu ääni. MiniMaxin dokumentoitu työnkulku tukee tekstiä, ruutukuvia ja multimodaalisia viitteitä, 480P- tai 768P-tulostarkkuutta, 5–15 sekunnin kestoa sekä omia kehotteen laajennusvaihtoehtoja." }, "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 on nopea, jälkikoulutettu H3-muunnelma lyhyisiin videoihin, joissa on synkronoitu ääni. MiniMaxin dokumentoitu työnkulku tukee tekstiä, ruutukuvia ja multimodaalisia viitteitä, 480P- tai 768P-tulostarkkuutta, 5–15 sekunnin kestoa sekä omia kehotteen laajennusvaihtoehtoja.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "fa79af75aee7a37f9a567702c6f31c9564cd2346009a7463bca9510b940cbe18", "renderer_sha256": "303a59603e2bc29ba8fda690e95fd32cec68de223d92e26054a88babff801dd7" }, "sourceRevision": "62a70aa9ac335b58751e2e71d6185c9030a10c3a943e2d2ee3655f49a4386ea0" }