Przejdź do głównej treści
Polski— Wybierz język
Menu

Generowanie klucza API

Lekcja 2 z 14 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Programowy dostęp do Grok
  2. Otwarcie konsoli
  3. Tworzenie pierwszego klucza
  4. Najlepsze praktyki zarządzania
  5. Rozliczenia powiązane z kluczami
  6. Natychmiastowe przetestowanie klucza
  7. Kluczowe wnioski

Programowy dostęp do Grok

Klucz API utworzony w konsoli xAI 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-local dla środowiska deweloperskiego
  • prod-backend dla serwera produkcyjnego
  • test-ci dla 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