L-API ta' xAI għall-iżviluppaturi
F'din il-paġna
Ibni Grok fl-applikazzjonijiet tiegħek
Kollox li tgħallimt tagħmel fl-interfaċċa ta’ Grok jista’ jiġi attivat mill-kodiċi tiegħek stess. L-API ta’ xAI ġġib dawk il-kapaċitajiet fl-apps, fil-websajts u fis-servizzi tiegħek: il-konversazzjoni tieqaf milli tkun post fejn tmur u ssir funzjoni li l-prodott tiegħek isejjaħ.
Prerekwiżiti
Għandek bżonn erba’ affarijiet qabel ma tikteb l-ewwel linja ta’ kodiċi:
- Kont ta’ xAI maħluq fuq accounts.x.ai
- Ċavetta tal-API ġġenerata fuq console.x.ai
- Metodu ta’ ħlas imwaqqaf (biex tmur lil hinn mill-kwota bla ħlas)
- Ambjent ta’ żvilupp Python jew JavaScript
L-ewwel żewġ affarijiet diġà għamiltihom f’dan il-kors: il-kont jimmaniġġja l-awtentikazzjoni, u ċ-ċavetta tidentifika l-applikazzjoni tiegħek mal-API. Il-metodu ta’ ħlas jidħol fis-seħħ biss meta l-użu tiegħek jaqbeż il-kwota bla ħlas, li jiġri aktar malajr milli taħseb hekk kif serviz jibda jaħdem kontinwament. Għall-ambjent, Python u JavaScript għandhom l-aħjar għodod, iżda peress li l-API titkellem HTTP, kwalunkwe lingwa li tista’ tibgħat talba se taħdem.
Twaqqif inizjali
L-ewwel pass huwa li taħżen iċ-ċavetta tal-API tiegħek b’mod sikur, f’varjabbli tal-ambjent:
export XAI_API_KEY="xai-your-key-here"
Qatt ma tħalli ċ-ċavetta tiegħek imwaħħla direttament fil-kodiċi sors tiegħek. Ir-raġuni hija sempliċi: ċavetta miktuba f’fajl tispiċċa f’repożitorju Git qabel jew wara, u ċavetta mbuttata f’repożitorju pubbliku tiġi sfruttata fi żmien minuti minn bots li jiskannjaw il-commits, filwaqt li l-kont jibqa’ f’ismek.
Imbagħad jiġi l-għażla ta’ SDK. L-SDK nattiva ta’ xAI għal Python tinstalla b’pip install xai-sdk. Jekk il-kodiċi tiegħek diġà jsejjaħ lil OpenAI, il-librerija openai taħdem hekk kif inhi, grazzi għall-kompatibbiltà tal-format. Fuq in-naħa ta’ JavaScript, iżżid l-SDK ta’ Vercel AI b’npm install ai @ai-sdk/xai, u tintegra mal-apps ta’ React u Next.js.
L-ewwel talba tiegħek
Bl-SDK nattiva, il-ħolqien tal-klijent u l-ftuħ ta’ konversazzjoni jieħdu tliet linji:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.5")
Ir-rotta kompatibbli ma’ OpenAI hija daqstant diretta: biss il-base_url tinbidel meta mqabbla mal-kodiċi eżistenti, u għalhekk ħafna timijiet ibiddlu f’ftit minuti.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.5",
input="Explain machine learning to me in 3 sentences."
)
Biex tiċċekkja li ċ-ċavetta taħdem qabel ma tikteb kwalunkwe kodiċi, xejn ma jaqbeż sejħa mil-linja tal-kmand:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"input": "Hi, how are you?"
}'
X’tesponi l-API
Il-fondazzjoni hija l-ġenerazzjoni tat-test (twegibiet konversazzjonali, kitba, analiżi), flimkien ma’ modalità ta’ raġunament li ssolvi problemi kumplessi pass pass. L-istreaming iżid ma’ dan billi jwassal it-tweġiba token b’token minflok ma tistenna sakemm tispiċċa l-ġenerazzjoni.
It-tieni sett jagħti aċċess għall-informazzjoni: tfittxija fuq il-web u fuq X f’ħin reali, u RAG, li tistaqsi ġabriet ta’ dokumenti li bnejt int. In-naħa multimodali tkopri l-fehim ta’ stampi li tipprovdi int, il-ġenerazzjoni ta’ stampi u vidjows b’grok-imagine, u l-vuċi, b’konversazzjonijiet mitkellma u TTS.
Fl-aħħar nett, tliet mekkaniżmi jagħmlu l-API programmabbli fis-sens strett: is-sejħa tal-funzjonijiet (function calling), li jħalli l-mudell isejjaħ il-funzjonijiet tiegħek stess; l-output strutturat, li jiggarantixxi JSON użabbli mingħajr post-ipproċessar fraġli; u l-eżekuzzjoni tal-kodiċi fuq is-server.
Agħżel il-mudell tiegħek
Ir-raġunament ivarja skont il-mudell. grok-4.7, il-mudell ewlieni (flagship), joffri raġunament konfigurabbli: il-parametru reasoning_effort (baxx, medju, għoli, jew xhigh) jistabbilixxi kemm jifħar fil-fond, talba b’talba. grok-4.3 jibqa’ l-għażla ekonomika, b’kuntest twil ħafna, bi prezz ta’ madwar nofs dak tal-ieħor. Jeżistu verżjonijiet tal-mudelli mingħajr raġunament għal kompiti sempliċi: il-formulazzjoni mill-ġdid jew il-klassifikazzjoni ma jeħtiġux deliberazzjoni interna.
Il-konvenzjonijiet tas-smijiet jaffettwaw l-istabbiltà tal-applikazzjoni tiegħek:
grok-4.20: l-aħħar verżjoni stabbli rrakkomandatagrok-4.20-latest: l-aktar verżjoni reċenti (tista’ tinbidel)grok-4.20-0309: verżjoni mwaħħla ma’ data speċifika (9 ta’ Marzu)
Fil-produzzjoni, verżjoni mwaħħla tipproteġi l-prompts tiegħek minn bidliet silenzjużi fil-mudell; latest hija tajba għall-esplorazzjoni, sakemm taċċetta li l-imġiba tista’ tinbidel.
Limiti tar-rata u l-aħjar prattiki
L-API timponi limiti tar-rata biex iżżomm is-servizz stabbli: fit-tier tad-dħul, madwar 10 miljun token kull minuta u 1,800 talba kull minuta għal mudelli bħal grok-4.3, u aktar hekk kif it-tier tiegħek jitla’. Il-mudelli tal-ġenerazzjoni tal-istampi u l-vidjows għandhom il-limiti tagħhom stess, ħafna aktar baxxi, minn 30 sa 300 talba kull minuta skont il-mudell, allura żomm għajnejk fuqhom għal servizz orjentat lejn il-konsumatur.
Ftit drawwiet jifirdu prototip minn integrazzjoni soda. Ixgħel l-istreaming għal tweġibiet twal, għax tletin sekonda quddiem skrin vojt iħossok bħallikieku hemm ħsara. Għaddi ID tal-konversazzjoni biex tibbenefika mill-caching. Idderieġi kull kompitu lejn il-mudell it-tajjeb: grok-4.3 għal volum sempliċi, grok-4.20 għar-raġunament. Immaniġġja l-iżbalji b’tentattivi mill-ġdid (retries) u backoff esponenzjali, inkella qtugħ fit-traffiku jsir valanga ta’ talbi miċħuda. U ara l-użu tiegħek fil-console qabel ma tiskopri t-total fi tmiem ix-xahar.
Punti Ewlenin
- L-API ta’ xAI hija kompatibbli mal-format ta’ OpenAI, li jagħmel il-migrazzjoni faċli
- Hemm diversi SDKs disponibbli: xAI nattiva, OpenAI, u l-SDK ta’ Vercel AI
- L-API tkopri t-test, l-istampi, il-vidjo, il-vuċi u t-tfittxija
- Żewġ livelli ta’ mudelli: grok-4.7 (ewlieni, raġunament konfigurabbli) u grok-4.3 (ekonomiku, kuntest ta’ 1M)
- Dejjem aħżen iċ-ċavetta tal-API tiegħek f’varjabbli tal-ambjent, qatt imwaħħla fil-kodiċi