> Für KI-Agenten: Schritt-für-Schritt-Anleitung zur Einrichtung — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), Dokumentationsindex — [`/llms.txt`](https://gate.joingonka.ai/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](https://gate.joingonka.ai/de/docs/billing#usdt-tiers). |
| 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 |

```bash
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.

```bash
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 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](https://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](https://gate.joingonka.ai/keys);
- GNK-Auszahlung — ab 1 GNK;
- Karten-Einzahlung und Absenderadressen für WGNK;
- Promo-Codes;
- Empfehlungsprogramm und Newsletter-Einstellungen.