Iġġenera ċavetta tal-API
F'din il-paġna
Aċċess programmatiku għal Grok
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-localgħall-ambjent ta’ żvilupp tiegħekprod-backendgħas-server tal-produzzjoni tiegħektest-cigħ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/modelsqabel ma tintegraha