Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Ustvari ključ API

Lekcija 2 od 14 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Programski dostop do Groka
  2. Odpri konzolo
  3. Ustvari svoj prvi ključ
  4. Najboljše prakse upravljanja
  5. Obračunavanje, povezano s ključi
  6. Ključ takoj preizkusi
  7. Ključne ugotovitve

Programski dostop do Groka

Ključ API, ustvarjen v konzoli xAI Ključ API je žeton za preverjanje pristnosti, ki tvojim aplikacijam omogoča komunikacijo z modeli Grok. Brez njega nobena zahteva ne bo uspešna. V tej lekciji te bomo popeljali skozi postopek ustvarjanja in upravljanja tvojih ključev v konzoli xAI.

Odpri konzolo

Obišči console.x.ai in se prijavi z računom, ki si ga ustvaril v prejšnjem koraku. Konzola je tvoja osrednja nadzorna plošča za upravljanje ključev, spremljanje porabe in nastavitev obračunavanja.

V stranskem meniju odpri API Keys (polna pot: console.x.ai/team/default/api-keys).

Ustvari svoj prvi ključ

Klikni Create API Key. Vsakemu ključu lahko dodeliš opisno ime, da boš lažje prepoznal njegov namen:

  • dev-local za tvoje razvojno okolje
  • prod-backend za tvoje produkcijsko strežniško okolje
  • test-ci za tvojo cevovod neprekinjenega integriranja (CI)

Ključ je prikazan samo enkrat, in sicer ob njegovem ustvarjanju. Takoj ga kopiraj in shrani na varno mesto (upravitelj gesel ali trezor skrivnosti). Če ključ izgubiš, boš moral ustvariti novega.

Oblika ključa

Ključi API xAI se začnejo s predpono xai-, ki ji sledi alfanumerično niz. Ta predpona ti pomaga, da jih hitro prepoznaš v konfiguracijskih datotekah in jih zaznaš, če so pomotoma razkriti v izvorni kodi.

Najboljše prakse upravljanja

En ključ na okolje

Ustvari ločene ključe za vsak kontekst. Če pride do uhajanja ključa, ga lahko prekličеш, ne da bi to vplivalo na druga okolja.

Redno menjavanje

Ključe občasno obnovi, še posebej za produkcijska okolja. Postopek je preprost: ustvari nov ključ, posodobi svojo aplikacijo, nato pa izbriši starega.

Preveri pred deljenjem

Preden deliš projekt, se prepričaj, da v izvorno kodo ni trdo kodiran noben ključ. Uporabi datoteke .env, ki jih hraniš izven nadzora različic (dodaj .env v svoj .gitignore).

Obračunavanje, povezano s ključi

Vsak klic API, opravljen s ključem, se šteje in zaračuna. xAI ponuja dva načina:

  • Predplačniški krediti: kredite kupiš vnaprej, klici pa se takoj odštejejo
  • Mesečno obračunavanje: poraba, ki presega tvoje kredite, se zaračuna ob koncu meseca

Preveri svoje podatke o obračunavanju v konzoli preden začneš uporabljati API, saj računov ni mogoče spreminjati naknadno.

Ključ takoj preizkusi

Nameni trideset sekund za validacijo ključa, preden ga zakoplješ v projekt. Najpreprostejši test zahteva seznam modelov:

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

Odgovor JSON s seznamom modelov potrjuje, da je ključ aktiven in da je obračunavanje v redu. Napaka 401 pomeni, da je bil ključ nepravilno kopiran; napaka 403 kaže na težavo z dovoljenji ali krediti. Diagnosticiranje težave tukaj, pri viru, ti prihrani sejo odpravljanja napak kasneje sredi kode tvoje aplikacije.

Ključne ugotovitve

  • Ključe ustvariš na console.x.ai/team/default/api-keys
  • Začnejo se s xai- in so prikazani samo enkrat
  • Ustvari en ključ na okolje in jih shrani v trezor skrivnosti
  • Pred vsakim klicem API preveri svoj način obračunavanja
  • Vsak nov ključ validiraj s klicem na /v1/models, preden ga integriraš