Generiranje API ključa
Na ovoj stranici
Programski pristup modelu Grok
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-localza tvoje razvojno okruženjeprod-backendza tvoj produkcijski poslužiteljtest-ciza 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/modelsprije integracije