Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Ģenerēt API atslēgu

Nodarbība 2 no 14 Atjaunota 2026. gada 30. jūlijs Programmētājs
Šajā lapā
  1. Programmatiska piekļuve Grok
  2. Atver konsoli
  3. Izveido savu pirmo atslēgu
  4. Labākā prakse pārvaldībā
  5. Ar atslēgām saistīti rēķini
  6. Nekavējoties pārbaudi atslēgu
  7. Galvenās atziņas

Programmatiska piekļuve Grok

API atslēga izveidota xAI konsolē 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-local izstrādes videi
  • prod-backend produkcijas serverim
  • test-ci nepā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ē