Management Keys — SaaS trên Gonka

Management Keys là một hệ thống khóa API phân cấp để xây dựng sản phẩm SaaS trên Gonka AI Gateway.

Kiến trúc hai cấp:

• Management key (gm-) — khóa chính của bạn. Không được sử dụng trực tiếp cho inference — chỉ để tạo và quản lý các khóa con.
• Child key (gc-) — khóa cho khách hàng của bạn. Được sử dụng cho các yêu cầu inference. Thanh toán được trừ từ số dư của chủ sở hữu management key.

Đây là mô hình nhãn trắng: khách hàng của bạn làm việc thông qua các khóa gc- của họ và không biết về Gonka — đối với họ, đây là dịch vụ của bạn.

Không có Management Keys, bạn sẽ cấp một khóa API duy nhất cho tất cả khách hàng — không kiểm soát chi phí, không cách ly, không phân tích. Management Keys giải quyết 4 vấn đề:

Bước 1: Đăng ký tại gate.joingonka.ai và nạp tiền bằng GNK hoặc USDT.

Bước 2: Tạo khóa quản lý qua 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"}'

Phản hồi chứa khóa cơ bản (tiền tố gm-) — hãy lưu nó lại, nó chỉ hiển thị một lần duy nhất.

Bước 3: Tạo khóa con cho khách hàng:

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 nhận khóa gc- với giới hạn 1 GNK/ngày và 30 yêu cầu/phút.

Mỗi khóa con hỗ trợ ba loại giới hạn:

• Giới hạn hàng ngày (limit_daily_ngonka) — chi tiêu tối đa trong một ngày UTC. Đặt lại tự động vào nửa đêm UTC.
• Giới hạn hàng tháng (limit_monthly_ngonka) — tối đa trong một tháng dương lịch.
• TTL (expires_at) — ngày/giờ hết hạn của khóa. Sau thời điểm này, khóa sẽ ngừng xác thực.

Khi vượt quá giới hạn hàng ngày hoặc hàng tháng, khách hàng nhận được HTTP 402 với chi tiết:

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

Tất cả các giới hạn là tùy chọn — nếu không được chỉ định, khóa chỉ bị giới hạn bởi số dư của chủ sở hữu.

CRUD đầy đủ thông qua API:

Cũng có thể quản lý thông qua Bảng điều khiển: mục Khóa API → Khóa quản lý.

JoinGonka — cổng Gonka duy nhất với giới hạn GNK, TTL và Giao diện người dùng Dashboard cho các khóa quản lý.