L-SDK ta' OpenAI għal Grok
F'din il-paġna
Aġġornat fit-3 ta’ Novembru 2026, abbażi tal-paġna Models ta’ xAI: grok-4.7 (Settembru 2026) issaħħaħ lil grok-4.5 bħala l-mudell rakkomandat; l-eżempju, miktub b’grok-4.5, jaħdem ukoll ma’ grok-4.7. Sorsi: Models · Release notes.
Iċċarat fit-3 ta’ Novembru 2026, abbażi tar-referenza ta’ Chat Completions ta’ xAI: is-sejħa mhix eżattament identika għal dik ta’ OpenAI;
logprobsutop_logprobs(injorati minngrok-4.20‘il quddiem) ulogit_bias(mhux appoġġjat) iżidu mad-differenzi elenkati hawn taħt. Sors: xAI, Chat Completions.
Uża dak li diġà taf dwar OpenAI
Jekk diġà taħdem bl-SDK ta’ OpenAI f’Python, tista’ tużah kif inhu biex issejjaħ l-API ta’ Grok. Irrid biss tirridireġġi t-talbiet lejn is-servers ta’ xAI billi tbiddel l-URL bażiku. Dan huwa l-aktar approċċ rapidu jekk diġà għandek kodiċi eżistenti.
Installazzjoni
Jekk l-SDK ta’ OpenAI għadux installat fil-proġett tiegħek:
pip install openai
Ikkonfigura l-klijent għal xAI
L-unika differenza mill-użu regolari ta’ OpenAI hija l-parametru base_url:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Hekk biss. Minn hawn ‘il quddiem, kull metodu fl-SDK ta’ OpenAI jaħdem mal-mudelli ta’ Grok.
Ibgħat messaġġ
Is-sejħa għandha l-istess forma bħal dik għal GPT, ħlief għall-parametri mhux appoġġjati (ara hawn taħt):
response = client.chat.completions.create(
model="grok-4.5",
messages=[
{"role": "system", "content": "You are a technical assistant."},
{"role": "user", "content": "What's the difference between REST and GraphQL?"}
],
temperature=0.7,
max_completion_tokens=500
)
print(response.choices[0].message.content)
Mudelli disponibbli
Biex tibdel, sempliċiment issostitwixxi l-isem tal-mudell ta’ OpenAI b’mudell ta’ Grok:
grok-4.7: il-mudell rakkomandat minn xAI, versatili, b’input tal-immaġni (grok-4.6ugrok-4.5jibqgħu disponibbli)grok-4.20-0309-reasoning: raġunar avvanzatgrok-4.3: tweġibiet mgħaġġla u irħas (kuntest ta’ 1M)
Immigra proġett eżistenti ta’ OpenAI
Biex tadatta proġett eżistenti, għandek żewġ għażliet.
Għażla 1: Varjabbli tal-ambjent
Ibdel il-varjabbli tiegħek mingħajr ma tmiss il-kodiċi:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
L-SDK ta’ OpenAI jaqra dawn il-varjabbli awtomatikament. Il-kodiċi eżistenti tiegħek se jaħdem jekk tibdel ukoll l-isem tal-mudell u tneħħi l-parametri li xAI ma jappoġġjax.
Għażla 2: Konfigurazzjoni espliċita
Ikiteb funzjoni ta’ inizjalizzazzjoni li tgħaqqad bejn il-fornituri:
import os
from openai import OpenAI
def create_client(provider="xai"):
if provider == "xai":
return OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
return OpenAI() # OpenAI b'mod default
client = create_client("xai")
Dan l-approċċ jippermettilek tibdel faċilment bejn il-fornituri waqt il-migrazzjoni.
Differenzi li għandek tkun taf
Għalkemm l-API hija kompatibbli, xi mġiba tvarja:
- Il-parametri
frequency_penaltyupresence_penaltymhumiex appoġġjati fuq mudelli ta’ raġunar - Il-parametru
stopmhuwiex disponibbli fuq mudelli ta’ raġunar logprobsutop_logprobshuma injorati silenzjużament minngrok-4.20u mudelli aktar ġodda, ulogit_biasmhux appoġġjat- L-ismijiet tal-mudelli huma ovvjament differenti
- Xi karatteristiċi ta’ xAI (tiftix fuq X, tiftix fuq il-web) mhumiex disponibbli permezz tal-format standard ta’ OpenAI
Meta tagħżel dan l-approċċ
Il-modalità ta’ kompatibbiltà tagħmel l-aktar sens meta l-kodiċi eżistenti tiegħek huwa aktar importanti mill-karatteristiċi esklużivi. L-aktar każ komuni huwa l-migrazzjoni: kodiċi diġà miktub għal OpenAI jgħaddi għal Grok billi tbiddel l-URL bażiku u ċ-ċavetta: żewġ linji, l-ebda riscrittura. Ir-reversibbiltà hija importanti wkoll: sakemm tibqa’ fuq il-format ta’ OpenAI, il-bidla tal-fornitur tibqa’ kwistjoni ta’ konfigurazzjoni, li hija prezzjuża biex tqabbel mudelli jew tinnegozja. Imbagħad hemm l-ekosistema: għodod ta’ partijiet terzi mibnija madwar l-SDK ta’ OpenAI, bħal LangChain u LlamaIndex, jaħdmu immedjatament, u tim li diġà jaf l-SDK m’għandu xejn ġdid x’jitgħallem. Il-prezz li trid tħallas huwa dak li rajt hawn fuq: il-karatteristiċi speċifiċi ta’ xAI jieħdu post sekondarju.
Punti Ewlenin
- Żid
base_url="https://api.x.ai/v1"mal-kostrutturOpenAI() - Ibdel iċ-ċavetta tal-API u l-isem tal-mudell
- Il-varjabbli
OPENAI_BASE_URLuOPENAI_API_KEYjippermettu migrazzjoni mingħajr ma tmiss il-kodiċi - Xi parametri (penalitajiet, stop) mhumiex appoġġjati fuq mudelli ta’ raġunar