Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

SDK ta' OpenAI b'bażi `base_url` ta' xAI

Lezzjoni 5 / 12 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Użu tas-SDK ta’ OpenAI biex taċċessa Grok
  2. Konfigurazzjoni
  3. Sejħiet identiċi għal dawk ta’ OpenAI
  4. Streaming mas-SDK ta’ OpenAI
  5. JavaScript / TypeScript
  6. Bidla bejn il-fornituri
  7. X’ma jittrasferix bejn il-fornituri
  8. Punti Ewlenin

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_url għal https://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, stop fuq mudelli tar-raġunament, logit_bias) jew jiġu injorati (logprobs minn grok-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