Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Suhted, eraldusvõimed ja kulude haldamine

Õppetund 3 / 12 Värskendatud 3. november 2026 Kesktase
Sellel lehel
  1. Optimeeri oma videote genereerimist
  2. Vali õige kuvasuhe
  3. Kolm eraldusvõimet, sõltuvalt mudelist
  4. Mida tootmine tegelikult maksab
  5. Kiirusepiirangute haldamine
  6. Edasta video ilma seda alla laadimata
  7. Peamised punktid

Uuendatud 3. novembril 2026 vastavalt xAI video dokumentatsioonile: API aktsepteerib üheksat kuvasuhet (sh 21:9 ja 5:2) ja kolme eraldusvõimet, kusjuures 1080p sõltub mudelist; igal kolmel videomudelil on oma hinnakiri; ja vanemas versioonis esitatud pikslimõõtmetega parameeter size ei ole API referentsis enam olemas. Allikad: Video Generation · Videos API · Pricing.

Optimeeri oma videote genereerimist

Sobiva vihje (prompt) kirjutamisest ei piisa tootmisse minekuks. Ülejäänu määravad kaks tegurit: väljundite tehniline raamistus ja kulude kontroll. Stuudio, mis genereerib kuus kakssada klippi ilma prototüüpimise strateegiata, maksab mitu korda vajalikust kõrgemat hinda, ja meeskond, kes avastab projekti lõpus, et selle formaat ei sobi levikanaliga, peab otsast alustama. See tund käsitleb mõlemat punkti koos, kuna need mõjutavad teineteist.

Vali õige kuvasuhe

Parameeter aspect_ratio määrab genereeritava video proportsioonid. Aktsepteeritakse üheksat väärtust ja igaüks neist vastab kindlale levikusihtkohale.

SuheProportsioonidPeamine kasutusala
16:9Laiekraan (maastik)YouTube, esitlused, veebisaidid
9:16Püstine (portree)TikTok, Stories, Reels
1:1RuutSotsiaalmeedia postitused, pisipildid
4:3Klassikaline maastikDokumendid, slaidid
3:4Klassikaline portreePinterest, plakatid
3:2Foto maastikPortfooliod, galeriid
2:3Foto portreePlakatid, kaaned
21:9Laiekraan kinoKinematograafilised kaadrid
5:2BännerVeebibännerid, päised

Kui parameetrit ei määrata, rakendab API vaikimisi 16:9. See on veebi jaoks mõistlik vaikeväärtus, kuid muutub lõksuks niipea, kui töötled püstformaate: Reelsi mõeldud kampaania peab igas päringus deklareerima 9:16, vastasel juhul saad maastikformaadis videod, mida tuleb kärpida, kaotades seejuures kompositsiooni. Kaks režiimi on sellest seadistusest vabad: pilt-videoks (image-to-video) puhul järgib väljund lähtepildi suhet ja redigeerimisel lähtevideo suhet.

Kolm eraldusvõimet, sõltuvalt mudelist

Parameeter resolution aktsepteerib kolme väärtust. Vaikimisi väärtus 480p on mõeldud eelvaadeteks ja mustanditeks: renderdamine on kiirem, muutes selle ideaalseks katsepolügooniks vihje valideerimiseks enne lõpliku kvaliteediga uuesti käivitamist. 720p vastab HD-kvaliteedile, mis piisab enamiku veebi- ja mobiilikasutuste jaoks. 1080p annab lõpuks Full HD, kuid mitte kõigil mudelitel:

MudelMaksimaalne eraldusvõime
grok-imagine-video-1.5Native 1080p (720p referents-videos)
grok-imagine-video-1.5-lite1080p, läbi ülesskaleerimise 720p-st
grok-imagine-video720p

Redigeerimine ei ole reguleeritav: loodud video säilitab allika eraldusvõime, piirdudes 720p-ga. Nendest astmetest peenemat seadistust pole: API referents ei paku pikslisuuruse parameetrit. Kui sinu levikanal nõuab täpseid mõõtmeid, vali lähim suhe ja eraldusvõime ning kärbi seejärel redigeerimisel.

{
  "model": "grok-imagine-video-1.5",
  "prompt": "Your description",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}

Mida tootmine tegelikult maksab

Hinda arvestatakse genereeritud video sekundi kohta ja see sõltub mudelist: 0,020 $ mudeli grok-imagine-video-1.5-lite, 0,050 $ mudeli grok-imagine-video ja 0,080 $ mudeli grok-imagine-video-1.5 puhul. Tõus on täiuslikult lineaarne, mis teeb eelarve ennustatavaks.

Kestus1.5-litegrok-imagine-video1.5
1 sekund0,02 $0,05 $0,08 $
3 sekundit0,06 $0,15 $0,24 $
5 sekundit0,10 $0,25 $0,40 $
8 sekundit (vaikimisi)0,16 $0,40 $0,64 $
10 sekundit0,20 $0,50 $0,80 $
15 sekundit0,30 $0,75 $1,20 $

Alates 3. novembrist 2026 kuvab xAI Models leht iga mudeli kohta ühte hinna sekundis, tegemata vahet eraldusvõimel, samas kui Video Overview leht viitab hindadele „eraldusvõime kohta“: enne suure partii käivitamist kontrolli hinnakirja.

Esimene optimeerimishoob on mudeli valik. xAI soovitab lihtsate videote jaoks grok-imagine-video-1.5-lite, mis on neli korda odavam kui versioon 1.5, ja grok-imagine-video-1.5, kui vajad referentspilte, hääli, pealelaetud pilte või native 1080p; redigeerimine ja pikendamine toimivad seevastu ainult mudeliga grok-imagine-video. Teine hoob on katsetuste arv. Prototüübi süstemaatiliselt lühidalt: valideeri liikumissuund kahe-kolme sekundi peal, enne kui pühendud kümne või viieteistkümne sekundi genereerimisele. Täienda vihjet seni, kuni see esimesel korral õnnestub, kuna iga uuesti genereerimine maksab täishinda. Käivita need katsed 480p-s: kuvatav hind ei muutu, kuid lühenenud genereerimisaeg võimaldab kiiremini iteratsioone teha. Ja pea partii planeerimisel silmas kiirusepiirangut (rate limit).

Seda arutluskäiku on lihtne arvutada. Projekti puhul, mis koosneb kahekümnest viiesekundilisest videost mudeliga grok-imagine-video, moodustab toor-tootmiskulu 20 × 0,25 $, ehk 5,00 $ (lite-versiooniga 2,00 $, versiooniga 1.5 8,00 $). Eelda keskmiselt kahte iteratsiooni video kohta ja oled jõudnud 10,00 $ juurde. Lisa 50% eksperimenteerimise varu ja esitad eelarve 15,00 $, mis peaks paika pidama. See on suurusjärk, mille kliendile edasi anda, mitte esimese arvutuse teoreetiline kulu.

Kiirusepiirangute haldamine

API piiranguid loendatakse päringutes sekundi kohta, mudeli kohta, ja need kasvavad koos sinu meeskonna tasemega, mille määrab omakorda sinu kumulatiivne kulu: sisemisel tasemel aktsepteerivad videomudelid 10 päringut sekundis ja API vastab sellest üle minnes 429 Too Many Requests (Rate limits). Tavakasutuses seda piiri harva saavutatakse: kuna genereerimine on asünkroonne ja pikk, kulutad rohkem aega ootamisele kui saatmisele. Risk tekib massiivsete paralleelselt käivitatud partiide puhul, kus mõni koodirida võib kvoodi hetkega küllastada. Päringute vahede suurendamine piisab piirides püsimiseks.

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)

Väga suurte partiide puhul, mis võivad oodata, pakub API Batch teist teed: selle päringuid ei arvestata kiirusepiirangute vastu ja kõik kolm videomudelit aktsepteerivad seda (mudelite grok-imagine-video ja grok-imagine-video-1.5 puhul ainult teatud piirkondades). Ära oota kokkuhoidu: Batchi soodustus kehtib ainult teksti mudelitele ja video eest arvestatakse tavahinda. Töötlemine toimub üldjuhul 24 tunni jooksul, ilma garantiita.

Edasta video ilma seda alla laadimata

Viimane kasulik seadistus tootmises: parameeter output.upload_url määrab signeeritud URL-i (S3 või GCS eelsigneeritud, Azure SAS), kuhu video saadetakse automaatselt HTTP PUT meetodil koos päisega Content-Type: video/mp4 niipea, kui see on genereeritud.

{
  "model": "grok-imagine-video",
  "prompt": "Your description",
  "duration": 5,
  "output": {
    "upload_url": "https://your-storage.com/upload/video.mp4"
  }
}

Praktikas kõrvaldab see sinu töövoost ühe sammu: pole vaja iga faili alla laadida ja seejärel oma salvestusruumi tõugata, video jõuab otse sihtkohta. Mitmekümne klipi päevases voos tähendab see palju vähem ülekandekoodi ja veahaldust, mida hooldada.

Hinnad fikseeritud 3. novembril 2026 — hinnad muutuvad regulaarselt: enne mis tahes eelarve arvutamist kontrolli jooksvat hinnakirja xAI ametlikul mudelite ja hindade lehel.

Peamised punktid

  • Saadaval on üheksa kuvasuhet, vaikimisi 16:9; pilt-videoks puhul järgib väljund pildi suhet
  • Kolm eraldusvõimet: 480p (vaikimisi), 720p ja 1080p, viimane ainult 1.5 mudelitel
  • Ükski parameeter ei määra pikslisuurust: piisab suhtest ja eraldusvõimest
  • Hind on lineaarne, sekundi kohta: 0,020 $, 0,050 $ või 0,080 $ sõltuvalt mudelist
  • Prototüübi lühidalt, 480p-s, kasutades odavaimat piisavat mudelit
  • output.upload_url automatiseerib edastamise; API Batch möödub kiirusepiirangutest, ilma videole soodustuseta