API xAI a kompatibilita s OpenAI
Na této stránce
Známé rozhraní API
API xAI používá stejný formát jako API OpenAI. Pokud jsi již dříve pracoval s API OpenAI nebo kompatibilními nástroji, nemusíš se učit nic nového. Jediné, co se mění, je základní URL.
https://api.x.ai/v1
Tato kompatibilita je strategickou volbou společnosti xAI. Místo zavádění nového proprietárního formátu přijali de facto průmyslový standard. Výsledkem je, že jakýkoli nástroj, SDK nebo editor podporující API OpenAI může okamžitě využít grok-build-0.1.
Minimální konfigurace
Pro přepnutí z OpenAI na xAI v jakémkoli kompatibilním klientovi musíš změnit pouze dva parametry:
- Základní URL: nahraď
https://api.openai.com/v1zahttps://api.x.ai/v1 - Klíč API: použij svůj klíč API xAI (získaný z
console.x.ai)
Všechno ostatní – formát zpráv, parametry teploty, struktura odpovědi – je totožné.
Příklad s Python SDK pro 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."}
]
)
Standardní SDK OpenAI používáš bez jakýchkoli úprav. Mění se pouze base_url a název modelu.
Pří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ískání klíče API
- Přejdi na console.x.ai
- Přihlas se svým účtem xAI (nebo si vytvoř nový na accounts.x.ai)
- V sekci API Keys vygeneruj nový klíč
- Okamžitě si jej zkopíruj – znovu se již nezobrazí
Tento klíč uchovávej v bezpečí. Nikdy jej neodesílej do Git repozitáře ani nesdílej v týmovém chatu. Použij proměnnou prostředí nebo správce tajných údajů.
Dostupné koncové body
grok-build-0.1 podporuje následující koncové body, všechny ve formátu OpenAI:
/v1/chat/completions: generování textu a kódu (nejpoužívanější)/v1/chat/completionssstream: true: streamování sreasoning_content/v1/chat/completionsstools: nativní volání nástrojů
Omezení kompatibility
Existuje několik drobných rozdílů:
- Dostupné modely jsou od xAI (grok-build-0.1, grok-4.5 atd.), nikoli od OpenAI
- Některé parametry specifické pro OpenAI (jako
logprobs) nemusí být podporovány reasoning_contentje specifické pro API xAI a v API OpenAI neexistuje
Klíčové poznatky
- API xAI běží na
https://api.x.ai/v1a je kompatibilní s formátem OpenAI - Pro migraci stačí změnit základní URL a klíč API
- Python SDK pro OpenAI funguje tak, jak je
- Klíč API získáš na console.x.ai
- Všechny editory kompatibilní s OpenAI fungují s xAI