Management Keys — SaaS en Gonka

¿Es usted un desarrollador de SaaS y quiere ofrecer inferencia de IA a sus clientes sin infraestructura propia? Las Management Keys permiten crear claves API jerárquicas: una clave maestra gestiona múltiples claves de cliente con límites individuales y fecha de caducidad. Bajo el capó, el JoinGonka Gateway y la red Gonka.

Qué son las Management Keys

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.

Para qué sirven

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:

Problema	Cómo lo resuelve
Control de gastos	Límite diario y mensual en GNK para cada child key
Acceso temporal	TTL (expires_at): la clave se desactiva automáticamente
Aislamiento de clientes	Cada cliente con su clave gc- y límite de tasa
Facturación unificada	Todas las child keys debitan de su saldo: una sola factura

Cómo crear una Management Key

Paso 1: Regístrate en gate.joingonka.ai y recarga tu saldo con GNK, WGNK o USDT.

Paso 2: Crea una management key 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 una plain key (prefijo gm-) — guárdala, solo se muestra una vez.

Paso 3: Crea una child key 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 por minuto.

Límites y TTL

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.

Gestión de claves secundarias (child keys)

CRUD completo a través de la API:

Operación	Endpoint	Descripción
Crear	POST /api/management/keys/:id/children	Nueva clave gc- con límites
Lista	GET /api/management/keys/:id/children	Todas las claves secundarias con uso
Actualizar	PATCH /api/management/keys/:id/children/:childId	Cambiar límites, RPM, estado
Eliminar	DELETE /api/management/keys/:id/children/:childId	Desactivación suave

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

Comparación con los competidores

Funcionalidad	JoinGonka	OpenRouter
Management keys	gm- / gc-	No
Límites daily/monthly	GNK (nGNK)	—
TTL (periodo de validez)	expires_at	—
Dashboard UI	Sí (sección Keys)	—
Referidos	10% L1 + 3% L2	No
Precio de inference	$0.0069 / $0.021 por 1M	$0.08+/1M

JoinGonka proporciona límites GNK, TTL y Dashboard UI para management keys — sobre la barata red de inference de Gonka.

Las Management Keys transforman JoinGonka Gateway en una plataforma de marca blanca. Una clave de gestión → un número ilimitado de claves secundarias con límites individuales. Sus clientes obtienen inferencia de IA, usted controla los costos y gana con el margen.

← JoinGonka Gateway — Resumen completo La API de IA más barata: comparación de proveedores 2026 →

¿Quieres saber más?

Explora otras secciones o empieza a ganar GNK ahora mismo.

Obtener tokens gratuitos →