Management Keys — SaaS su Gonka

Le Management Keys sono un sistema di chiavi API gerarchiche per la costruzione di prodotti SaaS sopra Gonka AI Gateway.

L'architettura è a due livelli:

• Management key (gm-) — la tua chiave master. Non viene utilizzata direttamente per l'inferenza, ma solo per creare e gestire chiavi figlie.
• Child key (gc-) — una chiave per il tuo cliente. Viene utilizzata per le richieste di inferenza. La fatturazione viene addebitata dal saldo del proprietario della management key.

Questo è un modello white-label: i tuoi clienti lavorano tramite le loro chiavi gc- e non sanno nulla di Gonka — per loro è il tuo servizio.

Senza Management Keys, dovresti distribuire la stessa chiave API a tutti i clienti — senza controllo delle spese, senza isolamento, senza analisi. Le Management Keys risolvono 4 problemi:

Passo 1: Registrati su gate.joingonka.ai e ricarica il saldo GNK o USDT.

Passo 2: Crea una management key tramite 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"}'

La risposta contiene la plain key (prefisso gm-) — salvala, viene mostrata solo una volta.

Passo 3: Crea una child key per il 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}'

Il Cliente A riceve una chiave gc- con un limite di 1 GNK/giorno e 30 richieste/minuto.

Ogni child key supporta tre tipi di limitazioni:

• Limite giornaliero (limit_daily_ngonka) — Spesa massima per giorno UTC. Si resetta automaticamente a mezzanotte UTC.
• Limite mensile (limit_monthly_ngonka) — Massimo per il mese solare.
• TTL (expires_at) — Data/ora di scadenza della chiave. Dopo questo momento, la chiave smette di autenticarsi.

Quando si supera il limite giornaliero o mensile, il cliente riceve un HTTP 402 con i dettagli:

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

Tutti i limiti sono opzionali — se non specificati, la chiave è limitata solo dal saldo del proprietario.

Completo CRUD tramite API:

La gestione è disponibile anche tramite la Dashboard: sezione API Keys → Management Keys.

JoinGonka offre limiti GNK, TTL e Dashboard UI per le management keys — il tutto basato sulla rete di inferenza low-cost di Gonka.