ส่วนของฐานความรู้ ▾

สำหรับนักลงทุน

เครื่องมือ

เครื่องมือ

Management Keys — SaaS บน Gonka

คุณเป็นนักพัฒนา SaaS และต้องการนำเสนอ AI inference ให้กับลูกค้าของคุณโดยไม่ต้องมีโครงสร้างพื้นฐานเป็นของตัวเองใช่หรือไม่? Management Keys ช่วยให้สามารถสร้างคีย์ API แบบลำดับชั้นได้: คีย์หลักหนึ่งคีย์สามารถจัดการคีย์ลูกหลายคีย์พร้อมขีดจำกัดและอายุการใช้งานที่กำหนดเอง ภายใต้พื้นฐานคือ JoinGonka Gateway และเครือข่าย Gonka

Management Keys คืออะไร

Management Keys คือระบบคีย์ API แบบลำดับชั้นสำหรับการสร้างผลิตภัณฑ์ SaaS บน Gonka AI Gateway

สถาปัตยกรรมมีสองระดับ:

  • Management key (gm-) — คีย์หลักของคุณ ไม่ได้ใช้สำหรับการอนุมานโดยตรง — ใช้สำหรับสร้างและจัดการคีย์ลูกเท่านั้น
  • Child key (gc-) — คีย์สำหรับลูกค้าของคุณ ใช้สำหรับคำขออนุมาน การเรียกเก็บเงินจะถูกหักจากยอดคงเหลือของเจ้าของ management key

นี่คือรูปแบบ white-label: ลูกค้าของคุณทำงานผ่าน gc- keys ของตนเองและไม่ทราบเกี่ยวกับ Gonka — สำหรับพวกเขา นี่คือบริการของคุณ

ทำไมถึงต้องมี

หากไม่มี Management Keys คุณจะต้องแจกจ่ายคีย์ API เดียวกันให้กับลูกค้าทั้งหมด — โดยไม่มีการควบคุมค่าใช้จ่าย, ไม่มีการแยก, ไม่มีการวิเคราะห์ Management Keys แก้ปัญหา 4 ประการ:

ปัญหาวิธีแก้ไข
การควบคุมค่าใช้จ่ายจำกัดรายวันและรายเดือนใน GNK สำหรับแต่ละ child key
การเข้าถึงชั่วคราวTTL (expires_at) — คีย์จะถูกปิดใช้งานอัตโนมัติ
การแยกลูกค้าแต่ละลูกค้ามี gc- key และ rate limit ของตัวเอง
การเรียกเก็บเงินแบบรวมศูนย์child keys ทั้งหมดหักจากยอดคงเหลือของคุณ — ใบแจ้งหนี้เดียว

วิธีสร้าง Management Key

ขั้นตอนที่ 1: ลงทะเบียนที่ gate.joingonka.ai และเติมเงินในยอดคงเหลือ GNK หรือ USDT

ขั้นตอนที่ 2: สร้าง management key ผ่าน 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"}'

การตอบกลับมี plain key (prefix 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 ได้รับ gc- key ที่มีขีดจำกัด 1 GNK/วัน และ 30 คำขอ/นาที

ขีดจำกัดและ TTL

แต่ละ child key รองรับข้อจำกัดสามประเภท:

  • ขีดจำกัดรายวัน (limit_daily_ngonka) — ค่าใช้จ่ายสูงสุดสำหรับวัน UTC โดยจะถูกรีเซ็ตโดยอัตโนมัติเมื่อเที่ยงคืน UTC
  • ขีดจำกัดรายเดือน (limit_monthly_ngonka) — สูงสุดสำหรับเดือนปฏิทิน
  • TTL (expires_at) — วันที่/เวลาที่คีย์หมดอายุ หลังจากเวลานี้คีย์จะไม่สามารถยืนยันตัวตนได้อีกต่อไป

เมื่อเกินขีดจำกัดรายวันหรือรายเดือน ลูกค้าจะได้รับ HTTP 402 พร้อมรายละเอียด:

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

ข้อจำกัดทั้งหมดเป็นทางเลือก — หากไม่ได้ระบุไว้ คีย์จะถูกจำกัดด้วยยอดคงเหลือของเจ้าของเท่านั้น

การจัดการ child keys

CRUD เต็มรูปแบบผ่าน API:

การดำเนินการEndpointคำอธิบาย
สร้างPOST /api/management/keys/:id/childrengc- key ใหม่พร้อมขีดจำกัด
รายการGET /api/management/keys/:id/childrenchild keys ทั้งหมดพร้อมการใช้งาน
อัปเดตPATCH /api/management/keys/:id/children/:childIdเปลี่ยนขีดจำกัด, RPM, สถานะ
ลบDELETE /api/management/keys/:id/children/:childIdการปิดใช้งานแบบ Soft

นอกจากนี้ยังมีการจัดการผ่าน Dashboard: ส่วน API Keys → Management Keys

เปรียบเทียบกับคู่แข่ง

ความสามารถJoinGonkaGonkaGateOpenRouter
Management keysgm- / gc-gpm- (มีนาคม 2026)ไม่มี
ขีดจำกัดรายวัน/รายเดือนGNK (nGNK)USD—
TTL (อายุการใช้งาน)expires_atไม่มี—
Dashboard UIมี (ส่วน Keys)ไม่มี—
Refferals10% L1 + 3% L2ไม่มีไม่มี
ราคา inference$0.001/1M~$0.0035/1M$0.08+/1M

JoinGonka — เป็น Gonka-gateway เดียวที่มี GNK-limits, TTL และ Dashboard UI สำหรับ management keys

Management Keys เปลี่ยน JoinGonka Gateway ให้เป็นแพลตฟอร์ม white-label management key หนึ่งคีย์ → child keys ได้ไม่จำกัดจำนวนพร้อมขีดจำกัดเฉพาะ ลูกค้าของคุณจะได้รับ AI-inference คุณควบคุมค่าใช้จ่ายและสร้างรายได้จากส่วนต่าง
← JoinGonka Gateway — ภาพรวมโดยละเอียด

ต้องการเรียนรู้เพิ่มเติมหรือไม่?

สำรวจส่วนอื่นๆ หรือเริ่มรับ GNK ทันที

รับโทเค็น 10M ฟรี →