OpenAI SDK xAI:n base_url-osoitteella
Tällä sivulla
Päivitetty 3. marraskuuta 2026. xAI:n Chat Completions -viitteiden mukaan yhteensopivuus OpenAI SDK:n kanssa ei ole “100 %”: useita parametreja ei tueta päättelymalleissa, uusimmat mallit jättävät ne huomiotta, tai mikään malli ei tue niitä. Lähde: xAI, Chat Completions.
OpenAI SDK:n käyttö Grokin käyttämiseen
Yksi xAI:n Chat Completions -päätepisteen suurimmista eduista on sen yhteensopivuus OpenAI SDK:n kanssa. Voit käyttää jo ennestään tuntemaasi openai-pakettia muuttamalla vain base_url-osoitteen osoittamaan xAI:n palvelimiin.
Tämä lähestymistapa on ihanteellinen, jos siirrät olemassa olevaa sovellusta OpenAI:lta Grokille tai haluat vaihtaa tarjoajien välillä minimaalisin muutoksin.
Määritykset
Asennus on sama kuin missä tahansa OpenAI SDK:ta käyttävässä projektissa:
pip install openai
Ainoa ero on asiakasolion luominen, jossa määrität base URL -osoitteen ja xAI:n API-avaimen:
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Kaksi olennaista parametria ovat:
api_key: xAI:n API-avaimesi (ei OpenAI-avain)base_url:https://api.x.ai/v1– tämä ohjaa pyynnöt xAI:lle OpenAI:n sijaan
Kutsut, jotka ovat identtisiä OpenAI:n kanssa
Kun asiakasolio on määritetty, käyttö on sama kuin vakio-OpenAI SDK:ssa – lukuun ottamatta alla yksityiskohtaisesti käsiteltyjä parametreja, joita xAI ei tue:
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)
Ainoa näkyvä ero on mallin nimi: grok-4.20-0309-reasoning esimerkiksi gpt-5.6:n sijaan.
Streamaus OpenAI SDK:lla
Streamaus toimii täsmälleen samalla tavalla:
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
Node.js:n OpenAI SDK toimii samalla tavalla:
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);
Huomaa, että JavaScriptissä ominaisuus on baseURL (iso U), kun taas Pythonissa se on base_url.
Vaihtaminen tarjoajien välillä
Tämän lähestymistavan suurin etu on mahdollisuus vaihtaa tarjoajaa yhden muuttujan avulla:
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"])
Tämä monen tarjoajan arkkitehtuuri on yleinen tuotantoympäristön sovelluksissa, jotka haluavat säilyttää joustavuuden.
Mitä ei siirry tarjoajien välillä
Yhteensopiva ei tarkoita identtistä. xAI:n päätepisteen viitetiedot merkitsevät useita parametreja, joita päättelymallit eivät tue: frequency_penalty, presence_penalty (kuten grok-3:lla) ja stop. logprobs ja top_logprobs jätetään huomiotta ilman virhettä malleissa grok-4.20 ja uudemmissa, eikä logit_bias ole tuettu. Koodi, joka asettaa nämä parametrit OpenAI:lle, on poistettava ne Grokia varten. Hiljaisesti ohitetut kentät ovat hankalimpia, sillä mikään ei signaloi niiden olevan vaikuttamattomia. Isännöidyt työkalut eroavat myös tarjoajien välillä: OpenAI:n verkkohaku ei ole xAI:n verkkohaku. Lopuksi xAI luokittelee nyt Chat Completionsin vanhentuneeksi päätepisteeksi ja suosittelee Responses API:n käyttöä (tunnit 11 ja 12).
Keskeiset asiat
- OpenAI SDK toimii xAI:n kanssa muuttamalla vain
base_urlosoitteeksihttps://api.x.ai/v1 - Metodit ja vastausmuodot ovat samat, mutta joitakin parametreja ei tueta (
frequency_penalty,presence_penalty,stoppäättelymalleissa,logit_bias) tai ne jätetään huomiotta (logprobsmallistagrok-4.20eteenpäin) - Muokkaa API-avain, mallinimi ja ei-tuetut parametrit
- Tämä lähestymistapa yksinkertaistaa siirtymistä OpenAI:lta ja mahdollistaa vaihtamisen tarjoajien välillä
- Streamaus ja OpenAI SDK:n tyypitys toimivat; isännöidyt työkalut ovat kohtaisia kullekin tarjoajalle