xAI API i kompatibilnost s OpenAI-jem
Na ovoj stranici
Poznati API
xAI API koristi isti format kao i OpenAI API. Ako si već radio/la s OpenAI API-jem ili kompatibilnim alatima, nemaš što novo učiti. Jedino što se mijenja jest osnovni URL (base URL).
https://api.x.ai/v1
Ova kompatibilnost strateški je izbor tvrtke xAI. Umjesto nametanja novog vlasničkog formata, prihvatili su de facto industrijski standard. Kao rezultat, bilo koji alat, SDK ili uređivač koji podržava OpenAI API može odmah koristiti grok-build-0.1.
Minimalna konfiguracija
Za prelazak s OpenAI-ja na xAI u bilo kojem kompatibilnom klijentu, trebaš promijeniti samo dva parametra:
- Osnovni URL (Base URL): zamijeni
https://api.openai.com/v1shttps://api.x.ai/v1 - API ključ: koristi svoj xAI API ključ (dohvaćen s
console.x.ai)
Sve ostalo — format poruka, parametri temperature, struktura odgovora — identično je.
Primjer s OpenAI Python SDK-jem
from openai import OpenAI
client = OpenAI(
api_key="your-xai-key",
base_url="https://api.x.ai/v1"
)
response = client.chat.completions.create(
model="grok-build-0.1",
messages=[
{"role": "system", "content": "You are a programming assistant."},
{"role": "user", "content": "Write a quicksort function in Python."}
]
)
Koristiš standardni OpenAI SDK bez ikakvih izmjena. Mijenjaju se samo base_url i naziv modela.
Primjer s curlom
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer your-xai-key" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-build-0.1",
"messages": [
{"role": "user", "content": "Explain the difference between let and const in JavaScript"}
]
}'
Kako doći do API ključa
- Otiđi na console.x.ai
- Prijavi se svojim xAI računom (ili ga stvori na accounts.x.ai)
- U odjeljku API Keys generiraj novi ključ
- Odmah ga kopiraj — više ga nećeš moći vidjeti
Čuvaj ovaj ključ. Nikada ga ne commitaj u Git repozitorij niti dijeli u timskom chatu. Koristi varijablu okruženja ili upravitelja tajnama (secrets manager).
Dostupne krajnje točke
grok-build-0.1 podržava sljedeće krajnje točke, sve u OpenAI formatu:
/v1/chat/completions: generiranje teksta i koda (najčešće korišteno)/v1/chat/completionssstream: true: strujanje (streaming) sreasoning_content/v1/chat/completionsstools: izvorno pozivanje alata (native tool calling)
Ograničenja kompatibilnosti
Postoji nekoliko manjih razlika:
- Dostupni modeli su xAI-jevi (grok-build-0.1, grok-4.5, itd.), a ne OpenAI-jevi
- Neki parametri specifični za OpenAI (poput
logprobs) možda nisu podržani reasoning_contentspecifičan je za xAI API i ne postoji u OpenAI-jevom API-ju
Ključne točke
- xAI API nalazi se na
https://api.x.ai/v1i kompatibilan je s OpenAI formatom - Za migraciju trebaš promijeniti samo osnovni URL i API ključ
- OpenAI Python SDK radi „kakav jest“
- API ključ preuzmi na console.x.ai
- Svi uređivači kompatibilni s OpenAI-jem rade s xAI-jem