xAI API en compatibiliteit met OpenAI
Op deze pagina
Een vertrouwde API
De xAI API hanteert exact hetzelfde formaat als de OpenAI API. Als u eerder met de OpenAI API of compatibele tools heeft gewerkt, hoeft u niets nieuws te leren. Het enige dat verandert, is de basis-URL.
https://api.x.ai/v1
Deze compatibiliteit is een strategische keuze van xAI. In plaats van een nieuw propriëtair formaat op te leggen, hebben zij de de facto industriestandaard overgenomen. Hierdoor kan elke tool, SDK of editor die de OpenAI API ondersteunt, direct gebruikmaken van grok-build-0.1.
Minimale configuratie
Om in een compatibele client over te stappen van OpenAI naar xAI, hoeft u slechts twee parameters aan te passen:
- Basis-URL: vervang
https://api.openai.com/v1doorhttps://api.x.ai/v1 - API-sleutel: gebruik uw xAI API-sleutel (verkregen via
console.x.ai)
Alles andere—berichtformaat, temperatuurparameters, responsstructuur—blijft identiek.
Voorbeeld met de OpenAI Python SDK
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."}
]
)
U gebruikt de standaard OpenAI SDK zonder enige aanpassing. Alleen base_url en de modelnaam veranderen.
Voorbeeld met 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"}
]
}'
Een API-sleutel verkrijgen
- Ga naar console.x.ai
- Log in met uw xAI-account (of maak er een aan op accounts.x.ai)
- Genereer in het gedeelte API Keys een nieuwe sleutel
- Kopieer deze direct; deze wordt niet opnieuw getoond
Bewaar deze sleutel veilig. Commit deze nooit naar een Git-repository en deel deze niet in teamchats. Gebruik een omgevingsvariabele of een secrets manager.
Beschikbare eindpunten
grok-build-0.1 ondersteunt de volgende eindpunten, allemaal in OpenAI-formaat:
/v1/chat/completions: tekst- en codegeneratie (het meest gebruikt)/v1/chat/completionsmetstream: true: streaming metreasoning_content/v1/chat/completionsmettools: native tool calling
Compatibiliteitsbeperkingen
Er zijn enkele kleine verschillen:
- De beschikbare modellen zijn die van xAI (grok-build-0.1, grok-4.5, enz.), niet die van OpenAI
- Sommige OpenAI-specifieke parameters (zoals
logprobs) worden mogelijk niet ondersteund reasoning_contentis specifiek voor de xAI API en bestaat niet in de API van OpenAI
Belangrijkste punten
- De xAI API bevindt zich op
https://api.x.ai/v1en is compatibel met het OpenAI-formaat - U hoeft alleen de basis-URL en de API-sleutel te wijzigen om te migreren
- De OpenAI Python SDK werkt zonder aanpassingen
- Haal de API-sleutel op via console.x.ai
- Alle met OpenAI compatibele editors werken met xAI