Management Keys — SaaS na Gonka

Management Keys é um sistema de chaves API hierárquicas para a construção de produtos SaaS sobre Gonka AI Gateway.

A arquitetura é de dois níveis:

• Management key (gm-) — sua chave mestra. Não é usada para inferência diretamente — apenas para criar e gerenciar chaves filhas.
• Child key (gc-) — chave para seu cliente. É usada para solicitações de inferência. A cobrança é debitada do saldo do proprietário da management key.

Este é um modelo white-label: seus clientes trabalham através de suas chaves gc- e não sabem sobre Gonka — para eles, é o seu serviço.

Sem Management Keys, você distribuiria uma única chave API para todos os clientes — sem controle de gastos, sem isolamento, sem análise. As Management Keys resolvem 4 problemas:

Passo 1: Registre-se em gate.joingonka.ai e recarregue seu saldo com GNK ou USDT.

Passo 2: Crie uma chave de gerenciamento através da 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"}'

A resposta contém a chave simples (prefixo gm-) — salve-a, ela é exibida apenas uma vez.

Passo 3: Crie uma child key para o cliente:

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

O Cliente A recebe uma chave gc- com um limite de 1 GNK/dia e 30 solicitações/minuto.

Cada chave filha suporta três tipos de restrições:

• Limite diário (limit_daily_ngonka) — gasto máximo por dia UTC. É redefinido automaticamente à meia-noite UTC.
• Limite mensal (limit_monthly_ngonka) — máximo por mês calendário.
• TTL (expires_at) — data/hora de expiração da chave. Após este momento, a chave deixa de autenticar.

Ao exceder o limite diário ou mensal, o cliente recebe um HTTP 402 com detalhes:

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

Todos os limites são opcionais — se não forem especificados, a chave é limitada apenas pelo saldo do proprietário.

CRUD completo via API:

Também é possível gerenciar via Dashboard: seção API Keys → Management Keys.

JoinGonka — o único gateway Gonka com limites GNK, TTL e UI de painel para chaves de gerenciamento.