Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

API-kulcs generálása

2. lecke 14 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. Programozott hozzáférés a Grokhoz
  2. A konzol megnyitása
  3. Az első kulcs létrehozása
  4. Bevált gyakorlatok a kezeléshez
  5. Kulcsokhoz kötött számlázás
  6. A kulcs azonnali tesztelése
  7. Főbb megállapítások

Programozott hozzáférés a Grokhoz

API-kulcs létrehozva az xAI konzolban 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-local a fejlesztői környezetedhez
  • prod-backend az éles szerveredhez
  • test-ci a 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/models hívással, mielőtt integrálnád