Ustvari ključ API
Na tej strani
Programski dostop do Groka
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-localza tvoje razvojno okoljeprod-backendza tvoje produkcijsko strežniško okoljetest-ciza 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š