Endpoint /v1/videos/generations: L-Ewwel Vidjo Tiegħek
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026 abbażi tad-dokumentazzjoni tal-vidjo ta’ xAI: hemm tliet mudelli tal-vidjo disponibbli (
grok-imagine-video-1.5, il-verżjoni-litetiegħu, ugrok-imagine-video), ir-riżoluzzjoni tilħaq sa 1080p fuq il-mudelli 1.5, il-vidjos għandha track tal-awdjo b’mod default (generate_audio), il-limiti tar-rata jingħoddu f’talbiet kull sekonda, u l-parametrusizeippreżentat mill-verżjoni qadima ma jidhirx fir-referenza tal-API. Sorsi: Ġenerazzjoni tal-Vidjo · Prezzijiet.
Iġġenera Vidjo mit-Test
L-API ta’ xAI tesponi endpoint dedikat għall-vidjo, POST /v1/videos/generations, li jibdel deskrizzjoni miktuba f’sekwenza animata billi juża wieħed mit-tliet mudelli ta’ Grok Imagine Video. Ħsiebha bħala studjo fuq talba: inti tiddeskrivi xena, il-mudell iġibha għall-moviment, u inti tirrikupra fajl MP4 lest għall-editjar. Klipps promozzjonali, viżwalizzazzjonijiet ta’ kunċetti, animazzjonijiet illustrattivi—il-każijiet kollha ta’ użu dawn jgħaddu minn dan l-istess endpoint, allura se nanalizzawh l-ewwel.
L-eżempju hawn fuq jagħtik idea tal-output mistenni. Qabel ma tikteb l-ewwel talba tiegħek, żomm f’moħħok l-erba’ limiti li jifframaw kull ma tipproduċi b’dawn il-mudelli.
Struttura tat-Talba
Il-korp tat-talba huwa oġġett JSON ta’ sempliċità li tagħtik kunfidenza. Inti tiddikjara l-mudell, tikteb il-prompt tiegħek, u tifforma r-riżultat b’tliet parametri tal-iffurmar.
{
"model": "grok-imagine-video",
"prompt": "A dolphin jumping in a sunset",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}
Hawnhekk hawn it-tifsira eżatta ta’ kull qasam:
- model:
grok-imagine-video-1.5, l-aktar ġdid, il-verżjoni ekonomika tiegħugrok-imagine-video-1.5-lite, irrakkomandata minn xAI għal vidjos sempliċi, jewgrok-imagine-video, il-ġenerazzjoni preċedenti, li għadha tintuża fl-eżempji ta’ dan il-kors - prompt: id-deskrizzjoni testwali tiegħek tax-xena mixtieqa
- duration: it-tul f’sekondi, bejn 1 u 15 (8 b’mod default)
- aspect_ratio: il-proporzjon tal-immaġni (16:9 b’mod default, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, 5:2)
- resolution:
480p(default),720p, jew1080p—dan tal-aħħar irrendutjat nativament minngrok-imagine-video-1.5fit-test-għal-vidjo u l-immaġni-għal-vidjo, miksub permezz ta’ upsampling ta’ 720p fuq il-verżjoni-lite, u nieqes minngrok-imagine-video, li jieqaf f’720p
Żewġ punti jistħoqqilhom enfasi issa stess. Il-mudell grok-imagine-video jiswa $0.050 kull sekonda ta’ vidjo ġġenerat ($0.08 għal grok-imagine-video-1.5, $0.02 għall-verżjoni -lite tiegħu, sal-3 ta’ Novembru 2026): sekwenza ta’ ħames sekondi għalhekk tiswielek $0.25 bl-ewwel wieħed, irrispettivament minn kemm-il tentattiv wasslek hemm. U l-limitu tar-rata jingħodd f’talbiet kull sekonda, skont il-livell tat-tim tiegħek: 10 fil-livell tad-dħul għall-mudelli tal-vidjo, marġni komdu għall-użu normali, li jsir limitazzjoni meta tniedi lotti massivi.
L-aktar importanti, il-ġenerazzjoni hija asinkrona. Is-sejħa POST tiegħek ma tirritornax vidjo: tirritorna request_id, u mbagħad ikun f’idejk li tħares lejn l-istatus sakemm il-fajl ikun lest. Dan il-mekkaniżmu ta’ polling huwa s-suġġett ta’ lezzjoni sħiħa aktar tard fil-kors; għalissa, ftakar biss li r-rispons immedjat huwa konferma, mhux riżultat.
L-Ewwel Sejħa Minn Truf għal Truf
Ejja ngħaddu għall-prattika bil-curl. It-talba li ġejja tordna sekwenza ta’ ħames sekondi f’720p, format landscape.
curl -X POST "https://api.x.ai/v1/videos/generations" \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video",
"prompt": "A cat playing with a ball of yarn in a bright living room",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}'
Ir-rispons joqgħod fuq linja waħda:
{
"request_id": "vid_abc123def456"
}
Żomm dan l-identifikatur sikur. Hija l-unika triq tiegħek biex tirrikupra l-vidjo ladarba l-ġenerazzjoni titlesta, u applikazzjoni li titlefu ħallset għal ġenerazzjoni li qatt mhux se tirrikupra. F’servizz reali, inti tirreġistrah qabel ma tibda anke l-polling.
Awdjo, b’Mod Default
Vidjo ġġenerat jinkludi track tal-awdjo b’mod default—b’, fuq grok-imagine-video-1.5 u l-verżjoni -lite tiegħu, kliem sinkronizzat mal-moviment tax-xofftejn. Għal vidjo mingħajr ħoss, maħsub pereżempju bħala sfond tas-sit jew għall-editjar fejn se żżid il-mużika tiegħek stess, żid "generate_audio": false fit-talba.
Biex tifforma l-output, madankollu, l-API taf biss il-proporzjon (aspect_ratio) u d-definizzjoni (resolution): ir-referenza tal-API ma tipprovdi l-ebda parametru tad-daqs tal-pixel. Fl-immaġni-għal-vidjo, il-proporzjon tal-output dejjem isegwi dak tal-immaġni sors.
Punti Ewlenin
- L-endpoint huwa
POST /v1/videos/generations, b’grok-imagine-video-1.5, il-verżjoni-litetiegħu, jewgrok-imagine-video - It-tul ivarja minn 1 sa 15-il sekonda (8 b’mod default), ir-riżoluzzjoni minn 480p sa 1080p (massimu 720p ma’
grok-imagine-video) - Il-prezz jingħodd kull sekonda ġġenerata: $0.020 (
-lite), $0.050 (grok-imagine-video), jew $0.080 (grok-imagine-video-1.5) - Il-ġenerazzjoni hija asinkrona: tirċievi
request_idbiex tagħmel polling wara - Disa’ proporzjonijiet tal-aspett huma disponibbli biex tadatta għall-formati kollha
- Track tal-awdjo jiġi ġġenerat b’mod default;
"generate_audio": falsejagħti vidjo mingħajr ħoss