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

L-SDK ta' OpenAI għal Grok

Lezzjoni 6 / 14 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Uża dak li diġà taf dwar OpenAI
  2. Installazzjoni
  3. Ikkonfigura l-klijent għal xAI
  4. Ibgħat messaġġ
  5. Immigra proġett eżistenti ta’ OpenAI
  6. Differenzi li għandek tkun taf
  7. Meta tagħżel dan l-approċċ
  8. Punti Ewlenin

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; logprobs u top_logprobs (injorati minn grok-4.20 ‘il quddiem) u logit_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.6 u grok-4.5 jibqgħu disponibbli)
  • grok-4.20-0309-reasoning: raġunar avvanzat
  • grok-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_penalty u presence_penalty mhumiex appoġġjati fuq mudelli ta’ raġunar
  • Il-parametru stop mhuwiex disponibbli fuq mudelli ta’ raġunar
  • logprobs u top_logprobs huma injorati silenzjużament minn grok-4.20 u mudelli aktar ġodda, u logit_bias mhux 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-kostruttur OpenAI()
  • Ibdel iċ-ċavetta tal-API u l-isem tal-mudell
  • Il-varjabbli OPENAI_BASE_URL u OPENAI_API_KEY jippermettu migrazzjoni mingħajr ma tmiss il-kodiċi
  • Xi parametri (penalitajiet, stop) mhumiex appoġġjati fuq mudelli ta’ raġunar