SDK OpenAI cu base_url xAI
Pe această pagină
Actualizat la 3 noiembrie 2026. Conform referinței Chat Completions de la xAI, compatibilitatea cu SDK-ul OpenAI nu este „100%“ — mai mulți parametri nu sunt susținuți de modelele de raționament, sunt ignorați de modelele recente sau nu sunt susținuți de niciun model. Sursă: xAI, Chat Completions.
Utilizarea SDK-ului OpenAI pentru accesarea Grok
Unul dintre principalele avantaje ale endpoint-ului Chat Completions de la xAI este compatibilitatea sa cu SDK-ul OpenAI. Puteți utiliza pachetul openai pe care îl cunoașteți deja, modificând simplu base_url pentru a indica spre serverele xAI.
Această abordare este ideală dacă migrați o aplicație existentă de la OpenAI la Grok sau dacă doriți să comutați între furnizori cu modificări minime.
Configurare
Instalarea este aceeași ca pentru orice proiect care utilizează SDK-ul OpenAI:
pip install openai
Singura diferență constă în crearea clientului, unde specificați URL-ul de bază și cheia API xAI:
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Cei doi parametri esențiali sunt:
api_key: Cheia dvs. API xAI (nu o cheie OpenAI)base_url:https://api.x.ai/v1— aceasta redirecționează cererile către xAI în loc de OpenAI
Apeluri identice cu OpenAI
Odată configurat clientul, utilizarea este aceeași ca în cazul SDK-ului standard OpenAI — cu excepția parametrilor pe care xAI nu îi susține, detaliați mai jos:
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)
Singura diferență vizibilă este numele modelului: grok-4.20-0309-reasoning în loc de gpt-5.6, de exemplu.
Streaming cu SDK-ul OpenAI
Streaming-ul funcționează exact în același mod:
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
SDK-ul OpenAI pentru Node.js funcționează în același mod:
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);
Rețineți că proprietatea este baseURL (U majuscul) în JavaScript, în timp ce în Python este base_url.
Comutarea între furnizori
Principalul beneficiu al acestei abordări este capacitatea de a schimba furnizorul printr-o singură variabilă:
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"])
Această arhitectură multi-furnizor este comună în aplicațiile de producție care doresc să mențină flexibilitatea.
Ce nu se transferă între furnizori
Compatibil nu înseamnă identic. Referința endpoint-ului xAI semnalează mai mulți parametri pe care modelele de raționament nu îi susțin — frequency_penalty, presence_penalty (la fel ca grok-3) și stop. logprobs și top_logprobs sunt ignorate fără eroare de către modelele grok-4.20 și mai noi, iar logit_bias nu este susținut. Codul care setează acești parametri pentru OpenAI va trebui să îi elimine pentru Grok. Câmpurile ignorate silențios sunt cele mai insidioase, deoarece nimic nu semnalează că nu au niciun efect. Instrumentele găzduite diferă, de asemenea, între furnizori: căutarea web de la OpenAI nu este aceeași cu cea de la xAI. În final, xAI clasifică acum Chat Completions ca un endpoint legacy și recomandă API-ul Responses (lecțiile 11 și 12).
Puncte cheie
- SDK-ul OpenAI funcționează cu xAI prin simpla modificare a
base_urlînhttps://api.x.ai/v1 - Metodele și formatele de răspuns sunt aceleași, dar unii parametri nu sunt susținuți (
frequency_penalty,presence_penalty,stoppe modelele de raționament,logit_bias) sau sunt ignorați (logprobsîncepând cugrok-4.20) - Adaptați cheia API, numele modelului și parametrii nesuportați
- Această abordare simplifică migrarea de la OpenAI și permite comutarea între furnizori
- Streaming-ul și tipizarea SDK-ului OpenAI funcționează; instrumentele găzduite sunt specifice fiecărui furnizor