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

Iġġenera ċavetta tal-API

Lezzjoni 2 / 14 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Aċċess programmatiku għal Grok
  2. Iftaħ il-konsoll
  3. Oħloq l-ewwel ċavetta tiegħek
  4. Prattiki tajba ta’ maniġġjar
  5. Fatturazzjoni marbuta maċ-ċwievet
  6. Ittestja ċ-ċavetta immedjatament
  7. Punti Ewlenin

Aċċess programmatiku għal Grok

Ċavetta tal-API maħluqa fil-konsoll ta' xAI Iċ-ċavetta tal-API hija t-token tal-awtentikazzjoni li jħalli l-applikazzjonijiet tiegħek jikkomunikaw mal-mudelli ta’ Grok. Mingħajrha, l-ebda talba ma tgħaddi. Din il-lezzjoni tgħidlek pass pass kif toħloq u timmaniġġja ċ-ċwievet tiegħek fil-konsoll ta’ xAI.

Iftaħ il-konsoll

Mur fuq console.x.ai u idħol bl-account li ħloqt fil-pass preċedenti. Il-konsoll huwa d-dashboard ċentrali tiegħek biex timmaniġġja ċ-ċwievet, tmonitorja l-użu, u tissettja l-fatturazzjoni.

Fil-menu laterali, iftaħ API Keys (mogħdija sħiħa: console.x.ai/team/default/api-keys).

Oħloq l-ewwel ċavetta tiegħek

Ikklikkja Create API Key. Tista’ tagħti kull ċavetta isem deskrittiv biex tidentifika għal xiex tintuża:

  • dev-local għall-ambjent ta’ żvilupp tiegħek
  • prod-backend għas-server tal-produzzjoni tiegħek
  • test-ci għall-pipeline ta’ integrazzjoni kontinwa tiegħek

Iċ-ċavetta tintwera darba biss, meta toħloqha. Ikkopjaha immedjatament u aħżinha f’post sigur (maniġer tal-passwords jew vault tas-sigrieti). Jekk titlef ċavetta, ikollok toħloq waħda ġdida.

Format taċ-ċavetta

Iċ-ċwievet tal-API ta’ xAI jibdew bil-prefiss xai- segwit minn sekwenza alfanumerika. Dak il-prefiss jgħinek tindunahom malajr fil-fajls tal-konfigurazzjoni tiegħek u tiskoprihom jekk jiġux esposti b’mod aċċidentali fil-kodiċi sors.

Prattiki tajba ta’ maniġġjar

Ċavetta waħda għal kull ambjent

Oħloq ċwievet separati għal kull kuntest. Jekk ċavetta tiġi kompromessa, tista’ tirrevokaha mingħajr ma taffettwa l-ambjenti l-oħra tiegħek.

Rotazzjoni regolari

Ġedded iċ-ċwievet tiegħek perjodikament, speċjalment għall-ambjenti tal-produzzjoni. Il-proċedura hija sempliċi: oħloq ċavetta ġdida, aġġorna l-applikazzjoni tiegħek, imbagħad ħassar dik antika.

Iċċekkja qabel ma taqsam

Qabel ma taqsam proġett, kun żgur li l-ebda ċavetta ma hija miktuba direttament (hard-coded) fis-sors. Uża fajls .env miżmuma barra mill-kontroll tal-verżjoni (żid .env fil-.gitignore tiegħek).

Fatturazzjoni marbuta maċ-ċwievet

Kull sejħa tal-API magħmula b’ċavetta tiġi kkalkolata u fatturata. xAI joffri żewġ modalitajiet:

  • Krediti mħallsa minn qabel: tixtri krediti bil-quddiem, u s-sejħiet jitnaqqsu immedjatament
  • Fatturazzjoni ta’ kull xahar: l-użu lil hinn mill-krediti tiegħek jiġi fatturat fi tmiem ix-xahar

Iċċekkja l-informazzjoni tal-fatturazzjoni tiegħek fil-konsoll qabel ma tibda tuża l-API, għax il-fatturi ma jistgħux jinbiddu retroattivament.

Ittestja ċ-ċavetta immedjatament

Ħu tletin sekonda biex tivvalida ċ-ċavetta qabel ma tidfinha f’proġett. L-aktar test sempliċi jitlob il-lista tal-mudelli:

curl https://api.x.ai/v1/models \
  -H "Authorization: Bearer xai-your-key"

Twieġiba JSON li telenka l-mudelli tikkonferma li ċ-ċavetta hija attiva u l-fatturazzjoni hija f’ordni. Żball 401 ifisser li ċ-ċavetta ġiet ikkopjata ħażin; 403 jindika problema ta’ permessi jew ta’ krediti. Id-dijanjożi hawnhekk, fis-sors, tiffrankalek sessjoni ta’ debug aktar tard fin-nofs tal-kodiċi tal-applikazzjoni tiegħek.

Punti Ewlenin

  • Toħloq iċ-ċwievet fuq console.x.ai/team/default/api-keys
  • Jibdew b’xai- u jintwerew darba biss
  • Oħloq ċavetta waħda għal kull ambjent u aħżinhom f’vault tas-sigrieti
  • Iċċekkja l-modalità tal-fatturazzjoni tiegħek qabel kwalunkwe sejħa tal-API
  • Ivvalida kull ċavetta ġdida b’sejħa lejn /v1/models qabel ma tintegraha