Suhted, eraldusvõimed ja kulude haldamine
Sellel lehel
Uuendatud 3. novembril 2026 vastavalt xAI video dokumentatsioonile: API aktsepteerib üheksat kuvasuhet (sh
21:9ja5:2) ja kolme eraldusvõimet, kusjuures1080psõltub mudelist; igal kolmel videomudelil on oma hinnakiri; ja vanemas versioonis esitatud pikslimõõtmetega parameetersizeei 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.
| Suhe | Proportsioonid | Peamine kasutusala |
|---|---|---|
16:9 | Laiekraan (maastik) | YouTube, esitlused, veebisaidid |
9:16 | Püstine (portree) | TikTok, Stories, Reels |
1:1 | Ruut | Sotsiaalmeedia postitused, pisipildid |
4:3 | Klassikaline maastik | Dokumendid, slaidid |
3:4 | Klassikaline portree | Pinterest, plakatid |
3:2 | Foto maastik | Portfooliod, galeriid |
2:3 | Foto portree | Plakatid, kaaned |
21:9 | Laiekraan kino | Kinematograafilised kaadrid |
5:2 | Bänner | Veebibä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:
| Mudel | Maksimaalne eraldusvõime |
|---|---|
grok-imagine-video-1.5 | Native 1080p (720p referents-videos) |
grok-imagine-video-1.5-lite | 1080p, läbi ülesskaleerimise 720p-st |
grok-imagine-video | 720p |
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.
| Kestus | 1.5-lite | grok-imagine-video | 1.5 |
|---|---|---|---|
| 1 sekund | 0,02 $ | 0,05 $ | 0,08 $ |
| 3 sekundit | 0,06 $ | 0,15 $ | 0,24 $ |
| 5 sekundit | 0,10 $ | 0,25 $ | 0,40 $ |
| 8 sekundit (vaikimisi) | 0,16 $ | 0,40 $ | 0,64 $ |
| 10 sekundit | 0,20 $ | 0,50 $ | 0,80 $ |
| 15 sekundit | 0,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_urlautomatiseerib edastamise; API Batch möödub kiirusepiirangutest, ilma videole soodustuseta