Yönetim Anahtarları – Gonka'da SaaS

Bir SaaS geliştiricisi misiniz ve kendi altyapınız olmadan müşterilerinize yapay zeka çıkarımı sunmak mı istiyorsunuz? Yönetim Anahtarları, hiyerarşik API anahtarları oluşturmanıza olanak tanır: bir ana anahtar, çeşitli istemci anahtarlarını, kendi bireysel limitleri ve geçerlilik süreleri ile yönetir. Arka planda JoinGonka Gateway ve Gonka ağı çalışır.

Yönetim Anahtarları Nedir

Yönetim Anahtarları, Gonka AI Ağ Geçidi üzerinde SaaS ürünleri oluşturmak için hiyerarşik API anahtarları sistemidir.

Mimari iki katmanlıdır:

Yönetim anahtarı (gm-) – sizin ana anahtarınız. Doğrudan çıkarım için kullanılmaz – yalnızca alt anahtarları oluşturmak ve yönetmek için kullanılır.
Alt anahtar (gc-) – müşteriniz için anahtar. Çıkarım istekleri için kullanılır. Faturalandırma, yönetim anahtarı sahibinin bakiyesinden düşülür.

Bu bir beyaz etiket modelidir: müşterileriniz kendi gc- anahtarları üzerinden çalışır ve Gonka'dan haberdar değildir – onlar için bu sizin hizmetinizdir.

Buna neden ihtiyaç var?

Yönetim Anahtarları olmadan, tüm müşterilere tek bir API anahtarı verirdiniz – harcama kontrolü, izolasyon, analiz olmadan. Yönetim Anahtarları 4 sorunu çözer:

Görev	Nasıl Çözüyor
Harcama Kontrolü	Her alt anahtar için günlük ve aylık GNK limiti
Geçici Erişim	TTL (expires_at) – anahtar otomatik olarak devre dışı bırakılır
Müşteri İzolasyonu	Her müşteri kendi gc- anahtarı ve oran sınırlaması ile
Birleşik Faturalama	Tüm alt anahtarlar sizin bakiyenizden düşer – tek bir fatura

Yönetim Anahtarı Nasıl Oluşturulur

Adım 1: gate.joingonka.ai adresine kaydolun ve bakiyenize GNK veya USDT yükleyin.

Adım 2: API aracılığıyla bir yönetim anahtarı oluşturun:

curl -X POST https://gate.joingonka.ai/api/management/keys \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "My SaaS"}'

Yanıt, düz anahtarı (gm- öneki) içerir – bunu kaydedin, yalnızca bir kez gösterilir.

Adım 3: Müşteri için bir alt anahtar oluşturun:

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

Müşteri A, günde 1 GNK ve dakikada 30 istek limiti olan bir gc- anahtarı alır.

Limitler ve TTL

Her alt anahtar üç tür kısıtlamayı destekler:

Günlük Limit (limit_daily_ngonka) – bir UTC günü için maksimum harcama. UTC gece yarısı otomatik olarak sıfırlanır.
Aylık Limit (limit_monthly_ngonka) – bir takvim ayı için maksimum.
TTL (expires_at) – anahtarın sona erme tarihi/saati. Bu noktadan sonra anahtar kimlik doğrulaması yapmayı durdurur.

Günlük veya aylık limitin aşılması durumunda, istemci ayrıntılı HTTP 402 alır:

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

Tüm limitler isteğe bağlıdır – belirtilmezse, anahtar yalnızca sahibinin bakiyesiyle sınırlıdır.

Alt anahtarların Yönetimi

API aracılığıyla tam CRUD:

İşlem	Uç nokta	Açıklama
Oluştur	POST /api/management/keys/:id/children	Limitli yeni gc- anahtarı
Liste	GET /api/management/keys/:id/children	Kullanım verileriyle birlikte tüm alt anahtarlar
Güncelle	PATCH /api/management/keys/:id/children/:childId	Limitleri, RPM'i, durumu değiştir
Sil	DELETE /api/management/keys/:id/children/:childId	Yumuşak devre dışı bırakma

Yönetim ayrıca Pano üzerinden de mevcuttur: API Anahtarları → Yönetim Anahtarları bölümü.

Rakiplerle Karşılaştırma

Özellik	JoinGonka	GonkaGate	OpenRouter
Yönetim anahtarları	gm- / gc-	gpm- (Mart 2026)	Hayır
Günlük/Aylık limitler	GNK (nGNK)	USD	—
TTL (geçerlilik süresi)	expires_at	Hayır	—
Kontrol Paneli Kullanıcı Arayüzü	Evet (Anahtarlar bölümü)	Hayır	—
Referanslar	%10 L1 + %3 L2	Hayır	Hayır
Çıkarım fiyatı	$0.001/1M	~$0.0035/1M	$0.08+/1M

JoinGonka, GNK limitleri, TTL ve yönetim anahtarları için kontrol paneli kullanıcı arayüzüne sahip tek Gonka ağ geçididir.

Yönetim Anahtarları, JoinGonka Gateway'i bir beyaz etiket platformuna dönüştürür. Bir yönetim anahtarı → bireysel limitlere sahip sınırsız sayıda alt anahtar. Müşterileriniz AI çıkarımı alır, siz harcamaları kontrol edersiniz ve marjdan kazanırsınız.

← JoinGonka Gateway — Tam İnceleme

Daha fazla bilgi edinmek ister misiniz?

Diğer bölümleri keşfedin veya şimdi GNK kazanmaya başlayın.

Ücretsiz 10M token alın →