> Dla agentów AI: instrukcja konfiguracji krok po kroku — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), indeks dokumentacji — [`/llms.txt`](https://gate.joingonka.ai/llms.txt).

# Cennik i konto

Ceny modeli, prowizje za wpłaty i wypłaty, kurs GNK. API konta po kluczu: saldo, wydatki według dni i modeli, historia operacji i wpłat.

## Ceny modeli

Ceny zawierają już narzut platformy 10%. Aktualne wartości — `GET /api/pricing`, bez klucza.

| `model` | Wejście, $ za 1M tokenów | Wyjście, $ za 1M tokenów | nGNK za token: wejście / wyjście |
| --- | ---: | ---: | ---: |
| `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 |

- Koszt żądania = tokeny wejściowe × cena wejścia + tokeny wyjściowe × cena wyjścia. Rozumowanie modelu liczy się jako tokeny wyjściowe.
- Obciążenie — w GNK (1 GNK = 10⁹ `nGNK`); ceny w dolarach — według kursu GNK $0.253.
- Przed żądaniem brama porównuje saldo z wyceną kosztu; jeśli brakuje — `402 insufficient_funds`.
- Po rejestracji na konto trafia 0.1 GNK — około 3M tokenów w cenie wejścia.

## Opłaty

| Operacja | Opłata | Uwaga |
| --- | --- | --- |
| Narzut na żądania do modeli | 10% | Jest już wliczony w ceny powyżej. |
| Doładowanie GNK | bezpłatnie | Przelew na adres bramy z twoim `memo`; zaksięgowanie automatyczne. |
| Doładowanie USDT | 5% → 2.5% | Płatność przez OxaPay; im większa kwota, tym niższa opłata — [Progi opłat USDT](https://gate.joingonka.ai/pl/docs/billing#usdt-tiers). |
| Doładowanie WGNK z Ethereum | 1% | Pokrywa gas sieci Ethereum przy przelewie do Gonka. |
| Wypłata GNK | 5% | Tylko z panelu, od 1 GNK. |
| Kurs GNK | $0.253 | Według niego liczone są doładowania i ceny w dolarach; aktualizowany automatycznie. |

### Progi opłat USDT

Stawka zależy od kwoty doładowania, próg włącznie:

| Kwota doładowania | Opłata |
| --- | ---: |
| od $0 | 5% |
| od $25 | 4.5% |
| od $50 | 4% |
| od $100 | 3.5% |
| od $250 | 3% |
| od $500 | 2.75% |
| od $1000 | 2.5% |

## API konta

Saldo, wydatki i doładowania są dostępne po tym samym kluczu, co żądania do modeli (`Authorization: Bearer jg-…`). Te żądania nie zużywają tokenów.

Błędy: bez klucza — `401 authentication_error`, nieprawidłowe parametry — `400 validation_error`, trasa panelu z kluczem API — `403 forbidden`.

### GET `/api/balance`

Aktualne saldo.

| Pole | Opis |
| --- | --- |
| `balance_ngonka` | Saldo w nGNK — jako string, aby nie tracić precyzji |
| `balance_usd` | Saldo w dolarach według aktualnego kursu |
| `cost_per_token_ngonka` | Cena tokena wejściowego rekomendowanego modelu z narzutem, nGNK |
| `tokens_remaining` | Na ile tokenów wejściowych wystarczy saldo przy tej cenie — szacunek |

```bash
curl -s https://gate.joingonka.ai/api/balance \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"
```

### GET `/api/usage`

Zużycie według dni: zapytania, tokeny, koszt.

- `period` — `day`, `week`, `month`, `quarter`, domyślnie `month`.
- Albo `from` i `to` w formacie `YYYY-MM-DD`, oba naraz, do 92 dni włącznie — wtedy w odpowiedzi `period: custom`.
- `tz` — przesunięcie w minutach, jak `getTimezoneOffset()` w przeglądarce: dla UTC+3 — `-180`. Bez tego — UTC.

Odpowiedź — tablica dni z polami `date, requests, tokens, costNgonka`. Szczegółowe zapisy o zapytaniach są przechowywane 90 dni.

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

### GET `/api/usage/by-model`

Zużycie według modeli: podsumowanie w `models` i szereg „okres × model” w `series` — godziny przy `period=day`, w przeciwnym razie dni. Parametry — jak w `/api/usage`.

### GET `/api/usage/by-key`

Zużycie według kluczy — `keys`. Parametry — jak w `/api/usage`.

### GET `/api/transactions`

Historia operacji: wpłaty, obciążenia za zapytania, bonusy, wypłaty.

- `limit` — do 200, domyślnie 50; `offset` — przesunięcie.
- `type` — filtr: `DEPOSIT_USDT`, `DEPOSIT_GNK`, `DEPOSIT_FIAT`, `INFERENCE`, `REFERRAL_REWARD`, `BONUS`, `WITHDRAWAL`.
- `from` i `to` — daty, koniec włącznie.

Odpowiedź — zapisy z polami `id, type, amountNgonka, feeNgonka, description, createdAt` i łączna liczba `total`. Zapisy `INFERENCE` starsze niż 90 dni są zwijane w jeden na dzień.

### GET `/api/deposits`

Tylko wpłaty. Parametry `limit`, `offset`, `from` i `to` — jak w historii operacji; w odpowiedzi jest `total`.

### POST `/api/deposit/gnk`

Dane do wpłaty GNK: `address` i `memo`. Przelej GNK na ten adres z tym `memo` — zaksięgowanie jest automatyczne.

### GET `/api/deposit/usdt/rate`

Kurs i prowizja wpłaty USDT: `gnk_usd_price`, `fee_percent`, `fee_tiers`.

### POST `/api/deposit/usdt`

Faktura do zapłaty w USDT: treść `{"amount": 25}` — kwota w dolarach od 1 do 10000; w odpowiedzi `payment_url`. Jeśli przyjmowanie USDT jest tymczasowo zamknięte — `503`.

### GET `/api/pricing`

Ceny i prowizje bez klucza: `models[]`, `deposit_usdt_fee_tiers`, kurs GNK i bonus przy rejestracji.

### Tylko w panelu

Zarządzanie kontem — w panelu [gate.joingonka.ai/dashboard](https://gate.joingonka.ai/dashboard). Te trasy nie są do integracji, część z nich odpowiada kluczowi API `403 forbidden`:

- klucze API — [gate.joingonka.ai/keys](https://gate.joingonka.ai/keys);
- wypłata GNK — od 1 GNK;
- wpłata kartą i adresy nadawców WGNK;
- kody promocyjne;
- program poleceń i ustawienia wysyłki.