マネジメントキー — Gonka 上の SaaS

マネジメントキーは、Gonka AI Gateway の上に SaaS 製品を構築するための階層型 API キーのシステムです。

アーキテクチャは 2 段階です。

• マネジメントキー（gm-） — あなたのマスターキー。推論に直接使用されず、子キーの作成と管理にのみ使用されます。
• 子キー（gc-） — あなたのクライアント用のキー。推論リクエストに使用されます。課金はマネジメントキーの所有者の残高から差し引かれます。

これはホワイトラベルモデルです。あなたのクライアントは彼らの gc- キーを介して動作し、Gonka については何も知りません。彼らにとってはあなたのサービスです。

マネジメントキーがなければ、すべてのクライアントに 1 つの 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 は、1 GNK/日、30 リクエスト/分の制限付き gc- キーを受け取ります。

各子キーは 3 種類の制限をサポートしています。

• 日次制限 (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 Keys → Management Keys セクションをご覧ください。

JoinGonka は、GNK 制限、TTL、およびマネジメントキー用のダッシュボード UI を備えた唯一の Gonka ゲートウェイです。