> Yapay zeka ajanları için: adım adım kurulum kılavuzu — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), dokümantasyon dizini — [`/llms.txt`](https://gate.joingonka.ai/llms.txt).

# Tarifeler ve hesap

Model fiyatları, para yatırma ve çekme komisyonları, GNK kuru. Anahtarla hesap API'si: bakiye, güne ve modele göre harcama, işlem geçmişi ve para yüklemeleri.

## Model fiyatları

Fiyatlar platformun 10% marjını zaten içerir. Canlı değerler — `GET /api/pricing`, anahtarsız.

| `model` | Giriş, 1M token başına $ | Çıkış, 1M token başına $ | Token başına nGNK: giriş / çıkış |
| --- | ---: | ---: | ---: |
| `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 |

- İstek maliyeti = giriş tokenları × giriş fiyatı + çıkış tokenları × çıkış fiyatı. Modelin akıl yürütmesi çıkış tokenı olarak sayılır.
- Ücretlendirme GNK ile yapılır (1 GNK = 10⁹ `nGNK`); dolar fiyatları — GNK kuru $0.253 üzerinden.
- İstekten önce gateway, bakiyeyi maliyet tahminiyle karşılaştırır; yetmezse — `402 insufficient_funds`.
- Kayıttan sonra hesaba 0.1 GNK gelir — giriş fiyatından yaklaşık 3M token.

## Komisyonlar

| İşlem | Komisyon | Not |
| --- | --- | --- |
| Model isteklerine marj | 10% | Yukarıdaki fiyatlara zaten dahildir. |
| GNK yükleme | ücretsiz | `memo` ile gateway adresine transfer; kredi otomatik yüklenir. |
| USDT yükleme | 5% → 2.5% | OxaPay üzerinden ödeme; tutar arttıkça komisyon düşer — [USDT komisyon kademeleri](https://gate.joingonka.ai/tr/docs/billing#usdt-tiers). |
| Ethereum'dan WGNK yükleme | 1% | Gonka'ya transfer sırasında Ethereum ağının gazını karşılar. |
| GNK çekimi | 5% | Yalnızca panelden, 1 GNK'dan itibaren. |
| GNK kuru | $0.253 | Yüklemeler ve dolar fiyatları buna göre hesaplanır; otomatik güncellenir. |

### USDT komisyon kademeleri

Oran, yükleme tutarına bağlıdır, eşik dahil:

| Yükleme tutarı | Komisyon |
| --- | ---: |
| $0 itibarıyla | 5% |
| $25 itibarıyla | 4.5% |
| $50 itibarıyla | 4% |
| $100 itibarıyla | 3.5% |
| $250 itibarıyla | 3% |
| $500 itibarıyla | 2.75% |
| $1000 itibarıyla | 2.5% |

## Hesap API'si

Bakiye, harcama ve yüklemeler, model istekleriyle aynı anahtar üzerinden kullanılabilir (`Authorization: Bearer jg-…`). Bu istekler token harcamaz.

Hatalar: anahtarsız — `401 authentication_error`, geçersiz parametreler — `400 validation_error`, API anahtarıyla panel rotası — `403 forbidden`.

### GET `/api/balance`

Güncel bakiye.

| Alan | Açıklama |
| --- | --- |
| `balance_ngonka` | nGNK cinsinden bakiye — hassasiyeti kaybetmemek için dize olarak |
| `balance_usd` | Güncel kura göre dolar cinsinden bakiye |
| `cost_per_token_ngonka` | Önerilen modelin giriş tokenı fiyatı, marj dahil, nGNK |
| `tokens_remaining` | Bu fiyattan bakiyenin kaç giriş tokenına yeteceği — bir tahmin |

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

### GET `/api/usage`

Günlük harcama: istekler, tokenlar, maliyet.

- `period` — `day`, `week`, `month`, `quarter`, varsayılan `month`.
- Veya `from` ve `to`, `YYYY-MM-DD` biçiminde, ikisi birlikte, 92 güne kadar dahil — o zaman yanıtta `period: custom` gelir.
- `tz` — dakika cinsinden kayma, tarayıcıdaki `getTimezoneOffset()` gibi: UTC+3 için — `-180`. Verilmezse — UTC.

Yanıt, `date, requests, tokens, costNgonka` alanlarına sahip günlerden oluşan bir dizidir. Ayrıntılı istek kayıtları 90 gün saklanır.

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

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

Modellere göre harcama: `models` içinde toplamlar ve `series` içinde "dönem × model" serisi — `period=day` olduğunda saatlik, aksi halde günlük. Parametreler `/api/usage` ile aynı.

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

Anahtarlara göre harcama — `keys`. Parametreler `/api/usage` ile aynı.

### GET `/api/transactions`

İşlem geçmişi: yatırımlar, istekler için kesintiler, bonuslar, çekimler.

- `limit` — 200 değerine kadar, varsayılan 50; `offset` — kaydırma.
- `type` — filtre: `DEPOSIT_USDT`, `DEPOSIT_GNK`, `DEPOSIT_FIAT`, `INFERENCE`, `REFERRAL_REWARD`, `BONUS`, `WITHDRAWAL`.
- `from` ve `to` — tarihler, bitiş dahil.

Yanıt, `id, type, amountNgonka, feeNgonka, description, createdAt` alanlarına sahip kayıtlar ve toplam sayı `total`. `INFERENCE` kayıtları 90 günden eskiyse gün başına bir kayda indirgenir.

### GET `/api/deposits`

Yalnızca yatırımlar. Parametreler `limit`, `offset`, `from` ve `to` — işlem geçmişindeki gibi; yanıtta `total` bulunur.

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

GNK yatırma bilgileri: `address` ve `memo`. GNK'yı bu `memo` ile bu adrese gönderin — hesaba geçiş otomatiktir.

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

USDT yatırma kuru ve komisyonu: `gnk_usd_price`, `fee_percent`, `fee_tiers`.

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

USDT ödeme faturası: gövde `{"amount": 25}` — 1 ile 10000 arasında dolar cinsinden tutar; yanıtta `payment_url`. USDT kabulü geçici olarak kapalıysa — `503`.

### GET `/api/pricing`

Anahtarsız fiyatlar ve komisyonlar: `models[]`, `deposit_usdt_fee_tiers`, GNK kuru ve kayıt bonusu.

### Yalnızca panelde

Hesap yönetimi — [gate.joingonka.ai/dashboard](https://gate.joingonka.ai/dashboard) panelinde. Bu rotalar entegrasyonlar için değildir, bir kısmı API anahtarına `403 forbidden` yanıtı verir:

- API anahtarları — [gate.joingonka.ai/keys](https://gate.joingonka.ai/keys);
- GNK çekimi — 1 GNK'den itibaren;
- kartla yatırma ve WGNK gönderici adresleri;
- promosyon kodları;
- referans programı ve bülten ayarları.