API-kulcs generálása
Ezen az oldalon
Programozott hozzáférés a Grokhoz
Az API-kulcs az a hitelesítési token, amely lehetővé teszi, hogy alkalmazásaid kommunikáljanak a Grok modellekkel. Enélkül egyetlen kérés sem jut el a szerverhez. Ez a lecke végigvezet a kulcsok létrehozásán és kezelésén az xAI konzolon belül.
A konzol megnyitása
Látogass el a console.x.ai oldalra, és jelentkezz be azzal a fiókkal, amelyet az előző lépésben hoztál létre. A konzol a központi irányítópultod a kulcsok kezeléséhez, a használat figyeléséhez és a számlázás beállításához.
A oldalsó menüben nyisd meg az API Keys menüpontot (teljes útvonal: console.x.ai/team/default/api-keys).
Az első kulcs létrehozása
Kattints a Create API Key gombra. Minden kulcsnak adhatsz egy leíró nevet, hogy azonosítani tudd a célját:
dev-locala fejlesztői környezetedhezprod-backendaz éles szerveredheztest-cia folyamatos integrációs (CI) folyamataidhoz
A kulcsot csak egyszer jeleníti meg a rendszer, létrehozáskor. Azonnal másold ki, és tárold biztonságos helyen (jelszókezelőben vagy titkok tárolójában). Ha elveszíted a kulcsot, újat kell generálnod.
Kulcsformátum
Az xAI API-kulcsok az xai- előtaggal kezdődnek, amelyet egy alfanumerikus karakterlánc követ. Ez az előtag segít gyorsan azonosítani őket a konfigurációs fájlokban, és észlelni, ha véletlenül bekerülnének a forráskódba.
Bevált gyakorlatok a kezeléshez
Egy kulcs környezetenként
Hozz létre külön kulcsot minden egyes környezethez. Ha egy kulcs kiszivárog, visszavonhatod anélkül, hogy az befolyásolná a többi környezetedet.
Rendszeres cseréltetés
Időszakosan újítsd meg a kulcsaidat, különösen az éles környezetek esetén. Az eljárás egyszerű: hozz létre egy új kulcsot, frissítsd az alkalmazásodat, majd töröld a régit.
Ellenőrzés megosztás előtt
Mielőtt megosztanál egy projektet, győződj meg róla, hogy nincs keménykódolva kulcs a forráskódban. Használj .env fájlokat, amelyeket kihagysz a verziókezelésből (add hozzá a .env fájlt a .gitignore listádhoz).
Kulcsokhoz kötött számlázás
Minden API-hívást, amelyet egy kulccsal indítasz, a rendszer számlál és számláz. Az xAI két módot kínál:
- Előrefizetett kreditek: előre vásárolsz krediteket, és a hívások költségét azonnal levonják
- Havi számlázás: a krediteken felüli használatot a hónap végén számlázzák ki
Mielőtt elkezdenéd használni az API-t, ellenőrizd a számlázási információkat a konzolon, mert a számlákat utólag nem lehet módosítani.
A kulcs azonnali tesztelése
Szánj harminc másodpercet a kulcs érvényesítésére, mielőtt elmerülnél egy projektben. A legegyszerűbb teszt a modellek listájának lekérése:
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
A modellek listáját tartalmazó JSON válasz megerősíti, hogy a kulcs aktív, és a számlázás rendben van. A 401-es hiba azt jelenti, hogy a kulcsot hibásan másoltad ki; a 403-as hiba jogosultsági vagy kreditproblémára utal. Ha ezt itt, a forrásnál diagnosztizálod, megspórolsz egy későbbi hibakeresési munkamenetet az alkalmazáskódod közepette.
Főbb megállapítások
- A kulcsokat a console.x.ai/team/default/api-keys címen hozod létre
xai-előtaggal kezdődnek, és csak egyszer jelennek meg- Környezetenként egy kulcsot hozz létre, és tárold őket titkok tárolójában
- Bármely API-hívás előtt ellenőrizd a számlázási módot
- Minden új kulcsot érvényesíts egy
/v1/modelshívással, mielőtt integrálnád