Vytvorenie API kľúča
Na tejto strane
Programový prístup k modelu Grok
API kľúč je overovací token, ktorý umožňuje tvojim aplikáciám komunikovať s modelmi Grok. Bez neho sa žiadna požiadavka nespracuje. V tejto lekcii si ukážeme, ako vytvárať a spravovať svoje kľúče v konzole xAI.
Otvorenie konzoly
Prejdi na console.x.ai a prihlás sa pomocou účtu, ktorý si si vytvoril v predchádzajúcom kroku. Konzola slúži ako tvoje centrálne ovládacie panel pre správu kľúčov, monitorovanie využitia a nastavenie fakturácie.
V bočnom menu otvor sekciu API Keys (celá cesta: console.x.ai/team/default/api-keys).
Vytvorenie prvého kľúča
Klikni na tlačidlo Create API Key. Každému kľúču môžeš priradiť popisný názov, aby si vedel, na čo slúži:
dev-localpre tvoje vývojové prostredieprod-backendpre produkčný servertest-cipre pipeline neprežitej integrácie (CI)
Kľúč sa zobrazí iba raz, a to hneď pri jeho vytvorení. Okamžite si ho skopíruj a ulož na bezpečné miesto (správca hesiel alebo trezor tajov). Ak kľúč stratíš, budeš musieť vygenerovať nový.
Formát kľúča
API kľúče xAI začínajú predponou xai-, za ktorou nasleduje alfanumerický reťazec. Táto predpona ti pomôže rýchlo ich identifikovať v konfiguračných súboroch a odhaliť ich, ak by sa náhodne dostali do zdrojového kódu.
Osvedčené postupy správy
Jeden kľúč na prostredie
Vytvor samostatné kľúče pre každý kontext. Ak dôjde k úniku kľúča, môžeš ho zrušiť bez ovplyvnenia ostatných prostredí.
Pravidelná obmena
Kľúče pravidelne obnovuj, najmä v produkčných prostrediach. Postup je jednoduchý: vytvor nový kľúč, aktualizuj svoju aplikáciu a následne odstráň starý kľúč.
Kontrola pred zdieľaním
Pred zdieľaním projektu sa uisti, že žiadny kľúč nie je natvrdo zakódovaný v zdrojovom kóde. Používaj súbory .env, ktoré sú vylúčené zo správy verzií (pridaj .env do svojho .gitignore).
Fakturácia viazaná na kľúče
Každé volanie API vykonané pomocou kľúča sa započítava a fakturuje. xAI ponúka dva režimy:
- Predplatené kredity: kredity si zakúpiš vopred a volania sa z nich okamžite odpočítavajú
- ** Mesačná fakturácia**: využitie presahujúce tvoje kredity sa fakturuje na konci mesiaca
Skontroluj si informácie o fakturácii v konzole predtým, než začneš API používať, pretože faktúry nie je možné meniť spätne.
Okamžité otestovanie kľúča
Venuj tridsať sekúnd overeniu kľúča skôr, než ho zakomponuješ do projektu. Najjednoduchší test si vyžiada zoznam modelov:
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
Odpoveď vo formáte JSON so zoznamom modelov potvrdzuje, že kľúč je aktívny a fakturácia funguje správne. Chyba 401 znamená, že kľúč bol skopírovaný nesprávne; chyba 403 poukazuje na problém s oprávneniami alebo kreditmi. Diagnostika problému priamo tu, u zdroja, ti ušetrí čas ladenia uprostred kódu tvojej aplikácie neskôr.
Kľúčové poznatky
- Kľúče vytváraš na adrese console.x.ai/team/default/api-keys
- Začínajú predponou
xai-a zobrazia sa iba raz - Vytvor jeden kľúč pre každé prostredie a ulož ich do trezoru tajov
- Pred akýmkoľvek volaním API si over režim fakturácie
- Každý nový kľúč over volaním na
/v1/modelsešte pred jeho integráciou