Generowanie klucza API
Na tej stronie
Programowy dostęp do Grok
Klucz API to token uwierzytelniający, który pozwala Twoim aplikacjom komunikować się z modelami Grok. Bez niego żadne żądanie nie zostanie przetworzone. W tej lekcji przeprowadzimy Cię przez proces tworzenia i zarządzania kluczami w konsoli xAI.
Otwarcie konsoli
Przejdź do console.x.ai i zaloguj się na konto utworzone w poprzednim kroku. Konsola to centralny panel służący do zarządzania kluczami, monitorowania zużycia oraz konfiguracji rozliczeń.
W menu bocznym wybierz API Keys (pełna ścieżka: console.x.ai/team/default/api-keys).
Tworzenie pierwszego klucza
Kliknij Create API Key. Każdemu kluczowi możesz nadać opisową nazwę, aby łatwo zidentyfikować jego przeznaczenie:
dev-localdla środowiska deweloperskiegoprod-backenddla serwera produkcyjnegotest-cidla potoku ciągłej integracji (CI)
Klucz jest wyświetlany tylko raz – w momencie jego tworzenia. Skopiuj go natychmiast i przechowuj w bezpiecznym miejscu (menedżer haseł lub sejf na tajemnice). Jeśli zgubisz klucz, będziesz musiał wygenerować nowy.
Format klucza
Klucze API xAI zaczynają się od prefiksu xai-, po którym następuje ciąg alfanumeryczny. Prefiks ten pomaga szybko zlokalizować klucze w plikach konfiguracyjnych i wykryć je, jeśli przypadkowo wyciekną do kodu źródłowego.
Najlepsze praktyki zarządzania
Jeden klucz na środowisko
Twórz osobne klucze dla każdego kontekstu. Jeśli klucz wycieknie, będziesz mógł go unieważnić, nie wpływając na działanie innych środowisk.
Regularna rotacja
Odświeżaj klucze okresowo, szczególnie w środowiskach produkcyjnych. Procedura jest prosta: utwórz nowy klucz, zaktualizuj aplikację, a następnie usuń stary.
Weryfikacja przed udostępnieniem
Zanim udostępnisz projekt, upewnij się, że żaden klucz nie jest zaszyty na sztywno w kodzie źródłowym. Używaj plików .env, które są wykluczone z kontroli wersji (dodaj .env do pliku .gitignore).
Rozliczenia powiązane z kluczami
Każde wywołanie API wykonane przy użyciu klucza jest zliczane i podlega opłacie. xAI oferuje dwa tryby rozliczeń:
- Kredyty przedpłacone: kupujesz kredyty z góry, a wywołania są od nich natychmiast odejmowane
- Rozliczenia miesięczne: zużycie przekraczające posiadane kredyty jest fakturowane na koniec miesiąca
Sprawdź informacje dotyczące rozliczeń w konsoli przed rozpoczęciem korzystania z API, ponieważ faktur nie można zmieniać wstecz.
Natychmiastowe przetestowanie klucza
Poświęć trzydzieści sekund na walidację klucza, zanim zaczniesz go używać w projekcie. Najprostszy test polega na pobraniu listy modeli:
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
Odpowiedź JSON zawierająca listę modeli potwierdza, że klucz jest aktywny, a rozliczenia działają poprawnie. Błąd 401 oznacza, że klucz został błędnie skopiowany; błąd 403 wskazuje na problem z uprawnieniami lub brak kredytów. Zdiagnozowanie problemu na tym etapie, u źródła, zaoszczędzi Ci czasu na debugowanie w środku kodu aplikacji.
Kluczowe wnioski
- Klucze tworzysz pod adresem console.x.ai/team/default/api-keys
- Zaczynają się od
xai-i są wyświetlane tylko raz - Twórz osobny klucz dla każdego środowiska i przechowuj je w sejfie na tajemnice
- Sprawdź tryb rozliczeń przed wykonaniem jakiegokolwiek wywołania API
- Zweryfikuj każdy nowy klucz, wywołując endpoint
/v1/models, zanim go zintegrujesz