Proporzjonijiet, Riżoluzzjonijiet u Ġestjoni tal-Ispejjeż
F'din il-paġna
Aġġornat fit-3 ta’ Novembru 2026 abbażi tad-dokumentazzjoni tal-vidjow ta’ xAI: l-API taċċetta disa’ proporzjonijiet tal-aspett (inklużi
21:9u5:2) u tliet riżoluzzjonijiet, fejn1080ptiddependi mill-mudell; it-tliet mudelli tal-vidjow għandhom kull wieħed il-prezzijiet tagħhom stess; u l-parametrusize, bid-dimensjonijiet tal-pixel tiegħu, ippreżentat mill-verżjoni l-antika, ma jidhirx fir-referenza tal-API. Sorsi: Video Generation · Videos API · Pricing.
Ottimizza l-Ġenerazzjonijiet tal-Vidjow Tiegħek
Li tkun taf kif tikteb prompt mhuwiex biżżejjed biex tgħaddi għall-produzzjoni. Żewġ fatturi jiddeterminaw il-bqija: l-inquadrament tekniku tal-output tiegħek u l-kontroll tal-ispejjeż. Studjo li jiġġenera mitejn klip fix-xahar mingħajr strateġija ta’ prototipar iħallas diversi darbiet il-prezz meħtieġ, u tim li jiskopri fl-aħħar ta’ proġett li l-format tiegħu ma jaqbilx mal-kanal ta’ distribuzzjoni jkollu jerġa’ jibda minn bidu ġdid. Din il-lezzjoni tkopri ż-żewġ punti flimkien, għax jgħinu lil xulxin.
Agħżel il-Proporzjon tal-Aspett It-Tajjeb
Il-parametru aspect_ratio jistabbilixxi l-proporzjonijiet tal-vidjow iġġenerat. Disa’ valuri huma aċċettati, u kull wieħed jikkorrispondi għal destinazzjoni speċifika ta’ distribuzzjoni.
| Proporzjon | Proporzjonijiet | Użu Primarju |
|---|---|---|
16:9 | Widescreen landscape | YouTube, preżentazzjonijiet, siti web |
9:16 | Portrait | TikTok, Stories, Reels |
1:1 | Square | Posts soċjali, thumbnails |
4:3 | Classic landscape | Dokumenti, slides |
3:4 | Classic portrait | Pinterest, posters |
3:2 | Photo landscape | Portfoljos, galeriji |
2:3 | Photo portrait | Posters, qoxriet |
21:9 | Widescreen cinema | Sparati ċinematografiċi |
5:2 | Banner | Banners web, headers |
Fin-nuqqas ta’ parametru espliċitu, l-API tapplika 16:9. Dan huwa default raġonevoli għall-web, iżda jsir trap meta tibda tuża formati vertikali: kampanja maħsuba għar-Reels tridd tiddikjara 9:16 fuq kull talba, inkella se tirċievi landscapes li jkollhom bżonn jiġu maqtugħa (cropped), bil-telf tal-kompożizzjoni li dan jinvolvi. Żewġ modi huma eżentati minn din l-impostazzjoni: fl-image-to-video, l-output isegwi l-proporzjon tal-immaġni sors, u fl-editing, dak tal-vidjow sors.
Tliet Riżoluzzjonijiet, Skont il-Mudell
Il-parametru resolution jaċċetta tliet valuri. Il-valur default, 480p, huwa maħsub għal previżjonijiet u abbozzi: ir-rendering huwa aktar mgħaġġel, u jagħmilha post tat-test ideali biex tivvalida prompt qabel ma terġa’ tgħaddiha bil-kwalità finali. 720p tikkorrispondi għal kwalità HD suffiċjenti għall-maġġoranza tal-użi web u mobbli. 1080p, finalment, tagħtik Full HD, iżda mhux fuq il-mudelli kollha:
| Mudell | Riżoluzzjoni Massima |
|---|---|
grok-imagine-video-1.5 | 1080p Nattiv (720p f’reference-to-video) |
grok-imagine-video-1.5-lite | 1080p, permezz ta’ upsampling minn 720p |
grok-imagine-video | 720p |
L-editing mhuwiex aġġustabbli: il-vidjow prodott iżomm ir-riżoluzzjoni tas-sors, limitata għal 720p. U m’hemm l-ebda setting aktar fin minn dawn il-passi: ir-referenza tal-API ma tipprovdi l-ebda parametru tad-daqs tal-pixel. Jekk id-distribuzzjoni tiegħek teħtieġ dimensjonijiet eżatti, agħżel l-eqreb proporzjon u riżoluzzjoni, imbagħad aqta’ (crop) fl-editing.
{
"model": "grok-imagine-video-1.5",
"prompt": "Your description",
"aspect_ratio": "16:9",
"resolution": "1080p",
"duration": 5
}
X’Jiswa Verament il-Produzzjoni
Il-prezz jingħadd kull sekonda ta’ vidjow iġġenerat u jiddependi mill-mudell: $0.020 għal grok-imagine-video-1.5-lite, $0.050 għal grok-imagine-video, u $0.080 għal grok-imagine-video-1.5. Il-progressjoni hija perfettament lineari, li tagħmel il-baġit prevedibbli.
| Durata | 1.5-lite | grok-imagine-video | 1.5 |
|---|---|---|---|
| 1 sekonda | $0.02 | $0.05 | $0.08 |
| 3 sekondi | $0.06 | $0.15 | $0.24 |
| 5 sekondi | $0.10 | $0.25 | $0.40 |
| 8 sekondi (default) | $0.16 | $0.40 | $0.64 |
| 10 sekondi | $0.20 | $0.50 | $0.80 |
| 15-il sekonda | $0.30 | $0.75 | $1.20 |
Mill-3 ta’ Novembru 2026, il-paġna tal-Models ta’ xAI turi prezz wieħed kull sekonda għal kull mudell, mingħajr distinzjoni għar-riżoluzzjoni, filwaqt li l-paġna tal-Video Overview tirreferi għal prezzijiet “kull riżoluzzjoni”: iċċekkja l-grilja qabel ma timpenja ruħek f’batch kbir.
L-ewwel leva ta’ ottimizzazzjoni hija l-għażla tal-mudell. xAI tirrakkomanda grok-imagine-video-1.5-lite, erba’ darbiet irħas mill-verżjoni 1.5, għal vidjow sempliċi, u grok-imagine-video-1.5 meta jkollok bżonn immaġnijiet ta’ referenza, vuċijiet, immaġnijiet imposti, jew 1080p nattiva; l-editing u l-estensjoni, min-naħa l-oħra, jaħdmu biss ma’ grok-imagine-video. It-tieni leva hija n-numru ta’ provi. Ipprototipa sistematikament qasir: ivvalida d-direzzjoni tal-moviment fuq żewġ jew tliet sekondi qabel ma timpenja ruħek f’ġenerazzjoni ta’ għaxar jew ħmistax-il sekonda. Irraffina l-prompt sakemm ikun tajjeb mill-ewwel tentattiv, peress li kull riġenerazzjoni tħallas il-prezz sħiħ. Esegwixxi dawn il-provi f’480p: il-prezz muri ma jinbidilx, iżda l-ħin ta’ ġenerazzjoni mqassar jħallik tittera aktar malajr. U żomm f’moħħok il-limitu tar-rata (rate limit) meta tkun qed tippjana batch.
Dan ir-raġunament jikkalkula faċilment. Għal proġett ta’ ħamsa u għoxrin vidjow ta’ ħames sekondi b’grok-imagine-video, il-produzzjoni raw tiġi 20 × $0.25, jiġifieri $5.00 ($2.00 bil-verżjoni lite, $8.00 b’1.5). Assumi żewġ iterazzjonijiet medji kull vidjow u tkun laqaqt $10.00. Żid marġni ta’ sperimentazzjoni ta’ 50% u tippreżenta baġit ta’ $15.00 li jkun sod. Dan huwa l-ordni ta’ kobor li għandek tikkomunika lil klijent, mhux l-ispiża teoretika tal-ewwel kalkolu.
Immaniġġjar tal-Limiti tar-Rata (Rate Limits)
Il-limiti tal-API jingħaddu f’talbiet kull sekonda, kull mudell, u jikbru mat-tariffa (tier) tat-tim tiegħek, li hija stabbilita min-nefqa kumulattiva tiegħek: fit-tariffa tad-dħul, il-mudelli tal-vidjow jaċċettaw 10 talbiet kull sekonda, u l-API tirrispondi 429 Too Many Requests lil hinn minn hekk (Rate limits). F’użu komuni, dan il-limitu rari jintlaħaq: peress li l-ġenerazzjoni hija asinkrona u twila, tqatta’ aktar ħin tistenna milli tibgħat. Ir-riskju jidher fuq batches massivi mnedija parallelament, fejn ftit linji ta’ kodiċi jistgħu jissaturaw il-kwota f’daqqa waħda. Li tbiegħed is-sottomissjonijiet huwa biżżejjed biex tibqa’ fil-limiti.
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)
Għal batches kbar ħafna li jistgħu jistennew, l-API Batch joffri triq oħra: it-talbiet tiegħu ma jingħaddux kontra l-limiti tar-rata, u t-tliet mudelli tal-vidjow jaċċettawh (f’ċerti reġjuni biss għal grok-imagine-video u grok-imagine-video-1.5). Tistenniex iffrankar: l-iskont tal-Batch japplika biss għal mudelli tat-test, u l-vidjow jiġi ffatturat bir-rata standard. L-ipproċessar ġeneralment isir fi żmien 24 siegħa, mingħajr garanzija.
Ikkonsenja l-Vidjow Mingħajr Ma Tniżżlu
L-aħħar setting utli fil-produzzjoni: il-parametru output.upload_url jindika URL iffirmat (S3 jew GCS presigned, Azure SAS) li għalih il-vidjow se jintbagħat awtomatikament permezz ta’ HTTP PUT, bl-header Content-Type: video/mp4, hekk kif jiġi ġġenerat.
{
"model": "grok-imagine-video",
"prompt": "Your description",
"duration": 5,
"output": {
"upload_url": "https://your-storage.com/upload/video.mp4"
}
}
Fil-prattika, dan ineħħi pass sħiħ mill-pipeline tiegħek: m’hemmx bżonn tniżżel kull fajl imbagħed timbottah lejn il-ħażna tiegħek, il-vidjow jasal direttament fid-destinazzjoni tiegħu. Fuq fluss ta’ diversi għexieren ta’ klips kuljum, dan ifisser inqas kodiċi ta’ trasferiment u ġestjoni tal-iżbalji biex tinżamm.
Prezzijiet irreġistrati fit-3 ta’ Novembru 2026 — il-prezzijiet jevolvu regolarment: qabel kwalunkwe kalkolu tal-baġit, iċċekkja l-grilja attwali fuq il-paġna uffiċjali tal-mudelli u l-prezzijiet ta’ xAI.
Punti Ewlenin
- Disa’ proporzjonijiet tal-aspett huma disponibbli,
16:9bħala default; fl-image-to-video, l-output isegwi l-proporzjon tal-immaġni - Tliet riżoluzzjonijiet: 480p (default), 720p, u 1080p, din tal-aħħar fuq il-mudelli 1.5 biss
- L-ebda parametru ma jissettja daqs tal-pixel: il-proporzjon u r-riżoluzzjoni huma biżżejjed
- Il-prezz huwa lineari, kull sekonda: $0.020, $0.050, jew $0.080 skont il-mudell
- Ipprototipa qasir, f’480p, bl-irħas mudell li jkun biżżejjed
output.upload_urltawtomatizza l-konsenja; l-API Batch jibbies il-limiti tar-rata, mingħajr skont fuq il-vidjow