Source: https://ailoot.ai/models/fi/minimax-hailuo-3-max/
Canonical: https://ailoot.ai/models/fi/minimax-hailuo-3-max/
Language: fi

# MiniMax: H3 Max

[Markdown](https://ailoot.ai/models/fi/minimax-hailuo-3-max/index.md) · [JSON](https://ailoot.ai/models/fi/minimax-hailuo-3-max/facts.json)

## [MiniMax: H3 Max](https://ailoot.ai/models/fi/minimax-hailuo-3-max/)

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

- [**Ailoot Ultra · Video** `POST /v1/videos` `minimax/hailuo-3-max`](https://ailoot.ai/models/fi/minimax-hailuo-3-max/#method-0)

Tietoa mallista

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

Nopea, jälkikoulutettu H3-muunnelma

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

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

Kehotteesta otokseksi

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

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

Ruutukuvien ohjaama luominen

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

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

Multimodaaliset viitteet

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

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

Kehotteen laajennus

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

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

Syötteiden valmistelu ja rajat

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

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

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

Valmis tulos

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

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

**Ailoot Ultra · Video** `POST /v1/videos` `minimax/hailuo-3-max`

[`minimax/hailuo-3-max`](https://ailoot.ai/models/fi/#m=minimax%2Fhailuo-3-max&route=Ultra&caller=minimax%2Fhailuo-3-max&fmt=videos)

MiniMax /`minimax/hailuo-3-max`

### Aloitus

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

Hyväksytyt syötteet

Teksti · Kuvat

Tulokset

Video

### Saatavilla Ailootissa · syötteet & menetelmät

**Ailoot Ultra · Video** `POST /v1/videos`

Syötetyypit

`text`, `image`

Tulostyypit

`video`

Tulosteen muoto

alkuperäiset MP4-tavut; ei normalisointia eikä uudelleenkoodausta

| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
| --- | --- | --- | --- | --- |
| Kenttä`model` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat minimax/hailuo-3-max | Oletus— |
| Kenttä`prompt` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat | Oletus— |
| Kenttä`duration` | Tyyppi`integer` | VaatimusPakollinen | Arvot & rajat 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Vähimmäismäärä: 1 Enimmäismäärä: 600 | Oletus— |
| Kenttä`resolution` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat 768p, 480p | Oletus— |
| Kenttä`aspect_ratio` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Oletus— |
| Kenttä`generate_audio` | Tyyppi`boolean` | VaatimusValinnainen | Arvot & rajat false | Oletus— |
| Kenttä`frame_images` | Tyyppi`array` | VaatimusValinnainen | Arvot & 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_references` | Tyyppi`array` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`callback_url` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Merkkijonomalli: ^https:// | Oletus— |
| Kenttä`session_id` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`trace` | Tyyppi`object` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`user` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— |

Syöteaineistojen yhdistelmät

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

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

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

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

**Kuvasta videoksi** · Kirjoitettu kehote ja ensimmäisen ruudun kuva. · Pakollinen: model, prompt, duration, frame\_images

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

Tarkat avaimet: type, image\_url, frame\_type

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

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

Menetelmän parametrit ja elinkaari

| Parametri | Sopimus |
| --- | --- |
| Parametri`content_type` | Sopimusapplication/json |
| Parametri`required` | Sopimusmodel, prompt, duration |
| Parametri`material_types` | Sopimustext, image |
| Parametri`additional_properties` | Sopimusfalse |
| Parametri`optional_controls` | Sopimusresolution, 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.

| Asetukset | Hinnasto | Ennustettu määrä | Veloituskomponentti | Laskutusyksikkö | Laskutusehdot | Veloitus |
| --- | --- | --- | --- | --- | --- | --- |
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Veloituskomponentti— | Laskutusyksikkö— | Laskutusehdot— | Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten **—** / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten **—** / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten **—** / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten **—** / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten **—** / 1K tokenia |
| AsetuksetVideotulos · viitehinta | Hinnasto— | Ennustettu määrä— | Veloituskomponentti`reference_output_rate` | Laskutusyksikkötulossekuntia kohden | Laskutusehdot— | Veloitus Tuloste · Videotulosteen viitehinta sekunnilta · Arvio vain vertailua varten **$0.16** tulossekuntia kohden |
| AsetuksetVideon hinta | Hinnasto— | Ennustettu määrä— | Veloituskomponentti— | Laskutusyksikkövideosekuntia kohden | Laskutusehdotresolution: 480p | Veloitus Tuloste · Videon hinta · Arvio vain vertailua varten **$0.1** videosekuntia kohden |
| AsetuksetVideon hinta | Hinnasto— | Ennustettu määrä— | Veloituskomponentti— | Laskutusyksikkövideosekuntia kohden | Laskutusehdotresolution: 768p | Veloitus Tuloste · Videon hinta · Arvio vain vertailua varten **$0.16** videosekuntia kohden |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Veloituskomponentti— | Laskutusyksikkö— | Laskutusehdot— | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten **$0.5** arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta. |

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. [Varauksen ja lopullisen veloituksen toiminta →](https://ailoot.ai/docs/fi/billing/reserve/)

#### 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.

| Asetukset | Laskutusehdot | Veloitus |
| --- | --- | --- |
| AsetuksetVideon hinta | LaskutusehdotTässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa. | Veloitus Tuloste · Videon hinta **$0.16** videosekuntia kohden Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan. |
| AsetuksetVideon hinta | Laskutusehdotresolution: 480p | Veloitus Tuloste · Videon hinta **$0.1** videosekuntia kohden Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan. |
| AsetuksetVideon hinta | Laskutusehdotresolution: 768p | Veloitus Tuloste · Videon hinta **$0.16** videosekuntia kohden Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan. |

### Esimerkkipyynnöt

#### Ailoot Ultra · Video

curl · luo video

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3-max","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

### Vastaanota ja tallenna tulokset

#### Ailoot Ultra · Video

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

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### Tarkista työn tila

GET alkuperäisen toiminnon tila

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

Muut sisällön lukukerrat

Tallenna jokainen valmistunut omistamasi tuloste

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    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')
    target=Path('owned-'+label+'.bin')
    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)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
```

##### 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ä | Tyyppi | Merkitys |
| --- | --- | --- |
| Kenttä`index` | Tyyppiinteger | MerkitysTämän videon nollasta alkava sijainti tulosluettelossa. |
| Kenttä`content_url` | Tyyppistring | MerkitysAllekirjoitettu HTTPS-latauksen URL-osoite tälle valmistuneelle videolle. |
| Kenttä`sha256` | Tyyppistring \| null | MerkitysAlkuperäisten videotavujen SHA-256-tiiviste; null, jos tietoa ei ole saatavilla. |
| Kenttä`size_bytes` | Tyyppiinteger \| null | MerkitysAlkuperäisen videotiedoston koko tavuina; null, jos tietoa ei ole saatavilla. |
| Kenttä`duration_ms` | Tyyppiinteger \| null | MerkitysVideon mitattu kesto millisekunteina; null, jos tietoa ei ole saatavilla. |
| Kenttä`width` | Tyyppiinteger \| null | MerkitysVideon leveys pikseleinä; null, jos tietoa ei ole saatavilla. |
| Kenttä`height` | Tyyppiinteger \| null | MerkitysVideon korkeus pikseleinä; null, jos tietoa ei ole saatavilla. |
| Kenttä`video_codec` | Tyyppistring \| null | MerkitysVideokoodekin tunniste; null, jos sitä ei ole kirjattu. |
| Kenttä`has_audio` | Tyyppiboolean \| null | MerkitysSisältääkö video ääniraidan; null, jos asiaa ei ole mitattu. |
| Kenttä`audio_codec` | Tyyppistring \| null | MerkitysÄänikoodekin tunniste; null, jos tunnistetta ei ole kirjattu. |

Virheet ja seuraavat vaiheet

| Vastaus | Ehto | Seuraava vaihe |
| --- | --- | --- |
| Vastaus404 · `not_found_error` | EhtoVideoon 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_error` | EhtoAPI-avain ei vastaa todennettua tiliä. | Seuraava vaiheTarkista API-avaimesi ja tilisi käyttöoikeus ennen lähettämistä. |
| Vastaus400 · `invalid_request_error` | EhtoPyyntöä ei voitu lukea tai latausindeksi on virheellinen. | Seuraava vaiheKorjaa pyyntösisältö. Valitse latausta varten alkuperäisen tehtävän palauttama tulosindeksi. |
| Vastaus422 · `price_unavailable` | EhtoValittua videokokoonpanoa ei voida hinnoitella. | Seuraava vaiheValitse tuettu videokokoonpano ja täytä sen pakolliset asetukset ennen korjatun pyynnön lähettämistä. |
| Vastaus422 · `invalid_request_error` | EhtoVideosyö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_error` | EhtoKä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_error` | EhtoVideon 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_check` | EhtoAlkuperä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_unavailable` | EhtoOlemassa 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_ready` | EhtoVideosisältöä ei ole julkaistu. | Seuraava vaiheTarkista alkuperäisen tehtävän tila. Lataa, kun tila on completed; jos tila on failed, noudata sen veloituksen tarkistusilmoitusta. |

### Aliakset

#### Mallin aliakset

**Ailoot Ultra** [`minimax/hailuo-3-max`](https://ailoot.ai/models/fi/#m=minimax%2Fhailuo-3-max&route=Ultra&caller=minimax%2Fhailuo-3-max&fmt=videos)

#### Menetelmäpolkujen aliakset

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

#### Liittyvät kutsujan ID:t

[`minimax/hailuo-3-max`](https://ailoot.ai/models/fi/#m=minimax%2Fhailuo-3-max&route=Ultra&caller=minimax%2Fhailuo-3-max&fmt=videos)

FAQ · MiniMax: H3 Max

Mitä syötteitä ja tuloksia on saatavilla?

`POST /v1/videos` · `minimax/hailuo-3-max`: `text`, `image` → `video`

Mitä kenttiä pyyntö käyttää?

`POST /v1/videos` · `minimax/hailuo-3-max`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `callback_url`, `session_id`, `trace`, `user`

Mitä rajoja sovelletaan?

`POST /v1/videos` · `minimax/hailuo-3-max`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `2`; `frame_images.min_items`: `1`

Yhdistä Ailoot Claude Codeen, OpenCodeen, Hermesiin tai omaan sovellukseesi.

## Yritys ja sen projektisalkku

Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.

## Osta tokenit alennuksella.

Tilausalennus säännölliseen käyttöön. Kampanjakoodit — jopa 50% tokeniostoista.

Tilaus

Valitse alennushintainen paketti säännöllisiä pyyntöjäsi varten.

Kampanjakoodi jopa 50%

Syötä koodi oston yhteydessä. Hinta lasketaan uudelleen voimassa olevan kampanjan mukaan.

Kulut historiassa

Malli, tokenit ja summa tallennetaan jokaiselle pyynnölle.

[Valitse tilaus](https://ailoot.ai/docs/fi/billing/subscriptions/) · [Katso mallihinnat](https://ailoot.ai/models/fi/)

## Yhdistä API tuotteeseen, jonka myyt.

SaaS, sovellukset ja botit Ailootin palveluehtojen ja lisenssisopimuksen mukaisesti. Pyydä edelleenmyyntiin jälleenmyyjälisenssi.

Kaupallinen sovellus

Lisää tekstin, kuvien, videoiden ja äänen luonti palvelusi maksullisiin ominaisuuksiin.

Jälleenmyyjälisenssi

Lähetä projektikuvaus ja pääsyn toteutustapa. Pyydä kirjalliset käyttö- ja jälleenmyyntiehdot.

Asiakirjat verkkosivustolla

Palveluehdot, lisenssisopimus ja tietojenkäsittelykäytäntö ovat saatavilla ennen yhdistämistä.

[Pyydä jälleenmyyjälisenssi](mailto:support@ailoot.ai) · [Palveluehdot ja lisenssisopimus](https://ailoot.ai/legal/offer?lang=fi)

## Ailoot · Yritys ja sen projektisalkku





Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.





Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.





Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.
