Für KI-Agenten: Schritt-für-Schritt-Anleitung zur Einrichtung — /docs/agents.md, Dokumentationsindex — /llms.txt.

Tarife und Konto

Modellpreise, Einzahlungs- und Auszahlungsgebühren, GNK-Kurs. Account-API per Schlüssel: Guthaben, Ausgaben nach Tag und Modell, Transaktionsverlauf und Einzahlungen.

Modellpreise#

Die Preise enthalten bereits den Aufschlag der Plattform 10%. Live-Werte — GET /api/pricing, ohne Schlüssel.

modelEingabe, $ pro 1M TokenAusgabe, $ pro 1M TokennGNK pro Token: Eingabe / Ausgabe
zai-org/GLM-5.3-Flash$0.006534$0.019633 / 99
deepseek-ai/DeepSeek-V4-Flash-0731$0.006534$0.019633 / 99
MiniMaxAI/MiniMax-M2.7$0.006534$0.019633 / 99
  • Kosten einer Anfrage = Eingabe-Token × Eingabepreis + Ausgabe-Token × Ausgabepreis. Die Überlegungen des Modells zählen als Ausgabe-Token.
  • Die Abbuchung erfolgt in GNK (1 GNK = 10⁹ nGNK); Dollarpreise — zum GNK-Kurs $0.198.
  • Vor der Anfrage gleicht das Gateway das Guthaben mit der Kostenschätzung ab; reicht es nicht — 402 insufficient_funds.
  • Nach der Registrierung erhalten Sie 0.1 GNK aufs Konto — rund 3M Token zum Eingabepreis.

Gebühren#

VorgangGebührHinweis
Aufschlag auf Modellanfragen10%Ist bereits in den Preisen oben enthalten.
GNK-AufladungkostenlosÜberweisung an die Gateway-Adresse mit Ihrem memo; die Gutschrift erfolgt automatisch.
USDT-Aufladung5% → 2.5%Zahlung über OxaPay; je höher der Betrag, desto niedriger die Gebühr — USDT-Gebührenstaffel.
WGNK-Aufladung aus Ethereum1%Deckt das Gas des Ethereum-Netzwerks bei der Überweisung nach Gonka.
GNK-Auszahlung5%Nur aus dem Dashboard, ab 1 GNK.
GNK-Kurs$0.198Nach ihm werden Aufladungen und Dollarpreise berechnet; wird automatisch aktualisiert.

USDT-Gebührenstaffel#

Der Satz hängt vom Aufladebetrag ab, die Schwelle ist inklusive:

AufladebetragGebühr
ab $05%
ab $254.5%
ab $504%
ab $1003.5%
ab $2503%
ab $5002.75%
ab $10002.5%

Account-API#

Guthaben, Verbrauch und Aufladungen sind über denselben Schlüssel verfügbar wie die Modellanfragen (Authorization: Bearer jg-…). Diese Anfragen verbrauchen keine Token.

Fehler: ohne Schlüssel — 401 authentication_error, ungültige Parameter — 400 validation_error, Dashboard-Route mit API-Schlüssel — 403 forbidden.

GET /api/balance#

Aktuelles Guthaben.

FeldBeschreibung
balance_ngonkaGuthaben in nGNK — als String, um keine Präzision zu verlieren
balance_usdGuthaben in Dollar zum aktuellen Kurs
cost_per_token_ngonkaPreis eines Eingabe-Tokens des empfohlenen Modells mit Aufschlag, nGNK
tokens_remainingWie viele Eingabe-Tokens das Guthaben zu diesem Preis abdeckt — eine Schätzung
cURL
curl -s https://gate.joingonka.ai/api/balance \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"

GET /api/usage#

Verbrauch pro Tag: Anfragen, Tokens, Kosten.

  • period — day, week, month, quarter, Standard ist month.
  • Oder from und to im Format YYYY-MM-DD, beide zusammen, bis einschließlich 92 Tage — dann enthält die Antwort period: custom.
  • tz — Verschiebung in Minuten, wie getTimezoneOffset() im Browser: für UTC+3 — -180. Ohne Angabe — UTC.

Die Antwort ist ein Array von Tagen mit den Feldern date, requests, tokens, costNgonka. Detaillierte Anfrageeinträge werden 90 Tage lang aufbewahrt.

cURL
curl -s "https://gate.joingonka.ai/api/usage?period=week&tz=-180" \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"

GET /api/usage/by-model#

Verbrauch nach Modellen: Summen in models und eine Reihe „Zeitraum × Modell“ in series — Stunden bei period=day, sonst Tage. Parameter wie bei /api/usage.

GET /api/usage/by-key#

Verbrauch nach Schlüsseln — keys. Parameter wie bei /api/usage.

GET /api/transactions#

Transaktionsverlauf: Einzahlungen, Abbuchungen für Anfragen, Boni, Auszahlungen.

  • limit — bis zu 200, Standard ist 50; offset — Verschiebung.
  • type — Filter: DEPOSIT_USDT, DEPOSIT_GNK, DEPOSIT_FIAT, INFERENCE, REFERRAL_REWARD, BONUS, WITHDRAWAL.
  • from und to — Datumsangaben, Ende inklusive.

Die Antwort enthält Datensätze mit den Feldern id, type, amountNgonka, feeNgonka, description, createdAt und der Gesamtzahl total. INFERENCE-Abbuchungen werden in Stapeln geschrieben: ein Datensatz für die Anfragen des Nutzers innerhalb von Sekundenbruchteilen, die Details zu jeder Anfrage stehen in /api/usage. INFERENCE-Datensätze, die älter als 90 Tage sind, werden zu einem pro Tag zusammengefasst.

GET /api/deposits#

Nur Einzahlungen. Parameter limit, offset, from und to — wie beim Transaktionsverlauf; die Antwort enthält total.

POST /api/deposit/gnk#

Einzahlungsdaten für GNK: address und memo. Überweisen Sie GNK mit dieser memo an diese Adresse — die Gutschrift erfolgt automatisch.

GET /api/deposit/usdt/rate#

USDT-Einzahlungskurs und -Gebühr: gnk_usd_price, fee_percent, fee_tiers.

POST /api/deposit/usdt#

USDT-Zahlungsrechnung: Body {"amount": 25} — Betrag in Dollar von 1 bis 10000; die Antwort enthält payment_url. Wenn die USDT-Annahme vorübergehend geschlossen ist — 503.

GET /api/pricing#

Preise und Gebühren ohne Schlüssel: models[], deposit_usdt_fee_tiers, GNK-Kurs und Registrierungsbonus.

Nur im Kundenbereich#

Kontoverwaltung — im Kundenbereich gate.joingonka.ai/dashboard. Diese Routen sind nicht für Integrationen gedacht, einige davon antworten einem API-Schlüssel mit 403 forbidden:

  • API-Schlüssel — gate.joingonka.ai/keys;
  • GNK-Auszahlung — ab 1 GNK;
  • Karten-Einzahlung und Absenderadressen für WGNK;
  • Promo-Codes;
  • Empfehlungsprogramm und Newsletter-Einstellungen.