Dla agentów AI: instrukcja konfiguracji krok po kroku — /docs/agents.md, indeks dokumentacji — /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. |
| 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 |
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ślniemonth.- Albo
fromitow formacieYYYY-MM-DD, oba naraz, do 92 dni włącznie — wtedy w odpowiedziperiod: custom. tz— przesunięcie w minutach, jakgetTimezoneOffset()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.
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.fromito— 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. Te trasy nie są do integracji, część z nich odpowiada kluczowi API 403 forbidden:
- klucze API — 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.