관리 키 — Gonka 위의 SaaS

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

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

• 관리 키(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는 일일 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는 GNK 제한, TTL, 관리 키용 대시보드 UI를 갖춘 유일한 Gonka 게이트웨이입니다.