管理密钥 — Gonka 上的 SaaS

管理密钥是用于在 Gonka AI Gateway 之上构建 SaaS 产品的分层 API 密钥系统。

架构分为两层：

• 管理密钥 (gm-) — 您的主密钥。不直接用于推理 — 仅用于创建和管理子密钥。
• 子密钥 (gc-) — 为您的客户提供的密钥。用于推理请求。计费从管理密钥所有者的余额中扣除。

这是一个白标模型：您的客户通过他们的 gc- 密钥工作，对 Gonka 一无所知 — 对他们来说，这是您的服务。

如果没有管理密钥，您会将一个 API 密钥分发给所有客户 — 没有成本控制，没有隔离，没有分析。管理密钥解决了4个问题：

步骤1：在gate.joingonka.ai上注册并充值 GNK 或 USDT 余额。

步骤2：通过 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"}'

响应包含纯密钥 (前缀 gm-) — 请保存它，它只会显示一次。

步骤3：为客户创建子密钥：

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

客户 A 收到一个 gc- 密钥，每日限制为 1 GNK，每分钟 30 个请求。

每个子密钥支持三种类型的限制：

• 日限制 (limit_daily_ngonka) — UTC 日的最大开销。在 UTC 午夜自动重置。
• 月限制 (limit_monthly_ngonka) — 日历月的最大开销。
• TTL (expires_at) — 密钥过期日期/时间。在此刻之后，密钥将停止认证。

如果超过日限制或月限制，客户端将收到带有详细信息的 HTTP 402 响应：

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

所有限制都是可选的 — 如果未指定，密钥仅受所有者余额的限制。

通过 API 进行完整的 CRUD 操作：

也可以通过仪表板管理：API 密钥 → 管理密钥 部分。

JoinGonka 是唯一具有 GNK 限制、TTL 和仪表板 UI 的 Gonka 网关，用于管理密钥。