Klucze Zarządzania — SaaS na Gonka

Jesteś deweloperem SaaS i chcesz oferować inferencję AI swoim klientom bez własnej infrastruktury? Klucze Zarządzania pozwalają tworzyć hierarchiczne klucze API: jeden klucz master zarządza wieloma kluczami klienta z indywidualnymi limitami i terminem ważności. Pod maską — JoinGonka Gateway i sieć Gonka.

Co to są Klucze Zarządzania

Klucze Zarządzania to system hierarchicznych kluczy API do budowania produktów SaaS na platformie Gonka AI Gateway.

Architektura jest dwupoziomowa:

Klucz zarządzania (gm-) — Twój klucz master. Nie jest używany bezpośrednio do inferencji — tylko do tworzenia i zarządzania kluczami podrzędnymi.
Klucz podrzędny (gc-) — klucz dla Twojego klienta. Używany do zapytań inferencyjnych. Rozliczenie jest pobierane z salda właściciela klucza zarządzania.

To model white-label: Twoi klienci pracują za pośrednictwem swoich kluczy gc- i nie wiedzą o Gonka — dla nich to Twój serwis.

Dlaczego to jest potrzebne

Bez Kluczy Zarządzania rozdawałbyś jeden klucz API wszystkim klientom — bez kontroli kosztów, bez izolacji, bez analityki. Klucze Zarządzania rozwiązują 4 zadania:

Zadanie	Jak rozwiązuje
Kontrola kosztów	Dzienny i miesięczny limit w GNK na każdy klucz podrzędny
Tymczasowy dostęp	TTL (expires_at) — klucz automatycznie dezaktywuje się
Izolacja klientów	Każdy klient ze swoim kluczem gc- i ograniczeniem szybkości (rate limit)
Jednolite rozliczanie	Wszystkie klucze podrzędne pobierają z Twojego salda — jeden rachunek

Jak stworzyć Klucz Zarządzania

Krok 1: Zarejestruj się na gate.joingonka.ai i doładuj saldo GNK lub USDT.

Krok 2: Utwórz klucz zarządzania za pomocą API:

curl -X POST https://gate.joingonka.ai/api/management/keys \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "My SaaS"}'

Odpowiedź zawiera klucz jawny (prefix gm-) — zachowaj go, jest wyświetlany tylko raz.

Krok 3: Utwórz klucz podrzędny dla klienta:

curl -X POST https://gate.joingonka.ai/api/management/keys/{gm_key_id}/children \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "Client A", "limit_daily_ngonka": "1000000000", "rate_limit_rpm": 30}'

Klient A otrzymuje klucz gc- z limitem 1 GNK/dzień i 30 zapytań/minutę.

Limity i TTL

Każdy klucz podrzędny obsługuje trzy rodzaje ograniczeń:

Dzienny limit (limit_daily_ngonka) — maksymalny koszt w ciągu dnia UTC. Resetuje się automatycznie o północy UTC.
Miesięczny limit (limit_monthly_ngonka) — maksymalny koszt w ciągu miesiąca kalendarzowego.
TTL (expires_at) — data/godzina wygaśnięcia klucza. Po tym momencie klucz przestaje być uwierzytelniany.

W przypadku przekroczenia dziennego lub miesięcznego limitu klient otrzymuje HTTP 402 ze szczegółami:

{"error": {"type": "child_key_limit", "daily_remaining": "0", "monthly_remaining": "500000000"}}

Wszystkie limity są opcjonalne — jeśli nie są określone, klucz jest ograniczony tylko saldem właściciela.

Zarządzanie kluczami podrzędnymi

Pełny CRUD przez API:

Operacja	Endpoint	Opis
Utwórz	POST /api/management/keys/:id/children	Nowy klucz gc- z limitami
Lista	GET /api/management/keys/:id/children	Wszystkie klucze podrzędne z wykorzystaniem
Aktualizuj	PATCH /api/management/keys/:id/children/:childId	Zmień limity, RPM, status
Usuń	DELETE /api/management/keys/:id/children/:childId	Miękka dezaktywacja

Dostępne jest również zarządzanie przez Dashboard: sekcja API Keys → Management Keys.

Porównanie z konkurencją

Funkcjonalność	JoinGonka	GonkaGate	OpenRouter
Klucze Zarządzania	gm- / gc-	gpm- (marzec 2026)	Nie
Limity dzienne/miesięczne	GNK (nGNK)	USD	—
TTL (czas życia)	expires_at	Nie	—
Dashboard UI	Tak (sekcja Keys)	Nie	—
Referrale	10% L1 + 3% L2	Nie	Nie
Cena inferencji	$0.001/1M	~$0.0035/1M	$0.08+/1M

JoinGonka — jedyny gateway Gonka z limitami GNK, TTL i interfejsem użytkownika dashboard dla kluczy zarządzania.

Klucze Zarządzania zmieniają JoinGonka Gateway w platformę white-label. Jeden klucz zarządzania → nieograniczona liczba kluczy podrzędnych z indywidualnymi limitami. Twoi klienci otrzymują inferencję AI, a Ty kontrolujesz koszty i zarabiasz na marży.

← JoinGonka Gateway — pełny przegląd

Chcesz wiedzieć więcej?

Zapoznaj się z innymi sekcjami lub zacznij zarabiać GNK już teraz.

Uzyskaj darmowe 10M tokenów →