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

L-API ta' xAI għall-iżviluppaturi

Lezzjoni 15 / 16 Aġġornat 29 ta’ Lulju 2026 Bidbieni
F'din il-paġna
  1. Ibni Grok fl-applikazzjonijiet tiegħek
  2. Prerekwiżiti
  3. Twaqqif inizjali
  4. L-ewwel talba tiegħek
  5. X’tesponi l-API
  6. Agħżel il-mudell tiegħek
  7. Limiti tar-rata u l-aħjar prattiki
  8. Punti Ewlenin

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:

  1. Kont ta’ xAI maħluq fuq accounts.x.ai
  2. Ċavetta tal-API ġġenerata fuq console.x.ai
  3. Metodu ta’ ħlas imwaqqaf (biex tmur lil hinn mill-kwota bla ħlas)
  4. 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 rrakkomandata
  • grok-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