Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Generiranje API ključa

Lekcija 2 od 14 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Programski pristup modelu Grok
  2. Otvaranje konzole
  3. Stvaranje prvog ključa
  4. Najbolje prakse upravljanja
  5. Naplata vezana uz ključeve
  6. Odmah testiraj ključ
  7. Ključne točke

Programski pristup modelu Grok

API ključ kreiran u xAI konzoli API ključ je autentifikacijski token koji omogućuje tvojim aplikacijama komunikaciju s modelima Grok. Bez njega nijedan zahtjev neće proći. Ova lekcija vodi te kroz postupak stvaranja i upravljanja tvojim ključevima u xAI konzoli.

Otvaranje konzole

Otiđi na console.x.ai i prijavi se računom koji si stvorio u prethodnom koraku. Konzola je tvoja središnja nadzorna ploča za upravljanje ključevima, praćenje korištenja i postavljanje naplate.

U bočnom izborniku otvori API Keys (puni put: console.x.ai/team/default/api-keys).

Stvaranje prvog ključa

Klikni Create API Key. Svakom ključu možeš dodijeliti opisno ime kako bi identificirao njegovu namjenu:

  • dev-local za tvoje razvojno okruženje
  • prod-backend za tvoj produkcijski poslužitelj
  • test-ci za tvoj pipeline kontinuirane integracije

Ključ se prikazuje samo jednom, prilikom stvaranja. Odmah ga kopiraj i pohrani na sigurno mjesto (upravitelj lozinki ili trezor tajni). Ako izgubiš ključ, morat ćeš generirati novi.

Format ključa

xAI API ključevi počinju prefiksom xai- nakon kojeg slijedi alfanumerički niz. Taj prefiks pomaže ti da ih brzo uočiš u konfiguracijskim datotekama i detektiraš ih ako slučajno procure u izvorni kod.

Najbolje prakse upravljanja

Jedan ključ po okruženju

Stvori zasebne ključeve za svaki kontekst. Ako ključ procure, možeš ga opozvati bez utjecaja na druga okruženja.

Redovita rotacija

Obnavljaj svoje ključeve povremeno, posebno za produkcijska okruženja. Postupak je jednostavan: stvori novi ključ, ažuriraj svoju aplikaciju, zatim izbriši stari.

Provjera prije dijeljenja

Prije dijeljenja projekta provjeri nije li neki ključ hard-kodiran u izvoru. Koristi .env datoteke koje se ne nalaze pod kontrolom verzija (dodaj .env u svoj .gitignore).

Naplata vezana uz ključeve

Svaki API poziv izvršen pomoću ključa se broji i naplaćuje. xAI nudi dva načina:

  • Prepaid krediti: unaprijed kupuješ kredite, a pozivi se odmah odbijaju
  • Mjesečna naplata: korištenje koje premašuje tvoje kredite naplaćuje se na kraju mjeseca

Provjeri svoje podatke o naplati u konzoli prije nego počneš koristiti API jer se računi ne mogu mijenjati retroaktivno.

Odmah testiraj ključ

Odvoji trideset sekundi za validaciju ključa prije nego ga ukopaš u projekt. Najjednostavniji test traži popis modela:

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

JSON odgovor s popisom modela potvrđuje da je ključ aktivan i da je naplata u redu. Greška 401 znači da je ključ neispravno kopiran; greška 403 ukazuje na problem s dopuštenjima ili kreditima. Dijagnosticiranje ovdje, u samom izvoru, štedi ti sesiju otklanjanja grešaka kasnije usred koda tvoje aplikacije.

Ključne točke

  • Ključeve stvaraš na console.x.ai/team/default/api-keys
  • Počinju s xai- i prikazuju se samo jednom
  • Stvori jedan ključ po okruženju i pohrani ih u trezor tajni
  • Provjeri način naplate prije bilo kojeg API poziva
  • Validiraj svaki novi ključ pozivom na /v1/models prije integracije