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

Client 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 токенов →