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

Osnovni URL API-ja

Lekcija 4 od 14 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Ulazna točka Grok API-ja
  2. Osnovni URL
  3. Kompatibilnost s OpenAI ekosustavom
  4. Glavne krajnje točke
  5. Postavljanje URL-a u svojim SDK-ovima
  6. Testiranje povezanosti
  7. Ograničenja i kvote
  8. Ključne točke

Ulazna točka Grok API-ja

Svaki zahtjev upućen xAI API-ju prolazi kroz jedan osnovni URL. Razumijevanje tog URL-a i dostupnih krajnjih točaka ključno je prije nego što napišeš prvu liniju koda.

Osnovni URL

Grok API nalazi se na ovoj adresi:

https://api.x.ai/v1

Ovaj URL korijen je za svaku krajnju točku. Na primjer, za stvaranje odgovora puni URL glasi https://api.x.ai/v1/responses.

Zašto /v1?

Prefiks /v1 označava verziju API-ja. Verzioniranje omogućuje xAI-u evoluciju API-ja bez prekida rada postojećih aplikacija. Ako se pojavi verzija 2, ona će tijekom prijelaznog razdoblja coegzistirati s v1.

Kompatibilnost s OpenAI ekosustavom

Temeljna značajka xAI API-ja jest njegova kompatibilnost s OpenAI formatom. U praksi, ako već imaš kod koji radi s OpenAI API-jem, trebaš promijeniti samo dvije postavke kako bi koristio Grok:

  • Osnovni URL: zamijeni https://api.openai.com/v1 s https://api.x.ai/v1
  • API ključ: zamijeni svoj OpenAI ključ svojim xAI ključem

Ta se kompatibilnost proteže na većinu alata i knjižnica u OpenAI ekosustavu: LangChain, LlamaIndex, LiteLLM i mnogi drugi rade s Grokom bez ikakvih izmjena koda.

Glavne krajnje točke

API izlaže nekoliko krajnjih točaka grupiranih po funkcionalnostima.

Generiranje teksta

  • POST /v1/responses: glavna krajnja točka za generiranje odgovora (moderni format)
  • POST /v1/chat/completions: krajnja točka kompatibilna s OpenAI-jem (stariji format, i dalje podržan)

Generiranje medija

  • POST /v1/images/generations: generiranje slika
  • POST /v1/images/edits: uređivanje postojećih slika
  • POST /v1/videos/generations: generiranje videa
  • POST /v1/tts: sinteza govora (tekst-u-govor)

Upravljanje datotekama

  • POST /v1/files: prijenos datoteke
  • GET /v1/files: popis prenesenih datoteka

Stvarno vrijeme

  • wss://api.x.ai/v1/realtime: glasovni agent putem WebSocket-a

Postavljanje URL-a u svojim SDK-ovima

Kada koristiš SDK kompatibilan s OpenAI-jem, moraš eksplicitno navesti osnovni URL:

from openai import OpenAI

client = OpenAI(
    api_key="xai-your-key",
    base_url="https://api.x.ai/v1"
)

S izvornim xAI SDK-om URL je unaprijed konfiguriran i ne moraš ništa postavljati.

Testiranje povezanosti

Prije nego što napišeš bilo kakav kod, izravan poziv validira cijeli lanac (URL, ključ, mreža):

curl https://api.x.ai/v1/models \
  -H "Authorization: Bearer xai-your-key"

Odgovor izlistava modele dostupne s tvojim ključem. To je također najpouzdaniji način da saznaš točne ID-jeve modela dostupne na tvom računu, bez oslanjanja na dokumentaciju koja se može mijenjati. Zadrži tu naviku: validiraj svako novo okruženje (stroj, CI, poslužitelj) ovim istim pozivom prije bilo kakve implementacije.

Ograničenja i kvote

API provodi ograničenja stope (rate limits) za svaki tim i svaki model. Ako ih premašiš, dobit ćeš HTTP 429 pogrešku. xAI konzola prikazuje tvoje trenutne kvote i korištenje u stvarnom vremenu.

Ključne točke

  • Osnovni URL je https://api.x.ai/v1 za svaku krajnju točku
  • API je kompatibilan s OpenAI formatom: promijeni URL i ključ, i to je to
  • Glavna krajnja točka za generiranje je POST /v1/responses
  • Starija krajnja točka POST /v1/chat/completions ostaje dostupna radi kompatibilnosti