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

API ta' xAI u kompatibbiltà ma' OpenAI

Lezzjoni 4 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. API familjari
  2. Konfigurazzjoni minima
  3. Ikseb ċavetta tal-API
  4. Endpoints disponibbli
  5. Limitazzjonijiet tal-kompatibbiltà
  6. Punti Ewlenin

API familjari

L-API ta’ xAI tuża l-istess format bħall-API ta’ OpenAI. Jekk diġà ħdimt mal-API ta’ OpenAI jew għodod kompatibbli, m’hemm xejn ġdid biex titgħallem. L-unika ħaġa li tinbidel hija l-URL bażi.

https://api.x.ai/v1

Din il-kompatibbiltà hija għażla strateġika minn xAI. Minflok jimponu format proprjetarju ġdid, adottaw l-istandard industrijali de facto. B’riżultat ta’ dan, kwalunkwe għodda, SDK, jew editur li jappoġġja l-API ta’ OpenAI jista’ juża grok-build-0.1 immedjatament.

Konfigurazzjoni minima

Biex taqleb minn OpenAI għal xAI f’klijent kompatibbli, trid tbiddel biss żewġ parametri:

  1. URL Bażi: ibdel https://api.openai.com/v1 b’https://api.x.ai/v1
  2. Ċavetta tal-API: uża ċ-ċavetta tal-API ta’ xAI tiegħek (miksuba minn console.x.ai)

Kollox ieħor—il-format tal-messaġġi, il-parametri tat-temperatura, l-istruttura tar-risposta—huwa identiku.

Eżempju bl-SDK ta’ Python ta’ OpenAI

from openai import OpenAI

client = OpenAI(
    api_key="your-xai-key",
    base_url="https://api.x.ai/v1"
)

response = client.chat.completions.create(
    model="grok-build-0.1",
    messages=[
        {"role": "system", "content": "You are a programming assistant."},
        {"role": "user", "content": "Write a quicksort function in Python."}
    ]
)

Tuża l-SDK standard ta’ OpenAI mingħajr l-ebda modifika. Jinbidlu biss base_url u l-isem tal-mudell.

Eżempju b’curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer your-xai-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-build-0.1",
    "messages": [
      {"role": "user", "content": "Explain the difference between let and const in JavaScript"}
    ]
  }'

Ikseb ċavetta tal-API

  1. Mur fuq console.x.ai
  2. Idħol bil-kont ta’ xAI tiegħek (jew oħloq wieħed fuq accounts.x.ai)
  3. Fit-taqsima API Keys, iġġenera ċavetta ġdida
  4. Ikkopjaha immedjatament—mhux se tintwera mill-ġdid

Żomm din iċ-ċavetta sikura. Qatt ma timpenjaha f’repożitorju Git jew taqsamha fiċ-chat tat-tim. Uża varjabbli tal-ambjent jew maniġer tas-sigrieti.

Endpoints disponibbli

grok-build-0.1 jappoġġja l-endpoints li ġejjin, kollha fil-format ta’ OpenAI:

  • /v1/chat/completions: ġenerazzjoni ta’ test u kodiċi (l-aktar waħda użata)
  • /v1/chat/completions b’stream: true: streaming b’reasoning_content
  • /v1/chat/completions b’tools: sejħa ta’ għodod nattiva

Limitazzjonijiet tal-kompatibbiltà

Jeżistu ftit differenzi minuri:

  • Il-mudelli disponibbli huma ta’ xAI (grok-build-0.1, grok-4.5, eċċ.), mhux ta’ OpenAI
  • Xi parametri speċifiċi għal OpenAI (bħal logprobs) jista’ ma jkunux appoġġjati
  • reasoning_content huwa speċifiku għall-API ta’ xAI u ma jeżistix fl-API ta’ OpenAI

Punti Ewlenin

  • L-API ta’ xAI tinsab f’https://api.x.ai/v1 u hija kompatibbli mal-format ta’ OpenAI
  • Trid biss tbiddel l-URL bażi u ċ-ċavetta tal-API biex timmigra
  • L-SDK ta’ Python ta’ OpenAI jaħdem kif inhu
  • Ikseb iċ-ċavetta tal-API fuq console.x.ai
  • L-edituri kollha kompatibbli ma’ OpenAI jaħdmu ma’ xAI