관리 키 — Gonka 위의 SaaS

관리 키는 Gonka AI Gateway 위에 SaaS 제품을 구축하기 위한 계층적 API 키 시스템입니다.

아키텍처는 2단계입니다.

• 관리 키(gm-) — 귀하의 마스터 키입니다. 추론에 직접 사용되지 않으며, 하위 키 생성 및 관리에만 사용됩니다.
• 하위 키(gc-) — 귀하의 클라이언트용 키입니다. 추론 요청에 사용됩니다. 청구는 관리 키 소유자의 잔액에서 차감됩니다.

이것은 화이트 라벨 모델입니다. 귀하의 클라이언트는 gc- 키를 통해 작동하며 Gonka에 대해 알지 못합니다. 그들에게는 귀하의 서비스입니다.

관리 키가 없으면 모든 클라이언트에게 단일 API 키를 배포하여 비용 관리, 격리, 분석이 불가능했을 것입니다. 관리 키는 다음과 같은 4가지 문제를 해결합니다.

1단계: gate.joingonka.ai에 가입하고 GNK, WGNK 또는 USDT로 잔액을 충전합니다.

2단계: API를 통해 management key를 생성합니다:

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단계: 클라이언트를 위한 child key를 생성합니다:

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

Client A는 하루 1 GNK 한도와 분당 30회 요청 제한이 있는 gc- 키를 받게 됩니다.

각 하위 키는 세 가지 종류의 제한을 지원합니다.

• 일일 제한 (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는 저렴한 Gonka inference 네트워크 위에서 Management keys를 위한 GNK 제한, TTL 및 Dashboard UI 기능을 제공합니다.