Management Keys — SaaS en Gonka

Management Keys es un sistema de claves API jerárquicas para crear productos SaaS sobre Gonka AI Gateway.

La arquitectura es de dos niveles:

• Management key (gm-) — su clave maestra. No se utiliza para inference directamente, solo para crear y gestionar claves secundarias.
• Child key (gc-) — clave para su cliente. Se utiliza para solicitudes de inference. La facturación se carga al saldo del propietario de la management key.

Este es un modelo de marca blanca: sus clientes trabajan a través de sus claves gc- y no saben nada de Gonka; para ellos, es su servicio.

Sin Management Keys, distribuiría una única clave API a todos los clientes, sin control de gastos, sin aislamiento y sin análisis. Las Management Keys resuelven 4 problemas:

Paso 1: Regístrese en gate.joingonka.ai y recargue su saldo con GNK o USDT.

Paso 2: Cree una clave de gestión a través de la 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 respuesta contiene la clave en texto plano (prefijo gm-). Guárdela, solo se muestra una vez.

Paso 3: Cree una clave secundaria para el 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}'

El Cliente A recibe una clave gc- con un límite de 1 GNK/día y 30 solicitudes/minuto.

Cada clave secundaria admite tres tipos de limitaciones:

• Límite diario (limit_daily_ngonka) — gasto máximo por día UTC. Se restablece automáticamente a medianoche UTC.
• Límite mensual (limit_monthly_ngonka) — máximo por mes calendario.
• TTL (expires_at) — fecha/hora de vencimiento de la clave. Después de este momento, la clave deja de autenticarse.

Al exceder el límite diario o mensual, el cliente recibe un HTTP 402 con detalles:

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

Todos los límites son opcionales; si no se especifican, la clave solo está limitada por el saldo del propietario.

CRUD completo a través de la API:

También es posible la gestión a través del Dashboard: sección API Keys → Management Keys.

JoinGonka es la única pasarela Gonka con límites de GNK, TTL y una interfaz de usuario en el panel para las claves de gestión.