API ta' xAI u kompatibbiltà ma' OpenAI
F'din il-paġna
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:
- URL Bażi: ibdel
https://api.openai.com/v1b’https://api.x.ai/v1 - Ċ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
- Mur fuq console.x.ai
- Idħol bil-kont ta’ xAI tiegħek (jew oħloq wieħed fuq accounts.x.ai)
- Fit-taqsima API Keys, iġġenera ċavetta ġdida
- 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/completionsb’stream: true: streaming b’reasoning_content/v1/chat/completionsb’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_contenthuwa 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/v1u 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