xAI API och kompatibilitet med OpenAI
På denna sida
En välbekant API
xAI API använder samma format som OpenAI API. Om du tidigare har arbetat med OpenAI API eller kompatibla verktyg finns inget nytt att lära sig. Det enda som ändras är bas-URL:en.
https://api.x.ai/v1
Denna kompatibilitet är ett strategiskt val från xAI. Istället för att införa ett nytt proprietärt format har de antagit den faktiska industristandarden. Resultatet är att alla verktyg, SDK:n eller editorer som stöder OpenAI API omedelbart kan använda grok-build-0.1.
Minimal konfiguration
För att byta från OpenAI till xAI i vilken kompatibel klient som helst behöver du bara ändra två parametrar:
- Bas-URL: ersätt
https://api.openai.com/v1medhttps://api.x.ai/v1 - API-nyckel: använd din xAI API-nyckel (hämtad från
console.x.ai)
Allt annat – meddelandeformat, temperaturparametrar, svarsstruktur – är identiskt.
Exempel med 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."}
]
)
Du använder standard-SDK:t för OpenAI utan några modifieringar. Endast base_url och modellnamnet ändras.
Exempel med 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"}
]
}'
Skaffa en API-nyckel
- Gå till console.x.ai
- Logga in med ditt xAI-konto (eller skapa ett på accounts.x.ai)
- I avsnittet API Keys genererar du en ny nyckel
- Kopiera den omedelbart – den visas inte igen
Förvara denna nyckel säkert. Checka aldrig in den i ett Git-arkiv eller dela den i teamchattar. Använd en miljövariabel eller en hanterare för hemligheter.
Tillgängliga slutpunkter
grok-build-0.1 stöder följande slutpunkter, alla i OpenAI-format:
/v1/chat/completions: text- och kodgenerering (den vanligaste)/v1/chat/completionsmedstream: true: strömning medreasoning_content/v1/chat/completionsmedtools: inbyggt anrop av verktyg
Begränsningar i kompatibiliteten
Det finns några mindre skillnader:
- De tillgängliga modellerna är xAI:s (grok-build-0.1, grok-4.5, etc.), inte OpenAI:s
- Vissa OpenAI-specifika parametrar (som
logprobs) kanske inte stöds reasoning_contentär specifikt för xAI API och finns inte i OpenAI:s API
Viktiga punkter
- xAI API finns på
https://api.x.ai/v1och är kompatibelt med OpenAI-formatet - Du behöver bara ändra bas-URL och API-nyckel för att migrera
- OpenAI Python SDK fungerar som det är
- Hämta API-nyckeln på console.x.ai
- Alla editorer kompatibla med OpenAI fungerar med xAI