Dostupne krajnje točke
Na ovoj stranici
Pregled Grok API-ja
xAI API nije ograničen samo na generiranje teksta. Izlaže skup krajnjih točaka koje pokrivaju generiranje slika i videa, sintezu govora, upravljanje datotekama i asinkronu obradu. Ova lekcija mapira dostupne krajnje točke kako bi znao/la koje značajke koristiti u svojim projektima.
Generiranje teksta
POST /v1/responses (preporučeno)
Glavna krajnja točka za svaku interakciju s Grok modelima. Podržava tekst, viziju, alate (pozivanje funkcija), web pretraživanje i pretraživanje platforme X.
Ključni parametri: model, input, instructions, stream, tools, reasoning.
POST /v1/chat/completions (kompatibilno s OpenAI-jem)
Krajnja točka u formatu OpenAI-ja, održava se radi kompatibilnosti s postojećim alatima. Prihvaća iste parametre kao i OpenAI API: model, messages, temperature, stream, tools.
GET /v1/responses/{id}
Dohvaća prethodno generirani odgovor ako je bio pohranjen (parametar store: true). Odgovori se čuvaju 30 dana.
DELETE /v1/responses/{id}
Briše pohranjeni odgovor prije nego što automatski istekne nakon 30 dana.
Asinkrona obrada
POST /v1/chat/completions (odgođeni način rada)
Kada u zahtjev dodaš "deferred": true, API odmah vraća request_id bez čekanja da se generiranje završi. To je korisno za duge zahtjeve ili skupnu obradu.
GET /v1/chat/deferred-completion/{request_id}
Dohvaća rezultat asinkronog poziva:
- HTTP 200: generiranje je završeno i tijelo odgovora sadrži kompletan odgovor
- HTTP 202: generiranje je još u tijeku, pa pokušaj ponovno kasnije
Generiranje slika
POST /v1/images/generations
Generira slike na temelju tekstualnog opisa.
POST /v1/images/edits
Uređuje postojeću sliku na temelju tekstualnih uputa.
Generiranje videa
POST /v1/videos/generations
Pokreće generiranje videa iz tekstualnog prompta.
GET /v1/videos/{id}
Provjerava status videa koji se generira i dohvaća URL rezultata kada je završen.
POST /v1/videos/edits
Uređuje postojeći video.
POST /v1/videos/extensions
Proširuje postojeći video.
Sinteza govora
POST /v1/tts
Pretvara tekst u audio (text-to-speech). Korisno za izgradnju glasovnih asistenata ili automatiziranog audio sadržaja.
Glasovni agent u stvarnom vremenu
WSS wss://api.x.ai/v1/realtime
WebSocket krajnja točka za izgradnju interaktivnih glasovnih agenata. Komunikacija se odvija u stvarnom vremenu, slanjem i primanjem audia.
Upravljanje datotekama
POST /v1/files
Prenosi datoteku na xAI platformu. Datoteke se zatim mogu koristiti za RAG (generiranje potpomognuto dohvaćanjem) s kolekcijama.
GET /v1/files
Ispisuje popis svih datoteka prenesenih u tvoj prostor.
GET /v1/files/{id}
Dohvaća metapodatke određene datoteke.
DELETE /v1/files/{id}
Briše prenesenu datoteku.
Skupna obrada
POST /v1/batches
Stvara skupinu zahtjeva za obradu kao grupu, često po smanjenoj cijeni.
GET /v1/batches
Ispisuje popis skupina u tijeku i onih koje su završene.
Ugrađeni alati na strani poslužitelja
Krajnja točka /v1/responses podržava alate koje API pokreće izravno, bez logike na strani klijenta:
- web_search: pretraživanje weba u stvarnom vremenu
- x_search: pretraživanje objava na platformi X (Twitter)
- code_interpreter: izvršavanje Python koda
- function: pozivi prilagođenih funkcija (function calling)
Ove alate uključuješ parametrom tools u zahtjevu.
Ključne točke
- API pokriva tekst, slike, video, audio i datoteke
/v1/responsesje glavna krajnja točka s najpotpunijom podrškom- Način rada
deferredomogućuje asinkronu obradu za duge zahtjeve - Alati na strani poslužitelja (web_search, x_search, code_interpreter) obogaćuju odgovore bez potrebe za dodatnim kodom