Osnovni URL API-ja
Na ovoj stranici
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/v1shttps://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 slikaPOST /v1/images/edits: uređivanje postojećih slikaPOST /v1/videos/generations: generiranje videaPOST /v1/tts: sinteza govora (tekst-u-govor)
Upravljanje datotekama
POST /v1/files: prijenos datotekeGET /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/v1za 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/completionsostaje dostupna radi kompatibilnosti