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

Na pointí deiridh atá ar fáil

Ceacht 13 as 14 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Forbhreathnú ar an API Grok
  2. Giniúint téacs
  3. Próiseáil asionchronach
  4. Giniúint íomhánna
  5. Giniúint físeáin
  6. Sintéis cainte
  7. Gníomhaire gutha fíor-ama
  8. Bainistíocht comhad
  9. Próiseáil bhaisce
  10. Uirlisí ionsuite taobh freastalaí
  11. Príomhphointí

Forbhreathnú ar an API Grok

Níl an API xAI teoranta do ghiniúint téacs amháin. Nochtann sé sraith pointí deiridh a chlúdaíonn giniúint íomhánna agus físeáin, sintéis cainte, bainistíocht comhad, agus próiseáil asionchronach. Léarscáileoidh an ceacht seo na pointí deiridh atá ar fáil ionas go mbeidh a fhios agat cé na gnéithe le húsáid i do thionscadail.

Giniúint téacs

POST /v1/responses (molta)

Seo an príomhphointe deiridh d’aon idirghníomhaíocht le samhlacha Grok. Tacaíonn sé le téacs, radharc, uirlisí (glao feidhme), cuardach gréasáin, agus cuardach X.

Príomhpharaiméadair: model, input, instructions, stream, tools, reasoning.

POST /v1/chat/completions (comhoiriúnach le OpenAI)

An pointe deiridh i bhformáid OpenAI, arna choinneáil le haghaidh comhoiriúnachta le huirlisí atá ann cheana. Glacann sé leis na paraiméadair chéanna leis an API OpenAI: model, messages, temperature, stream, tools.

GET /v1/responses/{id}

Faigheann sé freagra a gineadh roimhe seo má stóráladh é (paraiméadar store: true). Coinnítear freagraí ar feadh 30 lá.

DELETE /v1/responses/{id}

Scriosann sé freagra stóráilte sula ndéanfar é a dhul in éag go huathoibríoch tar éis 30 lá.

Próiseáil asionchronach

POST /v1/chat/completions (mód moillithe)

Nuair a chuireann tú "deferred": true leis an iarratas, filleann an API request_id láithreach gan fanacht go gcríochnófar an ghiniúint. Tá sé úsáideach d’iarratais fhada nó do phróiseáil bhaisce.

GET /v1/chat/deferred-completion/{request_id}

Faigheann sé toradh glao asionchronaigh:

  • HTTP 200: tá an ghiniúint críochnaithe, agus tá an freagra iomlán sa chorp
  • HTTP 202: tá an ghiniúint fós ar siúl, mar sin bain triail eile as níos déanaí

Giniúint íomhánna

POST /v1/images/generations

Gineann sé íomhánna ó chur síos téacs.

POST /v1/images/edits

Cuirtear in eagar íomhá atá ann cheana bunaithe ar threoracha téacs.

Giniúint físeáin

POST /v1/videos/generations

Tosaíonn sé físeán a ghiniúint ó leid téacs.

GET /v1/videos/{id}

Seiceálann sé stádas físeáin á ghiniúint agus faigheann sé an URL torthaí nuair a bheidh sé críochnaithe.

POST /v1/videos/edits

Cuirtear in eagar físeán atá ann cheana.

POST /v1/videos/extensions

Síneann sé físeán atá ann cheana.

Sintéis cainte

POST /v1/tts

Tiontaíonn sé téacs go fuaime (téacs-go-labhra). Úsáideach chun cúntóirí gutha nó ábhar fuaime uathoibrithe a thógáil.

Gníomhaire gutha fíor-ama

WSS wss://api.x.ai/v1/realtime

Pointe deiridh WebSocket chun gníomhairí gutha idirghníomhacha a thógáil. Tarlaíonn an chumarsáid i bhfíor-am, ag seoladh agus ag glacadh fuaime.

Bainistíocht comhad

POST /v1/files

Uaslódáil comhad chuig an ardán xAI. Is féidir comhaid a úsáid ansin le haghaidh RAG (giniúint méadaithe aisghabhála) le bailiúcháin.

GET /v1/files

Déanann sé liosta de gach comhad a uaslódáladh chuig do spás.

GET /v1/files/{id}

Faigheann sé meiteashonraí comhaid shonraigh.

DELETE /v1/files/{id}

Scriosann sé comhad uaslódáilte.

Próiseáil bhaisce

POST /v1/batches

Cruthaíonn sé baisc d’iarratais le próiseáil mar ghrúpa, go minic ar phraghas laghdaithe.

GET /v1/batches

Déanann sé liosta de bhaisc atá ar siúl agus atá críochnaithe.

Uirlisí ionsuite taobh freastalaí

Tacaíonn an pointe deiridh /v1/responses le huirlisí a ritheann an API go díreach, gan aon loighic taobh cliant:

  • web_search: cuardach gréasáin fíor-ama
  • x_search: cuardach i bpoist X (Twitter)
  • code_interpreter: feidhmiú cód Python
  • function: glaoanna feidhme saincheaptha (glao feidhme)

Casann tú na huirlisí seo air leis an bparaiméadar tools san iarratas.

Príomhphointí

  • Clúdaíonn an API téacs, íomhánna, físeáin, fuaime, agus comhaid
  • Is é /v1/responses an príomhphointe deiridh, leis an tacaíocht is iomláine
  • Cumasaíonn mód deferred próiseáil asionchronach d’iarratais fhada
  • Saibhríonn uirlisí taobh freastalaí (web_search, x_search, code_interpreter) freagraí gan aon chód breise