Management Keys — SaaS on Gonka

Management Keys are a system of hierarchical API keys for building SaaS products on top of Gonka AI Gateway.

The architecture is two-tiered:

• Management key (gm-) — your master key. Not used for direct inference — only for creating and managing child keys.
• Child key (gc-) — a key for your client. Used for inference requests. Billing is deducted from the management key owner's balance.

This is a white-label model: your clients work through their gc- keys and don't know about Gonka — for them, it's your service.

Without Management Keys, you would give one API key to all clients — without cost control, without isolation, without analytics. Management Keys solve 4 problems:

Step 1: Register at gate.joingonka.ai and top up your GNK or USDT balance.

Step 2: Create a management key via 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"}'

The response contains a plain key (prefix gm-) — save it, it is only shown once.

Step 3: Create a child key for a client:

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 receives a gc- key with a limit of 1 GNK/day and 30 requests/minute.

Each child key supports three types of restrictions:

• Daily limit (limit_daily_ngonka) — maximum spending per UTC day. Resets automatically at UTC midnight.
• Monthly limit (limit_monthly_ngonka) — maximum for a calendar month.
• TTL (expires_at) — key expiration date/time. After this moment, the key stops authenticating.

If the daily or monthly limit is exceeded, the client receives an HTTP 402 with details:

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

All limits are optional — if not specified, the key is limited only by the owner's balance.

Full CRUD via API:

Management is also available through the Dashboard: API Keys → Management Keys section.

JoinGonka is the only Gonka gateway with GNK limits, TTL, and Dashboard UI for management keys.