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 |
|---|---|---|---|
MiniMaxAI/MiniMax-M2.7 | $0.008349 | $0.02505 | 33 / 99 |
deepseek-ai/DeepSeek-V4-Flash-0731 | $0.008349 | $0.02505 | 33 / 99 |
zai-org/GLM-5.3-Flash | $0.008349 | $0.02505 | 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.253. - 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.253 | 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 Einträge mit den Feldern id, type, amountNgonka, feeNgonka, description, createdAt und die Gesamtzahl total. Einträge zu INFERENCE, 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.