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.
model | Eingabe, $ pro 1M Token | Ausgabe, $ pro 1M Token | nGNK pro Token: Eingabe / Ausgabe |
|---|---|---|---|
zai-org/GLM-5.3-Flash | $0.006534 | $0.0196 | 33 / 99 |
deepseek-ai/DeepSeek-V4-Flash-0731 | $0.006534 | $0.0196 | 33 / 99 |
MiniMaxAI/MiniMax-M2.7 | $0.006534 | $0.0196 | 33 / 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#
| Vorgang | Gebühr | Hinweis |
|---|---|---|
| Aufschlag auf Modellanfragen | 10% | Ist bereits in den Preisen oben enthalten. |
| GNK-Aufladung | kostenlos | Überweisung an die Gateway-Adresse mit Ihrem memo; die Gutschrift erfolgt automatisch. |
| USDT-Aufladung | 5% → 2.5% | Zahlung über OxaPay; je höher der Betrag, desto niedriger die Gebühr — USDT-Gebührenstaffel. |
| WGNK-Aufladung aus Ethereum | 1% | Deckt das Gas des Ethereum-Netzwerks bei der Überweisung nach Gonka. |
| GNK-Auszahlung | 5% | Nur aus dem Dashboard, ab 1 GNK. |
| GNK-Kurs | $0.198 | Nach ihm werden Aufladungen und Dollarpreise berechnet; wird automatisch aktualisiert. |
USDT-Gebührenstaffel#
Der Satz hängt vom Aufladebetrag ab, die Schwelle ist inklusive:
| Aufladebetrag | Gebühr |
|---|---|
| ab $0 | 5% |
| ab $25 | 4.5% |
| ab $50 | 4% |
| ab $100 | 3.5% |
| ab $250 | 3% |
| ab $500 | 2.75% |
| ab $1000 | 2.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.
| Feld | Beschreibung |
|---|---|
balance_ngonka | Guthaben in nGNK — als String, um keine Präzision zu verlieren |
balance_usd | Guthaben in Dollar zum aktuellen Kurs |
cost_per_token_ngonka | Preis eines Eingabe-Tokens des empfohlenen Modells mit Aufschlag, nGNK |
tokens_remaining | Wie viele Eingabe-Tokens das Guthaben zu diesem Preis abdeckt — eine Schätzung |
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 istmonth.- Oder
fromundtoim FormatYYYY-MM-DD, beide zusammen, bis einschließlich 92 Tage — dann enthält die Antwortperiod: custom. tz— Verschiebung in Minuten, wiegetTimezoneOffset()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 -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.fromundto— 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.