OpenAI SDK med xAI base_url
På denna sida
Uppdaterat den 3 november 2026. Enligt referensdokumentationen för xAI Chat Completions är kompatibiliteten med OpenAI SDK inte “100 %” – flera parametrar stöds inte av resonemangsmodeller, ignoreras av nyare modeller eller stöds inte av någon modell alls. Källa: xAI, Chat Completions.
Använda OpenAI SDK för att komma åt Grok
En av de största fördelarna med xAI:s slutpunkt för Chat Completions är dess kompatibilitet med OpenAI SDK. Du kan använda paketet openai som du redan känner till, och bara ändra base_url så att den pekar mot xAI:s servrar.
Denna metod är idealisk om du migrerar en befintlig applikation från OpenAI till Grok, eller om du vill växla mellan leverantörer med minimala ändringar.
Konfiguration
Installationen är densamma som för alla projekt som använder OpenAI SDK:
pip install openai
Den enda skillnaden ligger i skapandet av klienten, där du anger bas-URL:en och din xAI-API-nyckel:
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
De två avgörande parametrarna är:
api_key: Din xAI-API-nyckel (inte en OpenAI-nyckel)base_url:https://api.x.ai/v1– detta omdirigerar förfrågningar till xAI istället för OpenAI
Anrop identiska med OpenAI
När klienten är konfigurerad är användningen densamma som med standard-SDK:t för OpenAI – förutom för de parametrar som xAI inte stöder, vilket detaljeras nedan:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[
{"role": "system", "content": "You are a technical assistant."},
{"role": "user", "content": "What is the difference between TCP and UDP?"}
],
temperature=0.7,
max_tokens=1000
)
print(response.choices[0].message.content)
Den enda synliga skillnaden är modellnamnet: grok-4.20-0309-reasoning istället för exempelvis gpt-5.6.
Strömning med OpenAI SDK
Strömning fungerar på exakt samma sätt:
stream = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[
{"role": "user", "content": "Explain the concept of microservices."}
],
stream=True
)
for chunk in stream:
content = chunk.choices[0].delta.content
if content:
print(content, end="", flush=True)
JavaScript / TypeScript
OpenAI SDK för Node.js fungerar på samma sätt:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.XAI_API_KEY,
baseURL: "https://api.x.ai/v1",
});
const response = await client.chat.completions.create({
model: "grok-4.20-0309-reasoning",
messages: [
{ role: "system", content: "You are a helpful assistant." },
{ role: "user", content: "Hello, how are you?" },
],
});
console.log(response.choices[0].message.content);
Observera att egenskapen heter baseURL (med stort U) i JavaScript, medan den heter base_url i Python.
Växla mellan leverantörer
Den främsta fördelen med denna metod är möjligheten att byta leverantör genom att bara ändra en variabel:
import os
from openai import OpenAI
provider = os.getenv("LLM_PROVIDER", "xai")
configs = {
"xai": {
"api_key": os.getenv("XAI_API_KEY"),
"base_url": "https://api.x.ai/v1",
"model": "grok-4.20-0309-reasoning"
},
"openai": {
"api_key": os.getenv("OPENAI_API_KEY"),
"base_url": "https://api.openai.com/v1",
"model": "gpt-5.6"
}
}
config = configs[provider]
client = OpenAI(api_key=config["api_key"], base_url=config["base_url"])
Denna arkitektur med flera leverantörer är vanlig i produktionsapplikationer som vill behålla flexibilitet.
Vad som inte följer med vid byte av leverantör
Kompatibel betyder inte identisk. Referensdokumentationen för xAI:s slutpunkter flaggar flera parametrar som resonemangsmodeller inte stöder – frequency_penalty, presence_penalty (liksom grok-3) och stop. logprobs och top_logprobs ignoreras utan felmeddelande av grok-4.20 och nyare modeller, och logit_bias stöds inte. Kod som sätter dessa parametrar för OpenAI måste ta bort dem för Grok. Fält som ignoreras tyst är de svåraste, eftersom inget signalerar att de saknar effekt. Inbyggda verktyg skiljer sig också mellan leverantörerna: OpenAI:s webbsökning är inte detsamma som xAI:s. Slutligen klassificerar xAI nu Chat Completions som en föråldrad slutpunkt och rekommenderar Responses API (lektion 11 och 12).
Viktiga punkter
- OpenAI SDK fungerar med xAI genom att helt enkelt ändra
base_urltillhttps://api.x.ai/v1 - Metoder och svarsformat är desamma, men vissa parametrar stöds inte (
frequency_penalty,presence_penalty,stoppå resonemangsmodeller,logit_bias) eller ignoreras (logprobsfrån och medgrok-4.20) - Anpassa API-nyckeln, modellnamnet och ta bort parametrar som inte stöds
- Denna metod förenklar migrering från OpenAI och möjliggör växling mellan leverantörer
- Strömning och typning i OpenAI SDK fungerar; inbyggda verktyg är specifika för varje leverantör