Yapay zeka ajanları için: adım adım kurulum kılavuzu — /docs/agents.md, dokümantasyon dizini — /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. |
| 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 |
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ılanmonth.- Veya
fromveto,YYYY-MM-DDbiçiminde, ikisi birlikte, 92 güne kadar dahil — o zaman yanıttaperiod: customgelir. tz— dakika cinsinden kayma, tarayıcıdakigetTimezoneOffset()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.
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.fromveto— 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 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;
- GNK çekimi — 1 GNK'den itibaren;
- kartla yatırma ve WGNK gönderici adresleri;
- promosyon kodları;
- referans programı ve bülten ayarları.