{ "aboutHtml": "

Yksi audiovisuaalinen tulos multimodaalisesta ohjeesta

MiniMax H3 on MiniMaxin kaikkia mediamuotoja yhdistävä videojärjestelmä. Se tulkitsee tekstiä, kuvia, videota ja ääntä yhdessä ja generoi sitten videon luontaisella stereoäänellä. Valmistaja esittelee sen lyhyeen luovaan työhön, kuten tuotevisualisointeihin, mainontaan, animoituihin julisteisiin ja elokuvan nimikekonsepteihin, joissa viiteaineistojen suhteet ovat yhtä tärkeitä kuin kohtauksen kuvaus.

Dokumentoitu järjestelmä tuottaa 4–15 sekunnin videota 24 kuvan sekuntinopeudella ja 32 kHz:n stereoäänellä. Sen H3-Base-generointi toimii 768p-tarkkuudella; koko 2K-työnkulku generoi tuloksen uudelleen alkuperäistä multimodaalista kontekstia käyttäen. Tämä on enemmän kuin tavallinen koon muuttaminen: toisessa vaiheessa käytetään mallia ja lähdekontekstia uudelleen hienojen yksityiskohtien palauttamiseen. H3 Maxilla ja H3-Context-IR:llä on omat tehtävänsä ja rajansa.

Tekstin ja ruutukuvien ohjaama luominen

Pelkkä tekstisyöte kuvaa koko audiovisuaalisen aikajanan. Ensimmäinen kuva kiinnittää aloituksen, viimeinen kuva lopetuksen, ja kaksi kuvaa voivat määritellä molemmat. Aloita ensimmäiseen ruutuun perustuvassa otoksessa kuvassa näkyvästä sommittelusta ja identiteetistä ja kuvaile sitten siitä kehittyvä toiminta. Kuvaile ensimmäisestä viimeiseen ruutuun siirryttäessä nämä tilat yhdistävä näkyvä liike kahden irrallisen kuvakuvauksen toistamisen sijaan.

Käytännöllinen tuoteohje voi määritellä aloitusruutuun suljetun pakkauksen, sitä avaavan käden, kameran lempeän liikkeen ja tavoitellun lopputilan. Säilytä annetuissa ruuduissa esineen muoto, etiketin sijainti ja valaistus. Ruutukuvien ohjaama ja viitteiden ohjaama luominen ovat eri syötetiloja; valmistajan rajapinta ei sekoita ensimmäisen ja viimeisen ruudun rooleja viitemedian rooleihin samassa pyynnössä.

Viitteiden ohjaama generointi ja muokkaus

Viitetila hyväksyy tekstiä yhdessä kuvien, videoleikkeiden ja äänileikkeiden kanssa. Yksilöi, mitä kukin lähde tuo: hahmon ulkonäön, paikan, kameran liikkeen, lähdeleikkeen ajallisen rakenteen tai äänen. Vain kameraliikkeen viitteenä käytetty video on eri asia kuin video, jota tulee varsinaisesti muokata tai jatkaa. Kerro tämä suhde selvästi.

Valmistajan viiteopas erottaa kohteiden määrittelyt, tehtävän yhteenvedon, säilyttämisanalyysin, yksityiskohtaisen otoskuvauksen, kokonaisäänimaiseman sekä vain yleisölle kuuluvan taustamusiikin. Se erottaa näkyvän sisällön säilyttämisen ominaisuuksien siirrosta ja laajasta tyyliviitteestä. Äänen kohdalla signaalin kopiointi eroaa äänenvärin, rytmin tai esitystavan käyttämisestä viitteenä. Pidä nämä roolit samoina koko ohjeessa.

Anna viitteisiin perustuvaa kohtausta varten hahmokuva, lyhyt kameraliikkeen viite ja ääniviite ja kuvaile sitten, mihin kunkin tulee vaikuttaa kohdeotoksessa. Kerro, minkä vaate-, ympäristö- tai esineyksityiskohtien on pysyttävä tunnistettavina. Vertaa valmista leikettä näihin vaatimuksiin, myös liikkeen jatkuvuuden sekä näkyvän puhujan ja kuullun äänen suhteen osalta.

Puhe, ääni ja otoksen ajoitus

H3 mallintaa yhdessä vuoropuhelua, fyysisiä ääniä, taustaääniä ja musiikkia. Mallikortti dokumentoi vakaan vuoropuhelutuen arabialle, kiinalle, englannille, ranskalle, saksalle, italialle, japanille, korealle, portugalille, venäjälle ja espanjalle; muiden kielten tuki kuvataan vaihtelevaksi. Anna tarkat puhutut sanat ja kieli sekä otoksesta toiseen pysyvä puhujan identiteetti.

Valmistajan kehotekirjoitusoppaat käyttävät kuvailevissa osissa englantia mutta säilyttävät vuoropuhelun ja näkyvän tekstin alkuperäisellä kielellä. Puhuttu sisältö merkitään muodossa <d>[Language] ...</d>, ja puhujan identiteetti sekä äänen kuvaus ovat lohkon ulkopuolella. Erota kohtauksessa lausuttu puhe kuvan ulkopuolisesta kertojaäänestä ja yksilöi, milloin repliikki jatkuu leikkauksen yli tai katkeaa lopussa. Säilytä myös näkyvä teksti täsmälleen. Sovita puheen määrä valittuun kestoon ja tarkasta kuvassa muodostuneet sanat sekä kuuluva repliikki yhdessä.

Kuvaile kameran liike toimintana, mukaan lukien sen laajuus ja nopeus silloin, kun ne ovat olennaisia. Numeroi otokset toistojärjestyksessä ja pidä leikkausajat videon keston sisällä. Erota kohtauksen äänet, kuten askeleet tai oven sulkeutuminen, vain yleisölle kuuluvasta taustamusiikista. Nämä valinnat helpottavat lyhyen otossuunnitelman tulkintaa ja vertaamista tulokseen.

Syötteiden valmistelu ja numeeriset rajat

Nykyinen generointiskeema vaatii kaikissa tiloissa tekstin, joka ei ole tyhjä, enintään 7 000 merkkiä tekstikohtaa kohti. Kuvat voivat olla JPG-, JPEG-, PNG-, WebP-, HEIC- tai HEIF-muodossa, enintään 30 MB kukin; jokainen sivu voi olla 256–5 760 pikseliä ja kuvasuhde 0.4–2.5. Ruutusyöte sallii yhden aloitus- ja yhden lopetuskuvan; viitetila sallii enintään yhdeksän viitekuvaa.

Viitevideo voi sisältää enintään kolme MP4- tai MOV-leikettä, kukin 2–15 sekuntia ja yhteensä enintään 15 sekuntia. Leikkeen koko voi olla enintään 50 MB; videokoodekki on H.264 tai H.265 ja ääni AAC tai MP3, sivut 256–5 760 pikseliä, kuvasuhteet 0.4–2.5 ja kuvanopeus 23.976–60. Viiteääni tukee enintään kolmea WAV- tai MP3-leikettä, enintään 15 MB kukin, kukin 2–15 sekuntia ja yhteensä enintään 15 sekuntia. Mallikortti rajaa yhdistetyt viitesyötteet 12 tiedostoon. Dokumentoitu pyynnön rungon raja on 64 MB, erillään tiedostokohtaisista rajoista.

Valitse vain ohjeeseen vaikuttavia viitteitä ja kerro jokaisen vaikutus selvästi. Selkeä näkymä kohteeseen on hyödyllisempi kuin useat ristiriitaiset näkymät ilman selitystä. Säilytä viitteiden järjestys, rajaa epäolennainen aineisto poistamatta tarpeellista kohtauskontekstia ja tarkista, että lyhyissä lähdeleikkeissä on pyydetty toiminta tai äänen ominaisuus.

Tuloksen muoto ja koko järjestelmä

Valmistajan H3-rajapinta tarjoaa 768P:n ja 2K:n. Pelkkään tekstiin perustuva generointi vaatii tarkan kuvasuhteen: 21:9, 16:9, 4:3, 1:1, 3:4 tai 9:16. Ensimmäisen ja viimeisen ruudun avulla luominen saa kuvasuhteen syötekuvasta; viiteluominen voi käyttää mukautuvaa tai tarkkaa suhdetta. Kokonaislukuna annettu tuloksen kesto on 4–15 sekuntia.

Mallikortti erottaa H3-Context-IR:n, joka tulkitsee ja rikastaa ohjetta, H3-Basen, joka generoi audiovisuaalista sisältöä, sekä H3-Regenerate-2K:n, joka luo korkeamman tarkkuuden tuloksen. Julkaistut perusmallin checkpointit erottavat ruutukuvien ohjaamat ja kaikki viitemuodot yhdistävät tehtävät. Konteksti- ja uudelleengenerointikomponentit ovat erillään näistä peruspainoista, joten pelkkä avoimen checkpointin nimi ei osoita koko järjestelmän toimintaa.

Valmistajan generointityönkulku on asynkroninen. Sen tehtäväkyselyrajapinta hakee tehtäviä edeltäviltä seitsemältä päivältä. Säilytä tehtävän tunniste varsinaisen videotuloksen palautumiseen asti ja tallenna sitten leike sen sijaan, että säilyttäisit vain määräaikaisen latausosoitteen. Arvioi visuaalinen identiteetti, pieni teksti, esineiden vuorovaikutus, puhuttu sisältö ja äänen ajoitus tarkoitetussa katselukoossa. Valmistaja nimeää multimodaalisen ymmärtämisen ja hienot visuaaliset yksityiskohdat jatkuviksi kehityskohteiksi; yksityiskohtainen ohje ja vertailu lähteeseen ovat edelleen hyödyllisen tuloksen keskiössä.

", "aboutText": "Yksi audiovisuaalinen tulos multimodaalisesta ohjeesta\n\nMiniMax H3 on MiniMaxin kaikkia mediamuotoja yhdistävä videojärjestelmä. Se tulkitsee tekstiä, kuvia, videota ja ääntä yhdessä ja generoi sitten videon luontaisella stereoäänellä. Valmistaja esittelee sen lyhyeen luovaan työhön, kuten tuotevisualisointeihin, mainontaan, animoituihin julisteisiin ja elokuvan nimikekonsepteihin, joissa viiteaineistojen suhteet ovat yhtä tärkeitä kuin kohtauksen kuvaus.\n\nDokumentoitu järjestelmä tuottaa 4–15 sekunnin videota 24 kuvan sekuntinopeudella ja 32 kHz:n stereoäänellä. Sen H3-Base-generointi toimii 768p-tarkkuudella; koko 2K-työnkulku generoi tuloksen uudelleen alkuperäistä multimodaalista kontekstia käyttäen. Tämä on enemmän kuin tavallinen koon muuttaminen: toisessa vaiheessa käytetään mallia ja lähdekontekstia uudelleen hienojen yksityiskohtien palauttamiseen. H3 Maxilla ja H3-Context-IR:llä on omat tehtävänsä ja rajansa.\n\nTekstin ja ruutukuvien ohjaama luominen\n\nPelkkä tekstisyöte kuvaa koko audiovisuaalisen aikajanan. Ensimmäinen kuva kiinnittää aloituksen, viimeinen kuva lopetuksen, ja kaksi kuvaa voivat määritellä molemmat. Aloita ensimmäiseen ruutuun perustuvassa otoksessa kuvassa näkyvästä sommittelusta ja identiteetistä ja kuvaile sitten siitä kehittyvä toiminta. Kuvaile ensimmäisestä viimeiseen ruutuun siirryttäessä nämä tilat yhdistävä näkyvä liike kahden irrallisen kuvakuvauksen toistamisen sijaan.\n\nKäytännöllinen tuoteohje voi määritellä aloitusruutuun suljetun pakkauksen, sitä avaavan käden, kameran lempeän liikkeen ja tavoitellun lopputilan. Säilytä annetuissa ruuduissa esineen muoto, etiketin sijainti ja valaistus. Ruutukuvien ohjaama ja viitteiden ohjaama luominen ovat eri syötetiloja; valmistajan rajapinta ei sekoita ensimmäisen ja viimeisen ruudun rooleja viitemedian rooleihin samassa pyynnössä.\n\nViitteiden ohjaama generointi ja muokkaus\n\nViitetila hyväksyy tekstiä yhdessä kuvien, videoleikkeiden ja äänileikkeiden kanssa. Yksilöi, mitä kukin lähde tuo: hahmon ulkonäön, paikan, kameran liikkeen, lähdeleikkeen ajallisen rakenteen tai äänen. Vain kameraliikkeen viitteenä käytetty video on eri asia kuin video, jota tulee varsinaisesti muokata tai jatkaa. Kerro tämä suhde selvästi.\n\nValmistajan viiteopas erottaa kohteiden määrittelyt, tehtävän yhteenvedon, säilyttämisanalyysin, yksityiskohtaisen otoskuvauksen, kokonaisäänimaiseman sekä vain yleisölle kuuluvan taustamusiikin. Se erottaa näkyvän sisällön säilyttämisen ominaisuuksien siirrosta ja laajasta tyyliviitteestä. Äänen kohdalla signaalin kopiointi eroaa äänenvärin, rytmin tai esitystavan käyttämisestä viitteenä. Pidä nämä roolit samoina koko ohjeessa.\n\nAnna viitteisiin perustuvaa kohtausta varten hahmokuva, lyhyt kameraliikkeen viite ja ääniviite ja kuvaile sitten, mihin kunkin tulee vaikuttaa kohdeotoksessa. Kerro, minkä vaate-, ympäristö- tai esineyksityiskohtien on pysyttävä tunnistettavina. Vertaa valmista leikettä näihin vaatimuksiin, myös liikkeen jatkuvuuden sekä näkyvän puhujan ja kuullun äänen suhteen osalta.\n\nPuhe, ääni ja otoksen ajoitus\n\nH3 mallintaa yhdessä vuoropuhelua, fyysisiä ääniä, taustaääniä ja musiikkia. Mallikortti dokumentoi vakaan vuoropuhelutuen arabialle, kiinalle, englannille, ranskalle, saksalle, italialle, japanille, korealle, portugalille, venäjälle ja espanjalle; muiden kielten tuki kuvataan vaihtelevaksi. Anna tarkat puhutut sanat ja kieli sekä otoksesta toiseen pysyvä puhujan identiteetti.\n\nValmistajan kehotekirjoitusoppaat käyttävät kuvailevissa osissa englantia mutta säilyttävät vuoropuhelun ja näkyvän tekstin alkuperäisellä kielellä. Puhuttu sisältö merkitään muodossa `[Language] ...`, ja puhujan identiteetti sekä äänen kuvaus ovat lohkon ulkopuolella. Erota kohtauksessa lausuttu puhe kuvan ulkopuolisesta kertojaäänestä ja yksilöi, milloin repliikki jatkuu leikkauksen yli tai katkeaa lopussa. Säilytä myös näkyvä teksti täsmälleen. Sovita puheen määrä valittuun kestoon ja tarkasta kuvassa muodostuneet sanat sekä kuuluva repliikki yhdessä.\n\nKuvaile kameran liike toimintana, mukaan lukien sen laajuus ja nopeus silloin, kun ne ovat olennaisia. Numeroi otokset toistojärjestyksessä ja pidä leikkausajat videon keston sisällä. Erota kohtauksen äänet, kuten askeleet tai oven sulkeutuminen, vain yleisölle kuuluvasta taustamusiikista. Nämä valinnat helpottavat lyhyen otossuunnitelman tulkintaa ja vertaamista tulokseen.\n\nSyötteiden valmistelu ja numeeriset rajat\n\nNykyinen generointiskeema vaatii kaikissa tiloissa tekstin, joka ei ole tyhjä, enintään 7 000 merkkiä tekstikohtaa kohti. Kuvat voivat olla JPG-, JPEG-, PNG-, WebP-, HEIC- tai HEIF-muodossa, enintään 30 MB kukin; jokainen sivu voi olla 256–5 760 pikseliä ja kuvasuhde 0.4–2.5. Ruutusyöte sallii yhden aloitus- ja yhden lopetuskuvan; viitetila sallii enintään yhdeksän viitekuvaa.\n\nViitevideo voi sisältää enintään kolme MP4- tai MOV-leikettä, kukin 2–15 sekuntia ja yhteensä enintään 15 sekuntia. Leikkeen koko voi olla enintään 50 MB; videokoodekki on H.264 tai H.265 ja ääni AAC tai MP3, sivut 256–5 760 pikseliä, kuvasuhteet 0.4–2.5 ja kuvanopeus 23.976–60. Viiteääni tukee enintään kolmea WAV- tai MP3-leikettä, enintään 15 MB kukin, kukin 2–15 sekuntia ja yhteensä enintään 15 sekuntia. Mallikortti rajaa yhdistetyt viitesyötteet 12 tiedostoon. Dokumentoitu pyynnön rungon raja on 64 MB, erillään tiedostokohtaisista rajoista.\n\nValitse vain ohjeeseen vaikuttavia viitteitä ja kerro jokaisen vaikutus selvästi. Selkeä näkymä kohteeseen on hyödyllisempi kuin useat ristiriitaiset näkymät ilman selitystä. Säilytä viitteiden järjestys, rajaa epäolennainen aineisto poistamatta tarpeellista kohtauskontekstia ja tarkista, että lyhyissä lähdeleikkeissä on pyydetty toiminta tai äänen ominaisuus.\n\nTuloksen muoto ja koko järjestelmä\n\nValmistajan H3-rajapinta tarjoaa 768P:n ja 2K:n. Pelkkään tekstiin perustuva generointi vaatii tarkan kuvasuhteen: 21:9, 16:9, 4:3, 1:1, 3:4 tai 9:16. Ensimmäisen ja viimeisen ruudun avulla luominen saa kuvasuhteen syötekuvasta; viiteluominen voi käyttää mukautuvaa tai tarkkaa suhdetta. Kokonaislukuna annettu tuloksen kesto on 4–15 sekuntia.\n\nMallikortti erottaa H3-Context-IR:n, joka tulkitsee ja rikastaa ohjetta, H3-Basen, joka generoi audiovisuaalista sisältöä, sekä H3-Regenerate-2K:n, joka luo korkeamman tarkkuuden tuloksen. Julkaistut perusmallin checkpointit erottavat ruutukuvien ohjaamat ja kaikki viitemuodot yhdistävät tehtävät. Konteksti- ja uudelleengenerointikomponentit ovat erillään näistä peruspainoista, joten pelkkä avoimen checkpointin nimi ei osoita koko järjestelmän toimintaa.\n\nValmistajan generointityönkulku on asynkroninen. Sen tehtäväkyselyrajapinta hakee tehtäviä edeltäviltä seitsemältä päivältä. Säilytä tehtävän tunniste varsinaisen videotuloksen palautumiseen asti ja tallenna sitten leike sen sijaan, että säilyttäisit vain määräaikaisen latausosoitteen. Arvioi visuaalinen identiteetti, pieni teksti, esineiden vuorovaikutus, puhuttu sisältö ja äänen ajoitus tarkoitetussa katselukoossa. Valmistaja nimeää multimodaalisen ymmärtämisen ja hienot visuaaliset yksityiskohdat jatkuviksi kehityskohteiksi; yksityiskohtainen ohje ja vertailu lähteeseen ovat edelleen hyödyllisen tuloksen keskiössä.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "30dbf49da293337b558a55ce387911c55715615b1847c4b19da7ec7ac4645c45", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "
MM

MiniMax: H3

MiniMax /minimax/hailuo-3

Aloitus

MiniMax H3 luo lyhyitä videoita luontaisella stereoäänellä tekstistä, ruutukuvista tai multimodaalisista viitteistä. Se tukee luomista ensimmäisen ja viimeisen ruudun avulla, viitteiden ohjaamaa muokkausta sekä liike- ja äänisuhteita, 4–15 sekunnin tulosta ja erillistä 2K-uudelleengenerointityönkulkua.

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

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

Yksi audiovisuaalinen tulos multimodaalisesta ohjeesta

MiniMax H3 on MiniMaxin kaikkia mediamuotoja yhdistävä videojärjestelmä. Se tulkitsee tekstiä, kuvia, videota ja ääntä yhdessä ja generoi sitten videon luontaisella stereoäänellä. Valmistaja esittelee sen lyhyeen luovaan työhön, kuten tuotevisualisointeihin, mainontaan, animoituihin julisteisiin ja elokuvan nimikekonsepteihin, joissa viiteaineistojen suhteet ovat yhtä tärkeitä kuin kohtauksen kuvaus.

Dokumentoitu järjestelmä tuottaa 4–15 sekunnin videota 24 kuvan sekuntinopeudella ja 32 kHz:n stereoäänellä. Sen H3-Base-generointi toimii 768p-tarkkuudella; koko 2K-työnkulku generoi tuloksen uudelleen alkuperäistä multimodaalista kontekstia käyttäen. Tämä on enemmän kuin tavallinen koon muuttaminen: toisessa vaiheessa käytetään mallia ja lähdekontekstia uudelleen hienojen yksityiskohtien palauttamiseen. H3 Maxilla ja H3-Context-IR:llä on omat tehtävänsä ja rajansa.

Tekstin ja ruutukuvien ohjaama luominen

Pelkkä tekstisyöte kuvaa koko audiovisuaalisen aikajanan. Ensimmäinen kuva kiinnittää aloituksen, viimeinen kuva lopetuksen, ja kaksi kuvaa voivat määritellä molemmat. Aloita ensimmäiseen ruutuun perustuvassa otoksessa kuvassa näkyvästä sommittelusta ja identiteetistä ja kuvaile sitten siitä kehittyvä toiminta. Kuvaile ensimmäisestä viimeiseen ruutuun siirryttäessä nämä tilat yhdistävä näkyvä liike kahden irrallisen kuvakuvauksen toistamisen sijaan.

Käytännöllinen tuoteohje voi määritellä aloitusruutuun suljetun pakkauksen, sitä avaavan käden, kameran lempeän liikkeen ja tavoitellun lopputilan. Säilytä annetuissa ruuduissa esineen muoto, etiketin sijainti ja valaistus. Ruutukuvien ohjaama ja viitteiden ohjaama luominen ovat eri syötetiloja; valmistajan rajapinta ei sekoita ensimmäisen ja viimeisen ruudun rooleja viitemedian rooleihin samassa pyynnössä.

Viitteiden ohjaama generointi ja muokkaus

Viitetila hyväksyy tekstiä yhdessä kuvien, videoleikkeiden ja äänileikkeiden kanssa. Yksilöi, mitä kukin lähde tuo: hahmon ulkonäön, paikan, kameran liikkeen, lähdeleikkeen ajallisen rakenteen tai äänen. Vain kameraliikkeen viitteenä käytetty video on eri asia kuin video, jota tulee varsinaisesti muokata tai jatkaa. Kerro tämä suhde selvästi.

Valmistajan viiteopas erottaa kohteiden määrittelyt, tehtävän yhteenvedon, säilyttämisanalyysin, yksityiskohtaisen otoskuvauksen, kokonaisäänimaiseman sekä vain yleisölle kuuluvan taustamusiikin. Se erottaa näkyvän sisällön säilyttämisen ominaisuuksien siirrosta ja laajasta tyyliviitteestä. Äänen kohdalla signaalin kopiointi eroaa äänenvärin, rytmin tai esitystavan käyttämisestä viitteenä. Pidä nämä roolit samoina koko ohjeessa.

Anna viitteisiin perustuvaa kohtausta varten hahmokuva, lyhyt kameraliikkeen viite ja ääniviite ja kuvaile sitten, mihin kunkin tulee vaikuttaa kohdeotoksessa. Kerro, minkä vaate-, ympäristö- tai esineyksityiskohtien on pysyttävä tunnistettavina. Vertaa valmista leikettä näihin vaatimuksiin, myös liikkeen jatkuvuuden sekä näkyvän puhujan ja kuullun äänen suhteen osalta.

Puhe, ääni ja otoksen ajoitus

H3 mallintaa yhdessä vuoropuhelua, fyysisiä ääniä, taustaääniä ja musiikkia. Mallikortti dokumentoi vakaan vuoropuhelutuen arabialle, kiinalle, englannille, ranskalle, saksalle, italialle, japanille, korealle, portugalille, venäjälle ja espanjalle; muiden kielten tuki kuvataan vaihtelevaksi. Anna tarkat puhutut sanat ja kieli sekä otoksesta toiseen pysyvä puhujan identiteetti.

Valmistajan kehotekirjoitusoppaat käyttävät kuvailevissa osissa englantia mutta säilyttävät vuoropuhelun ja näkyvän tekstin alkuperäisellä kielellä. Puhuttu sisältö merkitään muodossa <d>[Language] ...</d>, ja puhujan identiteetti sekä äänen kuvaus ovat lohkon ulkopuolella. Erota kohtauksessa lausuttu puhe kuvan ulkopuolisesta kertojaäänestä ja yksilöi, milloin repliikki jatkuu leikkauksen yli tai katkeaa lopussa. Säilytä myös näkyvä teksti täsmälleen. Sovita puheen määrä valittuun kestoon ja tarkasta kuvassa muodostuneet sanat sekä kuuluva repliikki yhdessä.

Kuvaile kameran liike toimintana, mukaan lukien sen laajuus ja nopeus silloin, kun ne ovat olennaisia. Numeroi otokset toistojärjestyksessä ja pidä leikkausajat videon keston sisällä. Erota kohtauksen äänet, kuten askeleet tai oven sulkeutuminen, vain yleisölle kuuluvasta taustamusiikista. Nämä valinnat helpottavat lyhyen otossuunnitelman tulkintaa ja vertaamista tulokseen.

Syötteiden valmistelu ja numeeriset rajat

Nykyinen generointiskeema vaatii kaikissa tiloissa tekstin, joka ei ole tyhjä, enintään 7 000 merkkiä tekstikohtaa kohti. Kuvat voivat olla JPG-, JPEG-, PNG-, WebP-, HEIC- tai HEIF-muodossa, enintään 30 MB kukin; jokainen sivu voi olla 256–5 760 pikseliä ja kuvasuhde 0.4–2.5. Ruutusyöte sallii yhden aloitus- ja yhden lopetuskuvan; viitetila sallii enintään yhdeksän viitekuvaa.

Viitevideo voi sisältää enintään kolme MP4- tai MOV-leikettä, kukin 2–15 sekuntia ja yhteensä enintään 15 sekuntia. Leikkeen koko voi olla enintään 50 MB; videokoodekki on H.264 tai H.265 ja ääni AAC tai MP3, sivut 256–5 760 pikseliä, kuvasuhteet 0.4–2.5 ja kuvanopeus 23.976–60. Viiteääni tukee enintään kolmea WAV- tai MP3-leikettä, enintään 15 MB kukin, kukin 2–15 sekuntia ja yhteensä enintään 15 sekuntia. Mallikortti rajaa yhdistetyt viitesyötteet 12 tiedostoon. Dokumentoitu pyynnön rungon raja on 64 MB, erillään tiedostokohtaisista rajoista.

Valitse vain ohjeeseen vaikuttavia viitteitä ja kerro jokaisen vaikutus selvästi. Selkeä näkymä kohteeseen on hyödyllisempi kuin useat ristiriitaiset näkymät ilman selitystä. Säilytä viitteiden järjestys, rajaa epäolennainen aineisto poistamatta tarpeellista kohtauskontekstia ja tarkista, että lyhyissä lähdeleikkeissä on pyydetty toiminta tai äänen ominaisuus.

Tuloksen muoto ja koko järjestelmä

Valmistajan H3-rajapinta tarjoaa 768P:n ja 2K:n. Pelkkään tekstiin perustuva generointi vaatii tarkan kuvasuhteen: 21:9, 16:9, 4:3, 1:1, 3:4 tai 9:16. Ensimmäisen ja viimeisen ruudun avulla luominen saa kuvasuhteen syötekuvasta; viiteluominen voi käyttää mukautuvaa tai tarkkaa suhdetta. Kokonaislukuna annettu tuloksen kesto on 4–15 sekuntia.

Mallikortti erottaa H3-Context-IR:n, joka tulkitsee ja rikastaa ohjetta, H3-Basen, joka generoi audiovisuaalista sisältöä, sekä H3-Regenerate-2K:n, joka luo korkeamman tarkkuuden tuloksen. Julkaistut perusmallin checkpointit erottavat ruutukuvien ohjaamat ja kaikki viitemuodot yhdistävät tehtävät. Konteksti- ja uudelleengenerointikomponentit ovat erillään näistä peruspainoista, joten pelkkä avoimen checkpointin nimi ei osoita koko järjestelmän toimintaa.

Valmistajan generointityönkulku on asynkroninen. Sen tehtäväkyselyrajapinta hakee tehtäviä edeltäviltä seitsemältä päivältä. Säilytä tehtävän tunniste varsinaisen videotuloksen palautumiseen asti ja tallenna sitten leike sen sijaan, että säilyttäisit vain määräaikaisen latausosoitteen. Arvioi visuaalinen identiteetti, pieni teksti, esineiden vuorovaikutus, puhuttu sisältö ja äänen ajoitus tarkoitetussa katselukoossa. Valmistaja nimeää multimodaalisen ymmärtämisen ja hienot visuaaliset yksityiskohdat jatkuviksi kehityskohteiksi; yksityiskohtainen ohje ja vertailu lähteeseen ovat edelleen hyödyllisen tuloksen keskiössä.

Saatavilla Ailootissa · syötteet & menetelmät

Ailoot Ultra · Video POST /v1/videos
Syötetyypit
text, image, audio, video
Tulostyypit
video
Tulosteen muoto
alkuperäiset MP4-tavut; ei normalisointia eikä uudelleenkoodausta
KenttäTyyppiVaatimusArvot & rajatOletus
KenttämodelTyyppistringVaatimusPakollinenArvot & rajat
minimax/hailuo-3
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
2K
Oletus—
Kenttäaspect_ratioTyyppistringVaatimusValinnainenArvot & rajat
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Oletus—
Kenttägenerate_audioTyyppibooleanVaatimusValinnainenArvot & rajat
false, true
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

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. Käytä yhdessä pyynnössä joko ruutukuvia tai kuvaviitteitä; älä yhdistä molempia. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.

Tarkat avaimet: type, image_url, frame_type

model: Tyyppi: string · minimax/hailuo-3

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

Reference to video · Kirjoitettu kehote ja tuetut kuva-, video- ja ääniviitteet. · Pakollinen: model, prompt, duration, input_references

input_references on oliotaulukko. Aseta type-kentän arvoksi image_url, video_url tai audio_url ja käytä vastaavaa url-kentän sisältävää kenttää. Käytä julkisia HTTPS-osoitteita. Jätä frame_images pois valitaksesi viitetilan. Arvio sisältää näytetyn kuvakohtaisen osuuden vain ensimmäisten viiden jälkeen tuleville kuvaviitteille. Lopullinen veloitus perustuu todelliseen laskutettuun kokoonpanoon. Älä yhdistä kuvaviitteitä ruutukuviin. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.

model: Tyyppi: string · minimax/hailuo-3

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, audio, video
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äLaskutusyksikköLaskutusehdotVeloitus
AsetuksetTokenien perushinnatHinnastoPerushintaEnnustettu määrä—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
AsetuksetVideon hintaHinnasto—Ennustettu määrä—Laskutusyksikkövideosekuntia kohdenLaskutusehdotTässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa.Veloitus
Tuloste · Videon hinta · Arvio vain vertailua varten $0.26 videosekuntia kohden
AsetuksetviitekuvaHinnasto—Ennustettu määrä—Laskutusyksikköviitekuvaa kohdenLaskutusehdot—Veloitus
Syöte · viitekuva · Arvio vain vertailua varten $0.08 viitekuvaa kohden
AsetuksetArvioitu luontikustannusHinnasto—Ennustettu määräyhden generoinnin arvioLaskutusyksikkö—Laskutusehdot—Veloitus
Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $1.3 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.26 videosekuntia kohden

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

AsetuksetViitekuvat ensimmäisten viiden jälkeenLaskutusehdotTässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa.Veloitus
Syöte · Viitekuvat viiden ensimmäisen jälkeen $0.08 kuvaa kohden

Ensimmäiset viisi viitekuvaa ovat maksuttomia; lueteltua kuvakohtaista hintaa sovelletaan ensimmäisten viiden jälkeen. Näytetyn kokoonpanon julkaistu hintaviite. Lopulliset veloitukset perustuvat todelliseen laskutettuun kokoonpanoon.

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

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

Menetelmäpolkujen aliakset

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

Liittyvät kutsujan ID:t

minimax/hailuo-3

", "method_identity": { "effective_request_model_id": "minimax/hailuo-3", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "minimax/hailuo-3", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|minimax%2Fhailuo-3", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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" ], "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" ], "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. Käytä yhdessä pyynnössä joko ruutukuvia tai kuvaviitteitä; älä yhdistä molempia. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Kirjoitettu kehote ja ensimmäisen ruudun kuva." }, { "mode": "Reference to video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references on oliotaulukko. Aseta type-kentän arvoksi image_url, video_url tai audio_url ja käytä vastaavaa url-kentän sisältävää kenttää. Käytä julkisia HTTPS-osoitteita. Jätä frame_images pois valitaksesi viitetilan. Arvio sisältää näytetyn kuvakohtaisen osuuden vain ensimmäisten viiden jälkeen tuleville kuvaviitteille. Lopullinen veloitus perustuu todelliseen laskutettuun kokoonpanoon. Älä yhdistä kuvaviitteitä ruutukuviin. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Kirjoitettu kehote ja tuetut kuva-, video- ja ääniviitteet." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "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" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "2K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "2K" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "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, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "minimax/hailuo-3" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "2K" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio", "video" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Arvioitu luontikustannus", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"2K\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio", "video" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" }, { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "minimax/hailuo-3", "nativeProvenance": { "input_facts_canonical_sha256": "c583abcbe81a38f396a82999d1a948d7d9e85f4b507326f335a04edf9458985b", "input_html_sha256": "9262bfcfc38ac13746fffec7bb9351449c14a2c7c4fc89a8d19ac5b12edb2ab6", "private_audit_sha256": "c3da4db6d3a7cdf6904e9c05b6f2329c67b7dff56156d28744de2fe9916b16b0", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/fi/minimax-hailuo-3/", "description": "MiniMax H3 luo lyhyitä videoita luontaisella stereoäänellä tekstistä, ruutukuvista tai multimodaalisista viitteistä. Se tukee luomista ensimmäisen ja viimeisen ruudun avulla, viitteiden ohjaamaa muokkausta sekä liike- ja äänisuhteita, 4–15 sekunnin tulosta ja erillistä 2K-uudelleengenerointityönkulkua.", "locale": "fi", "md_url": "https://ailoot.ai/models/fi/minimax-hailuo-3/index.md", "title": "MiniMax: H3 — Ailoot", "url": "https://ailoot.ai/models/fi/minimax-hailuo-3/" }, "rawModel": { "about": "Yksi audiovisuaalinen tulos multimodaalisesta ohjeesta\n\nMiniMax H3 on MiniMaxin kaikkia mediamuotoja yhdistävä videojärjestelmä. Se tulkitsee tekstiä, kuvia, videota ja ääntä yhdessä ja generoi sitten videon luontaisella stereoäänellä. Valmistaja esittelee sen lyhyeen luovaan työhön, kuten tuotevisualisointeihin, mainontaan, animoituihin julisteisiin ja elokuvan nimikekonsepteihin, joissa viiteaineistojen suhteet ovat yhtä tärkeitä kuin kohtauksen kuvaus.\n\nDokumentoitu järjestelmä tuottaa 4–15 sekunnin videota 24 kuvan sekuntinopeudella ja 32 kHz:n stereoäänellä. Sen H3-Base-generointi toimii 768p-tarkkuudella; koko 2K-työnkulku generoi tuloksen uudelleen alkuperäistä multimodaalista kontekstia käyttäen. Tämä on enemmän kuin tavallinen koon muuttaminen: toisessa vaiheessa käytetään mallia ja lähdekontekstia uudelleen hienojen yksityiskohtien palauttamiseen. H3 Maxilla ja H3-Context-IR:llä on omat tehtävänsä ja rajansa.\n\nTekstin ja ruutukuvien ohjaama luominen\n\nPelkkä tekstisyöte kuvaa koko audiovisuaalisen aikajanan. Ensimmäinen kuva kiinnittää aloituksen, viimeinen kuva lopetuksen, ja kaksi kuvaa voivat määritellä molemmat. Aloita ensimmäiseen ruutuun perustuvassa otoksessa kuvassa näkyvästä sommittelusta ja identiteetistä ja kuvaile sitten siitä kehittyvä toiminta. Kuvaile ensimmäisestä viimeiseen ruutuun siirryttäessä nämä tilat yhdistävä näkyvä liike kahden irrallisen kuvakuvauksen toistamisen sijaan.\n\nKäytännöllinen tuoteohje voi määritellä aloitusruutuun suljetun pakkauksen, sitä avaavan käden, kameran lempeän liikkeen ja tavoitellun lopputilan. Säilytä annetuissa ruuduissa esineen muoto, etiketin sijainti ja valaistus. Ruutukuvien ohjaama ja viitteiden ohjaama luominen ovat eri syötetiloja; valmistajan rajapinta ei sekoita ensimmäisen ja viimeisen ruudun rooleja viitemedian rooleihin samassa pyynnössä.\n\nViitteiden ohjaama generointi ja muokkaus\n\nViitetila hyväksyy tekstiä yhdessä kuvien, videoleikkeiden ja äänileikkeiden kanssa. Yksilöi, mitä kukin lähde tuo: hahmon ulkonäön, paikan, kameran liikkeen, lähdeleikkeen ajallisen rakenteen tai äänen. Vain kameraliikkeen viitteenä käytetty video on eri asia kuin video, jota tulee varsinaisesti muokata tai jatkaa. Kerro tämä suhde selvästi.\n\nValmistajan viiteopas erottaa kohteiden määrittelyt, tehtävän yhteenvedon, säilyttämisanalyysin, yksityiskohtaisen otoskuvauksen, kokonaisäänimaiseman sekä vain yleisölle kuuluvan taustamusiikin. Se erottaa näkyvän sisällön säilyttämisen ominaisuuksien siirrosta ja laajasta tyyliviitteestä. Äänen kohdalla signaalin kopiointi eroaa äänenvärin, rytmin tai esitystavan käyttämisestä viitteenä. Pidä nämä roolit samoina koko ohjeessa.\n\nAnna viitteisiin perustuvaa kohtausta varten hahmokuva, lyhyt kameraliikkeen viite ja ääniviite ja kuvaile sitten, mihin kunkin tulee vaikuttaa kohdeotoksessa. Kerro, minkä vaate-, ympäristö- tai esineyksityiskohtien on pysyttävä tunnistettavina. Vertaa valmista leikettä näihin vaatimuksiin, myös liikkeen jatkuvuuden sekä näkyvän puhujan ja kuullun äänen suhteen osalta.\n\nPuhe, ääni ja otoksen ajoitus\n\nH3 mallintaa yhdessä vuoropuhelua, fyysisiä ääniä, taustaääniä ja musiikkia. Mallikortti dokumentoi vakaan vuoropuhelutuen arabialle, kiinalle, englannille, ranskalle, saksalle, italialle, japanille, korealle, portugalille, venäjälle ja espanjalle; muiden kielten tuki kuvataan vaihtelevaksi. Anna tarkat puhutut sanat ja kieli sekä otoksesta toiseen pysyvä puhujan identiteetti.\n\nValmistajan kehotekirjoitusoppaat käyttävät kuvailevissa osissa englantia mutta säilyttävät vuoropuhelun ja näkyvän tekstin alkuperäisellä kielellä. Puhuttu sisältö merkitään muodossa `[Language] ...`, ja puhujan identiteetti sekä äänen kuvaus ovat lohkon ulkopuolella. Erota kohtauksessa lausuttu puhe kuvan ulkopuolisesta kertojaäänestä ja yksilöi, milloin repliikki jatkuu leikkauksen yli tai katkeaa lopussa. Säilytä myös näkyvä teksti täsmälleen. Sovita puheen määrä valittuun kestoon ja tarkasta kuvassa muodostuneet sanat sekä kuuluva repliikki yhdessä.\n\nKuvaile kameran liike toimintana, mukaan lukien sen laajuus ja nopeus silloin, kun ne ovat olennaisia. Numeroi otokset toistojärjestyksessä ja pidä leikkausajat videon keston sisällä. Erota kohtauksen äänet, kuten askeleet tai oven sulkeutuminen, vain yleisölle kuuluvasta taustamusiikista. Nämä valinnat helpottavat lyhyen otossuunnitelman tulkintaa ja vertaamista tulokseen.\n\nSyötteiden valmistelu ja numeeriset rajat\n\nNykyinen generointiskeema vaatii kaikissa tiloissa tekstin, joka ei ole tyhjä, enintään 7 000 merkkiä tekstikohtaa kohti. Kuvat voivat olla JPG-, JPEG-, PNG-, WebP-, HEIC- tai HEIF-muodossa, enintään 30 MB kukin; jokainen sivu voi olla 256–5 760 pikseliä ja kuvasuhde 0.4–2.5. Ruutusyöte sallii yhden aloitus- ja yhden lopetuskuvan; viitetila sallii enintään yhdeksän viitekuvaa.\n\nViitevideo voi sisältää enintään kolme MP4- tai MOV-leikettä, kukin 2–15 sekuntia ja yhteensä enintään 15 sekuntia. Leikkeen koko voi olla enintään 50 MB; videokoodekki on H.264 tai H.265 ja ääni AAC tai MP3, sivut 256–5 760 pikseliä, kuvasuhteet 0.4–2.5 ja kuvanopeus 23.976–60. Viiteääni tukee enintään kolmea WAV- tai MP3-leikettä, enintään 15 MB kukin, kukin 2–15 sekuntia ja yhteensä enintään 15 sekuntia. Mallikortti rajaa yhdistetyt viitesyötteet 12 tiedostoon. Dokumentoitu pyynnön rungon raja on 64 MB, erillään tiedostokohtaisista rajoista.\n\nValitse vain ohjeeseen vaikuttavia viitteitä ja kerro jokaisen vaikutus selvästi. Selkeä näkymä kohteeseen on hyödyllisempi kuin useat ristiriitaiset näkymät ilman selitystä. Säilytä viitteiden järjestys, rajaa epäolennainen aineisto poistamatta tarpeellista kohtauskontekstia ja tarkista, että lyhyissä lähdeleikkeissä on pyydetty toiminta tai äänen ominaisuus.\n\nTuloksen muoto ja koko järjestelmä\n\nValmistajan H3-rajapinta tarjoaa 768P:n ja 2K:n. Pelkkään tekstiin perustuva generointi vaatii tarkan kuvasuhteen: 21:9, 16:9, 4:3, 1:1, 3:4 tai 9:16. Ensimmäisen ja viimeisen ruudun avulla luominen saa kuvasuhteen syötekuvasta; viiteluominen voi käyttää mukautuvaa tai tarkkaa suhdetta. Kokonaislukuna annettu tuloksen kesto on 4–15 sekuntia.\n\nMallikortti erottaa H3-Context-IR:n, joka tulkitsee ja rikastaa ohjetta, H3-Basen, joka generoi audiovisuaalista sisältöä, sekä H3-Regenerate-2K:n, joka luo korkeamman tarkkuuden tuloksen. Julkaistut perusmallin checkpointit erottavat ruutukuvien ohjaamat ja kaikki viitemuodot yhdistävät tehtävät. Konteksti- ja uudelleengenerointikomponentit ovat erillään näistä peruspainoista, joten pelkkä avoimen checkpointin nimi ei osoita koko järjestelmän toimintaa.\n\nValmistajan generointityönkulku on asynkroninen. Sen tehtäväkyselyrajapinta hakee tehtäviä edeltäviltä seitsemältä päivältä. Säilytä tehtävän tunniste varsinaisen videotuloksen palautumiseen asti ja tallenna sitten leike sen sijaan, että säilyttäisit vain määräaikaisen latausosoitteen. Arvioi visuaalinen identiteetti, pieni teksti, esineiden vuorovaikutus, puhuttu sisältö ja äänen ajoitus tarkoitetussa katselukoossa. Valmistaja nimeää multimodaalisen ymmärtämisen ja hienot visuaaliset yksityiskohdat jatkuviksi kehityskohteiksi; yksityiskohtainen ohje ja vertailu lähteeseen ovat edelleen hyödyllisen tuloksen keskiössä.", "alias_of": null, "aliases": [], "author": "MiniMax", "available": null, "canonical_model": "minimax/hailuo-3", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Konfiguraation täydet hintatiedot lisätiedoissa." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "ffcc346d33bca9e66b22f181", "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.26", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Ensimmäiset viisi viitekuvaa ovat maksuttomia; lueteltua kuvakohtaista hintaa sovelletaan ensimmäisten viiden jälkeen. Näytetyn kokoonpanon julkaistu hintaviite. Lopulliset veloitukset perustuvat todelliseen laskutettuun kokoonpanoon.", "dimensions": { "conditions": "Tässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa." }, "label": "Viitekuvat ensimmäisten viiden jälkeen", "units": [ { "amount": "0.08", "amount_unit": "usd_per_image", "billing_input": false, "key": "input_image", "label": "Reference images after the first five", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_video_image_reference", "side": "in", "unit": "image" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "minimax/hailuo-3", "input": [ "text", "image", "audio", "video" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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" ], "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" ], "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. Käytä yhdessä pyynnössä joko ruutukuvia tai kuvaviitteitä; älä yhdistä molempia. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Kirjoitettu kehote ja ensimmäisen ruudun kuva." }, { "mode": "Reference to video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references on oliotaulukko. Aseta type-kentän arvoksi image_url, video_url tai audio_url ja käytä vastaavaa url-kentän sisältävää kenttää. Käytä julkisia HTTPS-osoitteita. Jätä frame_images pois valitaksesi viitetilan. Arvio sisältää näytetyn kuvakohtaisen osuuden vain ensimmäisten viiden jälkeen tuleville kuvaviitteille. Lopullinen veloitus perustuu todelliseen laskutettuun kokoonpanoon. Älä yhdistä kuvaviitteitä ruutukuviin. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Kirjoitettu kehote ja tuetut kuva-, video- ja ääniviitteet." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "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" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "2K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "2K" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "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, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "minimax/hailuo-3" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "2K" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio", "video" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Arvioitu luontikustannus", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"2K\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio", "video" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" }, { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "minimax/hailuo-3", "request_model_id": "minimax/hailuo-3", "route_label": "Ultra" } ], "name": "MiniMax: H3", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 1.3, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 1.3, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "768P" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "2K" }, "label": "Ultra", "units": [ { "amount": "0.26", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "2K" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "768P" }, "key": "input_video", "label": "input video", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "2K" }, "label": "Ultra", "units": [ { "amount": "0.26", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "2K" }, "key": "input_video", "label": "input video", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "first_free_reference_images": 5, "only_additional_images_charged": true, "reference_audio_free": true }, "label": "Ultra", "units": [ { "amount": "0.08", "amount_unit": "usd_per_input_image", "conditions": { "adds_to_output": true, "first_free_reference_images": 5, "only_additional_images_charged": true, "reference_audio_free": true }, "key": "input_image", "label": "input image", "profile_index": 4, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_image" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.26", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second", "billing_original_currency": "USD", "billing_original_rate": "0.26", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_physical_unit", "basis": "reference image", "billing_original_currency": "USD", "billing_original_rate": "0.08", "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "quantity": 1, "side": "in", "unit": "reference_image" } ] } ], "public_id": "minimax/hailuo-3", "short": "MiniMax H3 luo lyhyitä videoita luontaisella stereoäänellä tekstistä, ruutukuvista tai multimodaalisista viitteistä. Se tukee luomista ensimmäisen ja viimeisen ruudun avulla, viitteiden ohjaamaa muokkausta sekä liike- ja äänisuhteita, 4–15 sekunnin tulosta ja erillistä 2K-uudelleengenerointityönkulkua." }, "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 luo lyhyitä videoita luontaisella stereoäänellä tekstistä, ruutukuvista tai multimodaalisista viitteistä. Se tukee luomista ensimmäisen ja viimeisen ruudun avulla, viitteiden ohjaamaa muokkausta sekä liike- ja äänisuhteita, 4–15 sekunnin tulosta ja erillistä 2K-uudelleengenerointityönkulkua.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "9f8e5e539f3a3b47539e0834dbc6247206ffe82711dca4f710ecb03c26d39037", "renderer_sha256": "303a59603e2bc29ba8fda690e95fd32cec68de223d92e26054a88babff801dd7" }, "sourceRevision": "7ce0d698d3ad7e62bba606d3a93ea6191ec211cab859c63c202f4973027f128f" }