Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Endpoint /v1/videos/generations: L-Ewwel Vidjo Tiegħek

Lezzjoni 1 / 12 Aġġornat 3 ta’ Novembru 2026 Livell Medju
F'din il-paġna
  1. Iġġenera Vidjo mit-Test
  2. Struttura tat-Talba
  3. L-Ewwel Sejħa Minn Truf għal Truf
  4. Awdjo, b’Mod Default
  5. Punti Ewlenin

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 -lite tiegħu, u grok-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-parametru size ippreż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.

1-15s
Tul għal Kull Vidjo
1080p
Riżoluzzjoni Massima
minn $0.02
Għal Kull Sekonda Ġġenerata
9
Proporzjonijiet Disponibbli

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ħu grok-imagine-video-1.5-lite, irrakkomandata minn xAI għal vidjos sempliċi, jew grok-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, jew 1080p—dan tal-aħħar irrendutjat nativament minn grok-imagine-video-1.5 fit-test-għal-vidjo u l-immaġni-għal-vidjo, miksub permezz ta’ upsampling ta’ 720p fuq il-verżjoni -lite, u nieqes minn grok-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 -lite tiegħu, jew grok-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_id biex 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": false jagħti vidjo mingħajr ħoss