Management Keys — SaaS sur Gonka

Les Management Keys sont un système de clés API hiérarchiques pour la construction de produits SaaS basés sur la passerelle AI Gonka.

L'architecture est à deux niveaux :

• Management key (gm-) — votre clé maître. Elle n'est pas utilisée directement pour l'inférence — uniquement pour la création et la gestion des clés enfants.
• Child key (gc-) — clé pour votre client. Elle est utilisée pour les requêtes d'inférence. La facturation est débitée du solde du propriétaire de la clé de gestion.

C'est un modèle white-label : vos clients travaillent via leurs clés gc- et ne connaissent pas Gonka — pour eux, c'est votre service.

Sans Management Keys, vous distribueriez une seule clé API à tous les clients — sans contrôle des dépenses, sans isolation, sans analyse. Les Management Keys résolvent 4 problèmes :

Étape 1 : Inscrivez-vous sur gate.joingonka.ai et rechargez votre solde GNK ou USDT.

Étape 2 : Créez une clé de gestion via l'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 réponse contient la clé brute (préfixe gm-) — sauvegardez-la, elle n'est affichée qu'une seule fois.

Étape 3 : Créez une clé enfant pour le 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}'

Le client A obtient une clé gc- avec une limite de 1 GNK/jour et 30 requêtes/minute.

Chaque clé enfant prend en charge trois types de restrictions :

• Limite journalière (limit_daily_ngonka) — dépenses maximales par jour UTC. Réinitialisée automatiquement à minuit UTC.
• Limite mensuelle (limit_monthly_ngonka) — maximum pour un mois calendaire.
• TTL (expires_at) — date/heure d'expiration de la clé. Après ce moment, la clé cesse de s'authentifier.

En cas de dépassement de la limite journalière ou mensuelle, le client reçoit un code HTTP 402 avec les détails :

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

Toutes les limites sont facultatives — si elles ne sont pas spécifiées, la clé est uniquement limitée par le solde du propriétaire.

CRUD complet via API :

La gestion est également disponible via le tableau de bord : section Clés API → Clés de gestion.

JoinGonka fournit des limites GNK, TTL et une Dashboard UI pour les management keys — au-dessus du réseau d'inference économique de Gonka.