Ģenerēt API atslēgu
Šajā lapā
Programmatiska piekļuve Grok
API atslēga ir autentifikācijas žetons, kas ļauj tavām lietotnēm sazināties ar Grok modeļiem. Bez tās neviens pieprasījums netiks apstrādāts. Šajā nodarbībā tu uzzināsi, kā izveidot un pārvaldīt savas atslēgas xAI konsolē.
Atver konsoli
Dodieties uz console.x.ai un pierakstieties ar kontu, ko izveidoji iepriekšējā solī. Konsole ir tavs centrālais vadības panelis atslēgu pārvaldībai, lietojuma uzraudzībai un rēķinu iestatīšanai.
Sānu izvēlnē atver API Keys (pilns ceļš: console.x.ai/team/default/api-keys).
Izveido savu pirmo atslēgu
Noklikšķini uz Create API Key. Katrai atslēgai vari piešķirt aprakstošu nosaukumu, lai identificētu tās paredzēto mērķi:
dev-localizstrādes videiprod-backendprodukcijas serverimtest-cinepārtrauktās integrācijas (CI) konveijeram
Atslēga tiek parādīta tikai vienreiz tās izveides brīdī. Nekavējoties nokopē to un saglabā drošā vietā (parolu pārvaldniekā vai noslēpumu glabātuvē). Ja atslēgu pazaudēsi, tev būs jāģenerē jauna.
Atslēgas formāts
xAI API atslēgas sākas ar prefiksu xai-, kam seko alfanumēriska virkne. Šis prefikss palīdz ātri pamanīt atslēgas konfigurācijas failos un noteikt tās, ja tās nejauši tiek eksponētas pirmkodā.
Labākā prakse pārvaldībā
Viena atslēga katrai videi
Izveido atsevišķas atslēgas katram kontekstam. Ja kāda atslēga tiek nopludināta, tu vari to atsaukt, neietekmējot pārējās vides.
Regulāra rotācija
Periodiski atjauno savas atslēgas, it īpaši produkcijas vidēm. Procedūra ir vienkārša: izveido jaunu atslēgu, atjaunini savu lietotni, pēc tam dzēs veco.
Pārbaudi pirms koplietošanas
Pirms projekta koplietošanas pārliecinies, ka pirmkodā nav iekļauta neviena tieši ierakstīta (hard-coded) atslēga. Izmanto .env failus, kas netiek iekļauti versiju kontrolei (pievieno .env savam .gitignore).
Ar atslēgām saistīti rēķini
Katrs API izsaukums, kas veikts ar atslēgu, tiek skaitīts un apmaksāts. xAI piedāvā divus režīmus:
- Priekšapmaksas kredīti: tu iegādājies kredītus iepriekš, un izsaukumi tiek atskaitīti uzreiz
- Mēneša rēķins: lietojums, kas pārsniedz tavus kredītus, tiek apmaksāts mēneša beigās
Pārbaudi savu rēķinu informāciju konsolē pirms sāc lietot API, jo rēķinus nevar mainīt ar atpakaļejošu datumu.
Nekavējoties pārbaudi atslēgu
Velti trīsdesmit sekundes, lai validētu atslēgu, pirms to iekļauj projektā. Vienkāršākais tests pieprasa modeļu sarakstu:
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
JSON atbilde, kurā uzskaitīti modeļi, apstiprina, ka atslēga ir aktīva un ar rēķiniem viss ir kārtībā. 401 kļūda nozīmē, ka atslēga nokopēta nepareizi; 403 kļūda norāda uz atļauju vai kredītu problēmu. Šīs problēmas diagnosticēšana šeit, pie avota, ietaupīs tev atkļūdošanas sesiju vēlāk, strādājot ar lietotnes kodu.
Galvenās atziņas
- Atslēgas izveido vietnē console.x.ai/team/default/api-keys
- Tās sākas ar
xai-un tiek parādītas tikai vienreiz - Izveido vienu atslēgu katrai videi un glabā tās noslēpumu glabātuvē
- Pirms jebkura API izsaukuma pārbaudi savu rēķinu režīmu
- Validē katru jauno atslēgu, veicot izsaukumu uz
/v1/models, pirms to integrē