Suhdeluvut, resoluutiot ja kustannusten hallinta
Tällä sivulla
Päivitetty 3. marraskuuta 2026 xAI:n videodokumentaation perusteella: API hyväksyy yhdeksän suhdelukua (mukaan lukien
21:9ja5:2) ja kolme resoluutiota, joista1080priippuu mallista; kolmella videomallilla on omat hinnoittelunsa; ja vanhemman version esittelemäsize-parametri pikselimittoineen ei esiinny API-viitteessä. Lähteet: Video Generation · Videos API · Pricing.
Optimoi videoiden tuottamisesi
Kehotteen (prompt) kirjoittamisen taito ei yksinään riitä siirtymiseen tuotantovaiheeseen. Loput määräävät kaksi tekijää: tulosteesi tekninen kehystäminen ja kustannusten hallinta. Studio, joka tuottaa kaksisataa klippiä kuukaudessa ilman prototyyppistrategiaa, maksaa useita kertoja tarpeettoman hinnan, ja tiimi, joka huomaa projektin lopussa formaatin eivät vastaavan jakelukanavaa, joutuu aloittamaan alusta. Tämä oppitunti käsittelee molempia pisteitä yhdessä, sillä ne vaikuttavat toisiinsa.
Valitse oikea suhdeluku
aspect_ratio-parametri määrittää luotavan videon mittasuhteet. Hyväksyttyjä arvoja on yhdeksän, ja kukin vastaa tiettyä jakelukohtaa.
| Suhdeluku | Mittasuhteet | Ensisijainen käyttötarkoitus |
|---|---|---|
16:9 | Laajakuvamaisin | YouTube, esitykset, verkkosivustot |
9:16 | Pysty | TikTok, Stories, Reels |
1:1 | Neliö | Sosiaalisen median päivitykset, pikkukuvat |
4:3 | Klassinen maisema | Asiakirjat, diat |
3:4 | Klassinen pysty | Pinterest, julisteet |
3:2 | Valokuvamainen maisema | Portfoliot, galleriat |
2:3 | Valokuvamainen pysty | Julisteet, kannet |
21:9 | Elokuvamainen laajakuva | Elokuvalliset otokset |
5:2 | Banneri | Verkkobannerit, otsikot |
Jos parametria ei määritetä erikseen, API käyttää arvoa 16:9. Tämä on kohtuullinen oletusarvo verkkoon, mutta siitä tulee ansa, kun syötät pystyformaatteja: Reels-kampanjan on ilmoitettava 9:16 jokaisessa pyynnössä, muuten saat maisemakuvia, jotka täytyy rajata, mikä tarkoittaa sommittelun menetystä. Kaksi tilaa on vapautettu tästä asetuksesta: kuva-videoksi-muunnoksessa tuloste seuraa lähdekuvan suhdelukua, ja muokkauksessa lähdevideon suhdelukua.
Kolme resoluutiota mallista riippuen
resolution-parametri hyväksyy kolme arvoa. Oletusarvo 480p on tarkoitettu esikatseluihin ja luonnoksiin: renderöinti on nopeampaa, mikä tekee siitä ihanteellisen testialustan kehotteen validointiin ennen uudelleensuoritusta lopullisella laadulla. 720p vastaa HD-laatuja, joka riittää useimpiin web- ja mobiilikäyttötapauksiin. 1080p puolestaan tarjoaa Full HD:n, mutta ei kaikille malleille:
| Malli | Enimmäisresoluutio |
|---|---|
grok-imagine-video-1.5 | Natiivi 1080p (720p reference-to-video-tilassa) |
grok-imagine-video-1.5-lite | 1080p, skaalattuna 720p:stä |
grok-imagine-video | 720p |
Muokkaus ei ole säädettävissä: tuotettu video säilyttää lähteen resoluution, rajoitettuna 720p:hen. Näitä askelia tarkempaa asetusta ei ole: API-viite ei tarjoa pikselikokoparametria. Jos jakelusi vaatii tarkkoja mittoja, valitse lähin suhdeluku ja resoluutio, ja rajaa sitten muokkausvaiheessa.
{
"model": "grok-imagine-video-1.5",
"prompt": "Your description",
"aspect_ratio": "16:9",
"resolution": "1080p",
"duration": 5
}
Mitä tuotanto todella maksaa
Hinta lasketaan tuotetun videon sekuntia kohden ja se riippuu mallista: 0,020 $ mallille grok-imagine-video-1.5-lite, 0,050 $ mallille grok-imagine-video ja 0,080 $ mallille grok-imagine-video-1.5. Nousu on täysin lineaarista, mikä tekee budjetista ennustettavan.
| Kesto | 1.5-lite | grok-imagine-video | 1.5 |
|---|---|---|---|
| 1 sekunti | 0,02 $ | 0,05 $ | 0,08 $ |
| 3 sekuntia | 0,06 $ | 0,15 $ | 0,24 $ |
| 5 sekuntia | 0,10 $ | 0,25 $ | 0,40 $ |
| 8 sekuntia (oletus) | 0,16 $ | 0,40 $ | 0,64 $ |
| 10 sekuntia | 0,20 $ | 0,50 $ | 0,80 $ |
| 15 sekuntia | 0,30 $ | 0,75 $ | 1,20 $ |
- marraskuuta 2026 alkaen xAI:n Models-sivu näyttää yhden hinnan sekunnilta kutakin mallia kohden ilman erotusta resoluution perusteella, kun taas Video Overview -sivu viittaa hintoihin “resoluutiota kohden”: tarkista hinnasto ennen suurten erien sitomista.
Ensimmäinen optimointikeino on mallin valinta. xAI suosittelee grok-imagine-video-1.5-lite -mallia, joka on neljä kertaa halvempi kuin versio 1.5, yksinkertaisiin videoihin, ja grok-imagine-video-1.5 -mallia, kun tarvitset vertailukuvia, ääniä, määrättyjä kuvia tai natiivia 1080p-laatuja; muokkaus ja jatkaminen toimivat sitä vastoin vain grok-imagine-video-mallilla. Toinen keino on kokeilujen määrä. Tee prototyypit systemaattisesti lyhyinä: validoi liikkeen suunta kahdella tai kolmella sekunnilla ennen kuin sitoudut kymmenen tai viidentoista sekunnin generointiin. Hienosäädä kehotetta, kunnes se on oikein ensimmäisellä yrityksellä, sillä jokainen uudelleengenerointi maksaa täyden hinnan. Suorita nämä kokeilut 480p-laadulla: näkyvä hinta ei muutu, mutta lyhentynyt generointiaika mahdollistaa nopeamman iteroinnin. Pidä myös nopeusrajoitus mielessäsi suunnitellessasi erää.
Tämä päättely on helppo laskea. Projektille, jossa on kaksikymmentä viiden sekunnin videota käyttäen grok-imagine-video-mallia, raaka tuotantokustannus on 20 × 0,25 $, eli 5,00 $ (2,00 $ lite-versiolla, 8,00 $ versiolla 1.5). Oleta kaksi keskimääräistä iteraatiota videota kohden, niin pääset 10,00 $:iin. Lisää 50 % kokeilumarginaali, niin esität 15,00 $:n budjetin, joka pitää kutinsa. Tämä on se suuruusluokka, joka kannattaa viestiä asiakkaalle, ei ensimmäisen laskelman teoreettinen kustannus.
Nopeusrajoitusten hallinta
API-rajoitukset lasketaan pyyntöinä sekunnissa mallikohtaisesti, ja ne kasvavat tiimisi tason mukaan, joka määräytyy kumulatiivisten kulujesi perusteella: aloitustasolla videomallit hyväksyvät 10 pyyntöä sekunnissa, ja API vastaa 429 Too Many Requests tämän ylittyessä (Rate limits). Tavallisessa käytössä tätä rajaa saavutetaan harvoin: koska generointi on asynkronista ja hidasta, vietät enemmän aikaa odottaen kuin lähettäen. Riski ilmenee massiivisissa erissä, jotka käynnistetään rinnakkain, jolloin muutama koodirivi voi kyllästää kiintiön hetkessä. Lähetysten välistäminen riittää pysymään rajojen sisällä.
import asyncio
async def soumettre_lot(prompts, par_seconde=5):
"""Submits generations without exceeding the rate limit."""
for prompt in prompts:
await soumettre_video(prompt) # POST, without waiting for completion
await asyncio.sleep(1 / par_seconde)
Erittäin suurille erille, jotka voivat odottaa, API Batch tarjoaa toisen polun: sen pyynnöt eivät kuluta nopeusrajoituksia, ja kaikki kolme videomallia hyväksyvät sen (vain tietyillä alueilla malleille grok-imagine-video ja grok-imagine-video-1.5). Älä odota säästöjä: Batch-alennus koskee vain tekstimalleja, ja videoita laskutetaan normaalihinnalla. Käsittely tapahtuu yleensä 24 tunnin kuluessa, ilman takuuta.
Toimita video lataamatta sitä
Viimeinen hyödyllinen asetus tuotannossa: output.upload_url-parametri määrittää allekirjoitetun URL-osoitteen (S3- tai GCS-esiallekirjoitettu, Azure SAS), johon video lähetetään automaattisesti HTTP PUT -menetelmällä otsikolla Content-Type: video/mp4 heti sen valmistuttua.
{
"model": "grok-imagine-video",
"prompt": "Your description",
"duration": 5,
"output": {
"upload_url": "https://your-storage.com/upload/video.mp4"
}
}
Käytännössä tämä poistaa koko vaiheen putkestasi: ei tarvitse ladata jokaista tiedostoa ja työntää sitä tallennustilaan, vaan video saapuu suoraan määränpäähänsä. Useiden kymmenien klippien päivittäisessä virrassa tämä tarkoittaa vähemmän siirtokoodia ja virheenkäsittelyä ylläpidettäväksi.
Hinnoittelu kirjattu 3. marraskuuta 2026 — hinnat muuttuvat säännöllisesti: ennen kuin lasket budjettia, tarkista nykyinen hinnasto xAI:n viralliselta mallien ja hinnoittelun sivulta.
Keskeiset asiat
- Käytettävissä on yhdeksän suhdelukua, oletuksena
16:9; kuva-videoksi-muunnoksessa tuloste seuraa kuvan suhdelukua - Kolme resoluutiota: 480p (oletus), 720p ja 1080p, joista viimeisin vain 1.5-malleissa
- Mikään parametri ei määritä pikselikokoa: suhdeluku ja resoluutio riittävät
- Hinta on lineaarinen sekuntia kohden: 0,020 $, 0,050 $ tai 0,080 $ mallista riippuen
- Tee prototyypit lyhyinä, 480p-laadulla ja halvimmalla riittävällä mallilla
output.upload_urlautomatisoi toimituksen; API Batch ohittaa nopeusrajoitukset ilman alennusta videoihin