Vygenerování klíče API
Na této stránce
Programový přístup k modelu Grok
Klíč API je ověřovací token, který umožňuje tvým aplikacím komunikovat s modely Grok. Bez něj žádný požadavek neprojde. V této lekci si projdeš vytvořením a správou svých klíčů v konzoli xAI.
Otevření konzole
Přejdi na console.x.ai a přihlas se pomocí účtu, který jsi vytvořil v předchozím kroku. Konzole slouží jako centrální panel pro správu klíčů, monitorování využití a nastavení fakturace.
V postranním menu otevři API Keys (celá cesta: console.x.ai/team/default/api-keys).
Vytvoření prvního klíče
Klikni na Create API Key. Každému klíči můžeš přiřadit popisný název, abys věděl, k čemu slouží:
dev-localpro tvé vývojové prostředíprod-backendpro tvůj produkční servertest-cipro pipeline nepřetržité integrace
Klíč se zobrazí pouze jednou, a to v momentě jeho vytvoření. Okamžitě jej zkopíruj a ulož na bezpečné místo (správce hesel nebo trezor tajných údajů). Pokud klíč ztratíš, budeš muset vygenerovat nový.
Formát klíče
Klíče API xAI začínají prefixem xai-, za kterým následuje alfanumerický řetězec. Tento prefix ti pomůže rychle je identifikovat v konfiguračních souborech a odhalit je, pokud by se náhodou objevily ve zdrojovém kódu.
Osvědčené postupy správy
Jeden klíč na prostředí
Vytvářej samostatné klíče pro každý kontext. Pokud dojde k úniku klíče, můžeš jej zrušit, aniž by to ovlivnilo ostatní prostředí.
Pravidelná obměna
Klíče pravidelně obnovuj, zejména u produkčních prostředí. Postup je jednoduchý: vytvoř nový klíč, aktualizuj svou aplikaci a poté smaž ten starý.
Kontrola před sdílením
Než sdílíš projekt, ujisti se, že žádný klíč není natvrdo zakódován ve zdrojovém kódu. Používej soubory .env, které nejsou součástí řízení verzí (přidej .env do svého .gitignore).
Fakturace vázaná na klíče
Každý volání API provedené pomocí klíče se započítává a fakturuje. xAI nabízí dva režimy:
- Předplacené kredity: kredity nakoupíš předem a volání se z nich okamžitě odečítají
- Měsíční fakturace: využití přesahující vaše kredity se fakturuje na konci měsíce
Informace o fakturaci si v konzoli zkontroluj předtím, než začneš API používat, protože faktury nelze měnit zpětně.
Okamžité otestování klíče
Věnuj třicet sekund ověření klíče, než jej zahrneš do projektu. Nejjednodušší test si vyžádá seznam modelů:
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
Odpověď ve formátu JSON se seznamem modelů potvrzuje, že je klíč aktivní a fakturace funguje správně. Chyba 401 znamená, že byl klíč zkopírován nesprávně; chyba 403 ukazuje na problém s oprávněními nebo kredity. Diagnostika přímo u zdroje ti ušetří čas ladění uprostřed kódu aplikace.
Klíčové poznatky
- Klíče vytváříš na adrese console.x.ai/team/default/api-keys
- Začínají prefixem
xai-a zobrazí se pouze jednou - Vytvoř jeden klíč pro každé prostředí a ukládej je do trezoru tajných údajů
- Před jakýmkoli voláním API zkontroluj režim fakturace
- Každý nový klíč před integrací ověř voláním na
/v1/models