SDK ta' OpenAI b'bażi `base_url` ta' xAI
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026. Skont ir-referenza tal-Chat Completions ta’ xAI, il-kompatibbiltà mas-SDK ta’ OpenAI mhix “100%“—diversi parametri mhumiex appoġġjati mill-mudelli tar-raġunament, jiġu injorati mill-mudelli riċenti, jew mhumiex appoġġjati minn ebda mudell. Sors: xAI, Chat Completions.
Użu tas-SDK ta’ OpenAI biex taċċessa Grok
Wieħed mill-vantaġġi ewlenin tal-endpoint tal-Chat Completions ta’ xAI huwa l-kompatibbiltà tiegħu mas-SDK ta’ OpenAI. Tista’ tuża l-pakkett openai li diġà taf, billi sempliċiment tbiddel il-base_url biex jipponta lejn is-servers ta’ xAI.
Dan l-approċċ huwa ideali jekk qed timmigra applikazzjoni eżistenti minn OpenAI għal Grok, jew jekk trid tibdel bejn fornituri b’bidliet minimi.
Konfigurazzjoni
L-installazzjoni hija l-istess bħal għal kwalunkwe proġett li juża s-SDK ta’ OpenAI:
pip install openai
L-unika differenza hija fil-ħolqien tal-klijent, fejn tispeċifika l-URL bażi u ċ-ċavetta tal-API ta’ xAI:
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Iż-żewġ parametri essenzjali huma:
api_key: Iċ-ċavetta tal-API ta’ xAI tiegħek (mhix ċavetta ta’ OpenAI)base_url:https://api.x.ai/v1—dan jerġa’ jidderieġi t-talbiet lejn xAI minflok OpenAI
Sejħiet identiċi għal dawk ta’ OpenAI
Ladarba l-klijent ikun ikkonfigurat, l-użu huwa l-istess bħas-SDK standard ta’ OpenAI—ħlief għall-parametri li xAI ma jappoġġjax, iddettaljati hawn taħt:
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)
L-unika differenza viżibbli hija l-isem tal-mudell: grok-4.20-0309-reasoning minflok gpt-5.6, pereżempju.
Streaming mas-SDK ta’ OpenAI
Il-streaming jaħdem eżattament bl-istess 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
Is-SDK ta’ OpenAI għal Node.js jaħdem bl-istess 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);
Innota li l-proprjetà hija baseURL (b’U kbira) f’JavaScript, filwaqt li hija base_url f’Python.
Bidla bejn il-fornituri
Il-benefiċċju ewlieni ta’ dan l-approċċ huwa l-kapaċità li tbiddel il-fornitur b’varjabbli waħda:
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"])
Din l-arkitettura multi-fornitur hija komuni f’applikazzjonijiet tal-produzzjoni li jridu jżommu flessibbiltà.
X’ma jittrasferix bejn il-fornituri
Kompatibbli ma jfissirx identiku. Ir-referenza tal-endpoint ta’ xAI tissuġġerixxi diversi parametri li l-mudelli tar-raġunament ma jappoġġjawx—frequency_penalty, presence_penalty (bħal grok-3) u stop. logprobs u top_logprobs jiġu injorati mingħajr żball minn grok-4.20 u mudelli iktar ġodda, u logit_bias mhuwiex appoġġjat. Il-kodiċi li jissettja dawn il-parametri għal OpenAI se jkollu jneħħihom għal Grok. Il-kampi injorati silenzjużament huma l-iktar insidjużi, peress li xejn ma jindika li m’għandhom l-ebda effett. L-għodod ospitati jvarjaw ukoll bejn il-fornituri: it-tiftix fuq il-web ta’ OpenAI mhuwiex dak ta’ xAI. Fl-aħħar nett, xAI issa tikklassifika l-Chat Completions bħala endpoint antikwat u jirrakkomanda l-API tar-Risposti (lezzjonijiet 11 u 12).
Punti Ewlenin
- Is-SDK ta’ OpenAI jaħdem ma’ xAI billi sempliċiment tbiddel
base_urlgħalhttps://api.x.ai/v1 - Il-metodi u l-formati tar-risposta huma l-istess, iżda xi parametri mhumiex appoġġjati (
frequency_penalty,presence_penalty,stopfuq mudelli tar-raġunament,logit_bias) jew jiġu injorati (logprobsminngrok-4.20‘il quddiem) - Adatta ċ-ċavetta tal-API, l-isem tal-mudell, u l-parametri mhux appoġġjati
- Dan l-approċċ jissimplifika l-migrazzjoni minn OpenAI u jippermetti l-bidla bejn il-fornituri
- Il-streaming u t-tipjar tas-SDK ta’ OpenAI jaħdmu; l-għodod ospitati huma speċifiċi għal kull fornitur