Management Keys — SaaS di Gonka

Anda adalah pengembang SaaS dan ingin menawarkan inferensi AI kepada pelanggan Anda tanpa infrastruktur sendiri? Management Keys memungkinkan Anda membuat kunci API hierarkis: satu kunci master mengelola banyak kunci klien dengan batas dan masa berlaku individual. Di balik layar — JoinGonka Gateway dan jaringan Gonka.

Apa itu Management Keys

Management Keys adalah sistem kunci API hierarkis untuk membangun produk SaaS di atas Gonka AI Gateway.

Arsitekturnya dua tingkat:

Management key (gm-) — kunci master Anda. Tidak digunakan untuk inferensi secara langsung — hanya untuk membuat dan mengelola kunci anak.
Child key (gc-) — kunci untuk klien Anda. Digunakan untuk permintaan inferensi. Penagihan didebit dari saldo pemilik kunci manajemen.

Ini adalah model white-label: klien Anda bekerja melalui kunci gc- mereka dan tidak mengetahui tentang Gonka — bagi mereka, ini adalah layanan Anda.

Mengapa ini diperlukan

Tanpa Management Keys, Anda akan memberikan satu kunci API kepada semua klien — tanpa kontrol pengeluaran, tanpa isolasi, tanpa analitik. Management Keys memecahkan 4 masalah:

Masalah	Cara memecahkan
Kontrol pengeluaran	Batas harian dan bulanan dalam GNK untuk setiap kunci anak
Akses sementara	TTL (expires_at) — kunci secara otomatis dinonaktifkan
Isolasi klien	Setiap klien dengan kunci gc- nya sendiri dan batas tarif
Penagihan terpadu	Semua kunci anak mengurangi saldo Anda — satu tagihan

Cara membuat Management Key

Langkah 1: Daftar di gate.joingonka.ai dan top up saldo GNK atau USDT Anda.

Langkah 2: Buat kunci manajemen melalui 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"}'

Respons berisi kunci biasa (awalan gm-) — simpan, hanya ditampilkan sekali.

Langkah 3: Buat kunci anak untuk klien:

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

Klien A mendapatkan kunci gc- dengan batas 1 GNK/hari dan 30 permintaan/menit.

Batas dan TTL

Setiap kunci anak mendukung tiga jenis batasan:

Batas harian (limit_daily_ngonka) — pengeluaran maksimum per hari UTC. Direset otomatis pada tengah malam UTC.
Batas bulanan (limit_monthly_ngonka) — maksimum untuk satu bulan kalender.
TTL (expires_at) — tanggal/waktu kedaluwarsa kunci. Setelah momen ini, kunci berhenti mengautentikasi.

Jika batas harian atau bulanan terlampaui, klien menerima HTTP 402 dengan rincian:

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

Semua batas adalah opsional — jika tidak disebutkan, kunci hanya dibatasi oleh saldo pemilik.

Manajemen kunci anak

CRUD lengkap melalui API:

Operasi	Endpoint	Deskripsi
Buat	POST /api/management/keys/:id/children	Kunci gc- baru dengan batas
Daftar	GET /api/management/keys/:id/children	Semua kunci anak dengan penggunaan
Perbarui	PATCH /api/management/keys/:id/children/:childId	Ubah batas, RPM, status
Hapus	DELETE /api/management/keys/:id/children/:childId	Penonaktifan lunak

Juga tersedia manajemen melalui Dashboard: bagian API Keys → Management Keys.

Perbandingan dengan pesaing

Fitur	JoinGonka	GonkaGate	OpenRouter
Kunci manajemen	gm- / gc-	gpm- (Maret 2026)	Tidak
Batas harian/bulanan	GNK (nGNK)	USD	—
TTL (masa berlaku)	expires_at	Tidak	—
UI Dasbor	Ya (bagian Kunci)	Tidak	—
Refferal	10% L1 + 3% L2	Tidak	Tidak
Harga inferensi	$0.001/1M	~$0.0035/1M	$0.08+/1M

JoinGonka adalah satu-satunya gateway Gonka dengan batas GNK, TTL, dan UI Dasbor untuk kunci manajemen.

Management Keys mengubah JoinGonka Gateway menjadi platform white-label. Satu kunci manajemen → jumlah kunci anak tidak terbatas dengan batas individual. Klien Anda mendapatkan inferensi AI, Anda mengontrol pengeluaran dan mendapatkan margin.

← JoinGonka Gateway — ulasan lengkap

Ingin tahu lebih banyak?

Jelajahi bagian lain atau mulai hasilkan GNK sekarang.

Dapatkan 10 juta token gratis →