Management Keys – SaaS auf Gonka

Sind Sie ein SaaS-Entwickler und möchten Ihren Kunden KI-Inferenzen ohne eigene Infrastruktur anbieten? Management Keys ermöglichen die Erstellung hierarchischer API-Schlüssel: Ein Master-Schlüssel verwaltet mehrere Client-Schlüssel mit individuellen Limits und Ablaufzeiten. Im Hintergrund arbeiten JoinGonka Gateway und das Gonka-Netzwerk.

Was sind Management Keys

Management Keys ist ein System hierarchischer API-Schlüssel zum Aufbau von SaaS-Produkten auf dem Gonka AI Gateway.

Die Architektur ist zweistufig:

Management Key (gm-) – Ihr Master-Schlüssel. Wird nicht direkt für Inferenzen verwendet – nur zum Erstellen und Verwalten von Kinderschlüsseln.
Child Key (gc-) – Schlüssel für Ihren Kunden. Wird für Inferenzanfragen verwendet. Die Abrechnung erfolgt über das Guthaben des Inhabers des Management Keys.

Dies ist ein White-Label-Modell: Ihre Kunden arbeiten über ihre gc-Schlüssel und wissen nichts von Gonka – für sie ist es Ihr Dienst.

Warum wird das benötigt?

Ohne Management Keys würden Sie allen Kunden einen einzigen API-Schlüssel geben – ohne Kostenkontrolle, ohne Isolation, ohne Analyse. Management Keys lösen 4 Aufgaben:

Aufgabe	Lösung
Kostenkontrolle	Tägliches und monatliches Limit in GNK für jeden untergeordneten Schlüssel
Temporärer Zugriff	TTL (expires_at) – Schlüssel wird automatisch deaktiviert
Kundenisolation	Jeder Client mit eigenem gc-Schlüssel und Rate Limit
Einheitliche Abrechnung	Alle Child Keys buchen von Ihrem Guthaben ab – eine Rechnung

Wie man einen Management Key erstellt

Schritt 1: Registrieren Sie sich auf gate.joingonka.ai und füllen Sie Ihr GNK- oder USDT-Guthaben auf.

Schritt 2: Erstellen Sie einen Management Key über die 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"}'

Die Antwort enthält den unformatierten Schlüssel (Präfix gm-) – speichern Sie ihn, er wird nur einmal angezeigt.

Schritt 3: Erstellen Sie einen Kinderschlüssel für den Kunden:

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 erhält einen gc-Schlüssel mit einem Limit von 1 GNK/Tag und 30 Anfragen/Minute.

Limits und TTL

Jeder Kinderschlüssel unterstützt drei Arten von Beschränkungen:

Tägliches Limit (limit_daily_ngonka) – maximaler Verbrauch pro UTC-Tag. Wird automatisch um Mitternacht UTC zurückgesetzt.
Monatliches Limit (limit_monthly_ngonka) – maximaler Verbrauch pro Kalendermonat.
TTL (expires_at) – Datum/Uhrzeit des Ablaufs des Schlüssels. Nach diesem Zeitpunkt kann der Schlüssel nicht mehr authentifiziert werden.

Bei Überschreitung des Tages- oder Monatslimits erhält der Client HTTP 402 mit Details:

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

Alle Limits sind optional – wenn nicht angegeben, ist der Schlüssel nur durch das Guthaben des Eigentümers begrenzt.

Verwaltung von Child Keys

Vollständiges CRUD über API:

Operation	Endpunkt	Beschreibung
Erstellen	POST /api/management/keys/:id/children	Neuer gc-Schlüssel mit Limits
Liste	GET /api/management/keys/:id/children	Alle Kinderschlüssel mit Nutzung
Aktualisieren	PATCH /api/management/keys/:id/children/:childId	Limits, RPM, Status ändern
Löschen	DELETE /api/management/keys/:id/children/:childId	Soft-Deaktivierung

Die Verwaltung ist auch über das Dashboard möglich: Bereich API Keys → Management Keys.

Vergleich mit Mitbewerbern

Funktion	JoinGonka	GonkaGate	OpenRouter
Management Keys	gm- / gc-	gpm- (März 2026)	Nein
Tages-/Monatslimits	GNK (nGNK)	USD	—
TTL (Ablaufzeit)	expires_at	Nein	—
Dashboard UI	Ja (Abschnitt Keys)	Nein	—
Referrals	10% L1 + 3% L2	Nein	Nein
Inference-Kosten	$0.001/1M	~$0.0035/1M	$0.08+/1M

JoinGonka ist das einzige Gonka-Gateway mit GNK-Limits, TTL und Dashboard-UI für Management Keys.

Management Keys verwandeln JoinGonka Gateway in eine White-Label-Plattform. Ein Management-Key → unbegrenzte Anzahl von Child Keys mit individuellen Limits. Ihre Kunden erhalten KI-Inferenzen, Sie kontrollieren die Kosten und verdienen an der Marge.

← JoinGonka Gateway — vollständige Übersicht

Möchten Sie mehr erfahren?

Erkunden Sie andere Abschnitte oder beginnen Sie jetzt GNK zu verdienen.

Erhalten Sie kostenlose 10M Token →