Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Endpoint /v1/videos/generations: Do Chéad Fhíseán

Ceacht 1 as 12 Nuashonraithe 3 Samhain 2026 Meánleibhéal
Ar an leathanach seo
  1. Físeán a Ghiniúint ó Théacs
  2. Struchtúr an Iarratais
  3. An Chéad Ghlao End-to-End
  4. Fuaim, de Réir Réamhshocraithe
  5. Príomhphointí

Nuashonraithe an 3 Samhain, 2026 bunaithe ar dhoiciméadú físeáin xAI: tá trí mhúnla físeáin ar fáil (grok-imagine-video-1.5, a leagan -lite, agus grok-imagine-video), téann an taifeach suas go 1080p ar na múnlaí 1.5, tá rian fuaime ag na físeáin de réir réamhshocraithe (generate_audio, braitheann teorainneacha ráta ar iarratais in aghaidh an tsoicind, agus ní fheictear an paraiméadar size a bhí sa seanleagan sa tagairt API. Foinse: Giniúint Físeáin · Praghsáil.

Físeán a Ghiniúint ó Théacs

Nochtaíonn API xAI pointe deiridh físeáin tiomnaithe, POST /v1/videos/generations, a thiontaíonn cur síos scríofa ina sheicheamh beoite ag baint úsáide as ceann de na trí mhúnla Grok Imagine Video. Smaoinigh air mar stiúideo ar éileamh: déanann tú cur síos ar radharc, tugann an múnla gluaiseacht dó, agus faigheann tú comhad MP4 atá réidh le heagarthóireacht. Fágann gach cás úsáide—clips fógraíochta, léirshamhlú coincheapacha, beochana ilstráiceacha—an pointe deiridh céanna seo, mar sin déanfaimid anailís air ar dtús.

Tugann an sampla thuas smaointe duit ar an aschur a bhfuiltear ag súil leis. Sula scríobhann tú do chéad iarratas, coinnigh i gcuimhne na ceithre teorainn a chuimsíonn gach rud a chruthaíonn tú leis na múnlaí seo.

1-15s
Fad in aghaidh an Fhíseáin
1080p
Uastaifeach
ó $0.02
In aghaidh an Soicind Ghinte
9
Cóimheasa ar Fáil

Struchtúr an Iarratais

Is réad JSON é corp an iarratais atá simplí go leor. Dearbhaíonn tú an múnla, scríobhann tú do leid, agus frámaíonn tú an toradh le trí pharaiméadar formáidithe.

{
  "model": "grok-imagine-video",
  "prompt": "A dolphin jumping in a sunset",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}

Seo brí beacht gach réimse:

  • model: grok-imagine-video-1.5, an ceann is nuaí, a leagan eacnamaíoch grok-imagine-video-1.5-lite, a mholann xAI le haghaidh físeáin shimplí, nó grok-imagine-video, an ghiniúint roimhe seo, a úsáidtear fós i samplaí an chúrsa seo
  • prompt: do chur síos téacsúil ar an radharc atá uait
  • duration: fad i soicind, idir 1 agus 15 (8 de réir réamhshocraithe)
  • aspect_ratio: cóimheas na híomhá (16:9 de réir réamhshocraithe, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, 5:2)
  • resolution: 480p (réamhshocraithe), 720p, nó 1080p—déantar an ceann deireanach a rindreáil go dúchasach ag grok-imagine-video-1.5 i dtéacs-go-físeán agus íomhá-go-físeán, faightear é trí 720p a uas-sampláil ar an leagan -lite, agus níl sé ar fáil ar grok-imagine-video, a stopann ag 720p

Tá dhá phointe ar fiú béim a chur orthu anois. Cosnaíonn an múnla grok-imagine-video $0.050 in aghaidh gach soicind d’fhíseán ginte ($0.08 do grok-imagine-video-1.5, $0.02 dá leagan -lite, ón 3 Samhain, 2026): mar sin, cosnaíonn seicheamh cúig shoicind $0.25 duit leis an gcéad cheann, beag beann ar líon na n-iarracht a thug chugat é. Agus brathann an teorainn ráta ar iarratais in aghaidh an tsoicind, ag brath ar chéim do fhoirne: 10 ag an gcéim iontrála do mhúnlaí físeáin, corrlach compordach le haghaidh gnáthúsáide, a éiríonn ina shriain nuair a sheolann tú baisc ollmhóra.

Is rud tábhachtach fós, tá an ghiniúint asincronach. Ní thugann do ghlao POST físeán ar ais: tugann sé request_id ar ais, agus is ortsa an stádas a phollú ansin go dtí go bhfuil an comhad réidh. Is ábhar ceachta iomláin é an mheicníocht pollaithe seo níos déanaí sa chúrsa; faoi láthair, ní gá duit a mheabhrú ach gurb é an freagra láithreach ná admháil, ní toradh.

An Chéad Ghlao End-to-End

Bogaimis chuig an gcleachtas le curl. Ordaíonn an t-iarratas seo a leanas seicheamh cúig shoicind i 720p, i bhformáid tírdhreacha.

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"
  }'

Oireann an freagra ar líne amháin:

{
  "request_id": "vid_abc123def456"
}

Coinnigh an t-aitheantóir seo sábháilte. Is é do bhealach amháin é chun an físeán a fháil ar ais nuair a bheidh an ghiniúint críochnaithe, agus má chailleann feidhmchlár é, íocfaidh sé as giniúint nach bhfaighidh sé choíche. I seirbhís réadach, déanann tú logáil air fiú sula dtosaíonn tú ag pollú.

Fuaim, de Réir Réamhshocraithe

Áirítear rian fuaime le físeán ginte de réir réamhshocraithe—le, ar grok-imagine-video-1.5 agus a leagan -lite, caint atá sioncronaithe le gluaiseacht na mbéal. Le haghaidh físeáin chiúin, atá beartaithe mar shampla mar chúlra suíomh nó le haghaidh eagarthóireachta ina gcuirfidh tú do cheol féin leis, cuir "generate_audio": false leis an iarratas.

Chun an t-aschur a fhrámú, áfach, níl a fhios ag an API ach an cóimheas (aspect_ratio) agus an tsainmhíniú (resolution): ní sholáthraíonn an tagairt API aon pharaiméadar méid picteilín. I ngné íomhá-go-físeán, leanann cóimheas an aschuir cóimheas na híomhá foinse i gcónaí.

Príomhphointí

  • Is é an pointe deiridh ná POST /v1/videos/generations, le grok-imagine-video-1.5, a leagan -lite, nó grok-imagine-video
  • Rangaíonn an fad ó 1 go 15 soicind (8 de réir réamhshocraithe), an taifeach ó 480p go 1080p (720p uasta le grok-imagine-video)
  • Braitheann an praghas ar gach soicind ginte: $0.020 (-lite), $0.050 (grok-imagine-video), nó $0.080 (grok-imagine-video-1.5)
  • Tá an ghiniúint asincronach: faigheann tú request_id le pollú ina dhiaidh sin
  • Tá naoi gcóimheas gné ar fáil chun oiriúnú do gach formáid
  • Gintear rian fuaime de réir réamhshocraithe; tugann "generate_audio": false físeán ciúin