Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Dostupne krajnje točke

Lekcija 13 od 14 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Pregled Grok API-ja
  2. Generiranje teksta
  3. Asinkrona obrada
  4. Generiranje slika
  5. Generiranje videa
  6. Sinteza govora
  7. Glasovni agent u stvarnom vremenu
  8. Upravljanje datotekama
  9. Skupna obrada
  10. Ugrađeni alati na strani poslužitelja
  11. Ključne točke

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/responses je glavna krajnja točka s najpotpunijom podrškom
  • Način rada deferred omoguć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