Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Suhdeluvut, resoluutiot ja kustannusten hallinta

Oppitunti 3 / 12 Päivitetty 3. marraskuuta 2026 Keskitasoinen
Tällä sivulla
  1. Optimoi videoiden tuottamisesi
  2. Valitse oikea suhdeluku
  3. Kolme resoluutiota mallista riippuen
  4. Mitä tuotanto todella maksaa
  5. Nopeusrajoitusten hallinta
  6. Toimita video lataamatta sitä
  7. Keskeiset asiat

Päivitetty 3. marraskuuta 2026 xAI:n videodokumentaation perusteella: API hyväksyy yhdeksän suhdelukua (mukaan lukien 21:9 ja 5:2) ja kolme resoluutiota, joista 1080p riippuu 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.

SuhdelukuMittasuhteetEnsisijainen käyttötarkoitus
16:9LaajakuvamaisinYouTube, esitykset, verkkosivustot
9:16PystyTikTok, Stories, Reels
1:1NeliöSosiaalisen median päivitykset, pikkukuvat
4:3Klassinen maisemaAsiakirjat, diat
3:4Klassinen pystyPinterest, julisteet
3:2Valokuvamainen maisemaPortfoliot, galleriat
2:3Valokuvamainen pystyJulisteet, kannet
21:9Elokuvamainen laajakuvaElokuvalliset otokset
5:2BanneriVerkkobannerit, 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:

MalliEnimmäisresoluutio
grok-imagine-video-1.5Natiivi 1080p (720p reference-to-video-tilassa)
grok-imagine-video-1.5-lite1080p, skaalattuna 720p:stä
grok-imagine-video720p

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.

Kesto1.5-litegrok-imagine-video1.5
1 sekunti0,02 $0,05 $0,08 $
3 sekuntia0,06 $0,15 $0,24 $
5 sekuntia0,10 $0,25 $0,40 $
8 sekuntia (oletus)0,16 $0,40 $0,64 $
10 sekuntia0,20 $0,50 $0,80 $
15 sekuntia0,30 $0,75 $1,20 $
  1. 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_url automatisoi toimituksen; API Batch ohittaa nopeusrajoitukset ilman alennusta videoihin