Management Keys — SaaS на Gonka

Ви — SaaS-розробник і хочете пропонувати AI-інференс своїм клієнтам без власної інфраструктури? Management Keys дозволяють створювати ієрархічні API-ключі: один master-ключ управляє безліччю client-ключів з індивідуальними лімітами та терміном дії. Під капотом — JoinGonka Gateway та мережа Gonka.

Що таке Management Keys

Management Keys — це система ієрархічних API-ключів для побудови SaaS-продуктів поверх Gonka AI Gateway.

Архітектура дворівнева:

Management key (gm-) — ваш майстер-ключ. Не використовується для inference безпосередньо — лише для створення та управління дочірніми ключами.
Child key (gc-) — ключ для вашого клієнта. Використовується для inference-запитів. Білінг списується з балансу власника management key.

Це white-label модель: ваші клієнти працюють через свої gc-ключі та не знають про Gonka — для них це ваш сервіс.

Навіщо це потрібно

Без Management Keys ви б роздавали один API-ключ усім клієнтам — без контролю витрат, без ізоляції, без аналітики. Management Keys вирішують 4 завдання:

Завдання	Як вирішує
Контроль витрат	Денний та місячний ліміт у GNK на кожен child key
Тимчасовий доступ	TTL (expires_at) — ключ автоматично деактивується
Ізоляція клієнтів	Кожен клієнт зі своїм gc-ключем та rate limit
Єдиний білінг	Всі child keys списують з вашого балансу — один рахунок

Як створити Management Key

Крок 1: Зареєструйтесь на gate.joingonka.ai та поповніть баланс GNK або USDT.

Крок 2: Створіть management key через 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"}'

Відповідь містить plain key (префікс gm-) — збережіть його, він показується лише один раз.

Крок 3: Створіть child key для клієнта:

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}'

Клієнт A отримує gc-ключ з лімітом 1 GNK/день та 30 запитів/хвилину.

Ліміти та TTL

Кожен child key підтримує три види обмежень:

Денний ліміт (limit_daily_ngonka) — максимум витрат за UTC-день. Скидається автоматично опівночі UTC.
Місячний ліміт (limit_monthly_ngonka) — максимум за календарний місяць.
TTL (expires_at) — дата/час закінчення дії ключа. Після цього моменту ключ перестає аутентифікуватися.

При перевищенні денного або місячного ліміту клієнт отримує HTTP 402 з деталями:

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

Усі ліміти є опціональними — якщо не вказані, ключ обмежений лише балансом власника.

Управління child keys

Повний CRUD через API:

Операція	Endpoint	Опис
Створити	POST /api/management/keys/:id/children	Новий gc-ключ з лімітами
Список	GET /api/management/keys/:id/children	Всі child keys з usage
Оновити	PATCH /api/management/keys/:id/children/:childId	Змінити ліміти, RPM, статус
Видалити	DELETE /api/management/keys/:id/children/:childId	Soft-деактивація

Також доступне управління через Dashboard: розділ API Keys → Management Keys.

Порівняння з конкурентами

Можливість	JoinGonka	GonkaGate	OpenRouter
Management keys	gm- / gc-	gpm- (березень 2026)	Ні
Ліміти daily/monthly	GNK (nGNK)	USD	—
TTL (термін дії)	expires_at	Ні	—
Dashboard UI	Так (розділ Keys)	Ні	—
Реферали	10% L1 + 3% L2	Ні	Ні
Ціна inference	$0.001/1M	~$0.0035/1M	$0.08+/1M

JoinGonka — єдиний Gonka-гейтвей з GNK-лімітами, TTL та Dashboard UI для management keys.

Management Keys перетворюють JoinGonka Gateway на white-label платформу. Один management key → необмежена кількість child keys з індивідуальними лімітами. Ваші клієнти отримують AI-інференс, ви контролюєте витрати та заробляєте на маржі.

← JoinGonka Gateway — повний огляд

Бажаєте дізнатися більше?

Вивчіть інші розділи або почніть заробляти GNK прямо зараз.

Отримати безкоштовні 10M токенів →