GeraikitaGeraikita AI
MenuUwierzytelnianie

Uwierzytelnianie

Każde zapytanie jest uwierzytelniane Twoim kluczem API z prefiksem gk-. Koszt jest pobierany z salda GeraiPoints konta, do którego należy klucz.

Przesyłanie klucza API

Prześlij klucz w jednym z poniższych nagłówków. Oba działają na wszystkich płatnych endpointach.

NagłówekFormatOpis
AuthorizationBearer gk-…Domyślny w klientach w formacie OpenAI (https://ai.geraikita.com/v1).
x-api-keygk-…Domyślny w klientach w formacie Anthropic (https://ai.geraikita.com).
anthropic-version2023-06-01Wysyłany automatycznie przez SDK Anthropic; dodaj go, jeśli wywołujesz /v1/messages bezpośrednio.
HTTP headers
# OpenAI
Authorization: Bearer gk-xxxxxxxx

# Anthropic
x-api-key: gk-xxxxxxxx
anthropic-version: 2023-06-01

Jeśli klucz nie został przesłany, jest błędny lub unieważniony, serwer odpowiada 401 z type authentication_error:

401 Unauthorized
{
  "error": {
    "message": "API key tidak valid atau tidak dikenali. Pastikan key gk- kamu benar.",
    "type": "authentication_error",
    "code": null
  }
}

Tworzenie i unieważnianie kluczy

  1. Otwórz Panel i wybierz Utwórz klucz API.
  2. Nadaj nazwę opisującą zastosowanie (np. laptop-kantor lub server-produksi) i w razie potrzeby wybierz dozwolone modele.
  3. Skopiuj klucz i przechowuj go w bezpiecznym miejscu. Aby go unieważnić, kliknij Unieważnij na liście kluczy — zapytania z tym kluczem są od razu odrzucane.
Pełny klucz jest wyświetlany tylko raz podczas tworzenia i nie można go później podejrzeć. Limit aktywnych kluczy na konto: 20 — unieważnij stary klucz, aby utworzyć nowy.

Ograniczanie klucza do wybranych modeli

Każdy klucz można ograniczyć do listy wybranych modeli (allowlist). Pusta lista oznacza, że dozwolone są wszystkie modele. Zapytania do modeli spoza listy dostają 403 permission_error, a GET /v1/models z tym kluczem pokazuje tylko dozwolone modele. Używaj tego dla kluczy udostępnianych aplikacjom lub zespołom, aby panować nad kosztami.

Rodzaje kluczy

KluczPrzeznaczenieBase URL
gk-Płatne API — koszt pobierany z GeraiPoints. Tworzony w Panelu.https://ai.geraikita.com/v1
gk- (bansos)Darmowy plan — dzienny limit, osobny endpoint. Zobacz Darmowy plan (Bansos). Nie działa na płatnych endpointach i odwrotnie.https://ai.geraikita.com/v1/claude
gkr-Program resellerski — zarządzany na stronie Reseller.—

Bezpieczeństwo klucza

  • Nie umieszczaj klucza w kodzie front-endu (przeglądarka, aplikacja mobilna). Wywołuj API z własnego serwera.
  • Przechowuj klucz w zmiennych środowiskowych lub menedżerze sekretów i nigdy nie commituj go do repozytorium.
  • Używaj osobnego klucza dla każdej aplikacji lub urządzenia — łatwiej śledzić użycie i można unieważnić jeden klucz bez wpływu na pozostałe.
  • Podejrzewasz wyciek klucza? Natychmiast unieważnij go w Panelu i utwórz nowy.