Na pointí deiridh atá ar fáil
Ar an leathanach seo
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/responsesan príomhphointe deiridh, leis an tacaíocht is iomláine - Cumasaíonn mód
deferredpróiseáil asionchronach d’iarratais fhada - Saibhríonn uirlisí taobh freastalaí (web_search, x_search, code_interpreter) freagraí gan aon chód breise