API xAI a kompatibilita s OpenAI
Na tejto strane
Známe API
API xAI používa rovnaký formát ako API OpenAI. Ak si už pracoval s API OpenAI alebo kompatibilnými nástrojmi, nemusíš sa učiť nič nové. Mení sa iba základná URL adresa.
https://api.x.ai/v1
Táto kompatibilita je strategickou voľbou spoločnosti xAI. Namiesto zavádzania nového proprietárneho formátu prijali de facto priemyselný štandard. Výsledkom je, že akýkoľvek nástroj, SDK alebo editor podporujúci API OpenAI môže okamžite využívať model grok-build-0.1.
Minimálna konfigurácia
Ak chceš v akomkoľvek kompatibilnom klientovi prepnúť z OpenAI na xAI, musíš zmeniť iba dva parametre:
- Základná URL: nahraď
https://api.openai.com/v1adresouhttps://api.x.ai/v1 - API kľúč: použij svoj API kľúč xAI (získaný z
console.x.ai)
Všetko ostatné – formát správ, parametre teploty, štruktúra odpovede – zostáva identické.
Príklad s Python SDK pre OpenAI
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."}
]
)
Štandardné SDK OpenAI používaš bez akýchkoľvek úprav. Mení sa iba base_url a názov modelu.
Príklad s curl
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"}
]
}'
Získanie API kľúča
- Prejdi na console.x.ai
- Prihlás sa pomocou svojho účtu xAI (alebo si vytvor nový na accounts.x.ai)
- V sekcii API Keys vygeneruj nový kľúč
- Okamžite si ho skopíruj – už sa ti znova nezobrazí
Tento kľúč uchovávaj v bezpečí. Nikdy ho neodosielaj do Git repozitára ani ho nezdieľaj v tímovom chate. Použi premennú prostredia alebo správcu tajných údajov.
Dostupné koncové body
Model grok-build-0.1 podporuje nasledujúce koncové body, všetky vo formáte OpenAI:
/v1/chat/completions: generovanie textu a kódu (najpoužívanejšie)/v1/chat/completionssstream: true: streamovanie sreasoning_content/v1/chat/completionsstools: natívne volanie nástrojov
Obmedzenia kompatibility
Existuje niekoľko drobných rozdielov:
- Dostupné modely sú od xAI (grok-build-0.1, grok-4.5 atď.), nie od OpenAI
- Niektoré parametre špecifické pre OpenAI (ako napríklad
logprobs) nemusia byť podporované reasoning_contentje špecifické pre API xAI a v API OpenAI neexistuje
Kľúčové poznatky
- API xAI sa nachádza na adrese
https://api.x.ai/v1a je kompatibilné s formátom OpenAI - Na migráciu stačí zmeniť základnú URL a API kľúč
- Python SDK pre OpenAI funguje bez úprav
- API kľúč získaš na console.x.ai
- Všetky editory kompatibilné s OpenAI fungujú aj s xAI