Para sa mga AI agent: step-by-step na gabay sa setup — /docs/agents.md, index ng dokumentasyon — /llms.txt.
Mga taripa at account
Mga presyo ng modelo, bayad sa deposito at withdrawal, GNK rate. Account API gamit ang key: balanse, gastos ayon sa araw at modelo, kasaysayan ng transaksyon, at mga top-up.
Mga presyo ng modelo#
Kasama na sa mga presyo ang markup ng platform na 10%. Ang live na halaga — GET /api/pricing, walang key.
model | Input, $ kada 1M tokens | Output, $ kada 1M tokens | nGNK kada token: input / output |
|---|---|---|---|
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 |
- Gastos ng kahilingan = input tokens × presyo ng input + output × presyo ng output. Ang pag-iisip ng modelo ay binibilang bilang output tokens.
- Ang singil ay sa GNK (1 GNK = 10⁹
nGNK); ang mga presyo sa dolyar — ayon sa rate ng GNK na $0.253. - Bago ang kahilingan, tinitingnan ng gateway ang balanse laban sa pagtatantya ng gastos; kung kulang —
402 insufficient_funds. - Pagkatapos ng pagpaparehistro, may pumapasok na 0.1 GNK sa account — mga 3M tokens sa presyo ng input.
Mga komisyon#
| Operasyon | Komisyon | Tandaan |
|---|---|---|
| Markup sa mga kahilingan sa modelo | 10% | Kasama na sa mga presyo sa itaas. |
| Top-up ng GNK | libre | Paglipat sa address ng gateway kasama ang iyong memo; awtomatikong pag-kredito. |
| Top-up ng USDT | 5% → 2.5% | Bayad sa pamamagitan ng OxaPay; mas malaki ang halaga, mas mababa ang komisyon — Hagdan ng komisyon ng USDT. |
| Top-up ng WGNK mula sa Ethereum | 1% | Sinasaklaw ang gas ng Ethereum network kapag naglilipat sa Gonka. |
| Pag-withdraw ng GNK | 5% | Mula sa dashboard lamang, mula 1 GNK. |
| Rate ng GNK | $0.253 | Dito kinakalkula ang mga top-up at presyo sa dolyar; awtomatikong nag-a-update. |
Hagdan ng komisyon ng USDT#
Ang rate ay depende sa halaga ng top-up, kasama ang threshold:
| Halaga ng top-up | Komisyon |
|---|---|
| mula $0 | 5% |
| mula $25 | 4.5% |
| mula $50 | 4% |
| mula $100 | 3.5% |
| mula $250 | 3% |
| mula $500 | 2.75% |
| mula $1000 | 2.5% |
API ng account#
Ang balanse, gastos at top-up ay available gamit ang parehong key na ginagamit sa mga kahilingan sa modelo (Authorization: Bearer jg-…). Ang mga kahilingang ito ay hindi gumagastos ng tokens.
Mga error: walang key — 401 authentication_error, maling parameter — 400 validation_error, dashboard route na may API key — 403 forbidden.
GET /api/balance#
Kasalukuyang balanse.
| Field | Paglalarawan |
|---|---|
balance_ngonka | Balanse sa nGNK — bilang string, para hindi mawala ang precision |
balance_usd | Balanse sa dolyar ayon sa kasalukuyang rate |
cost_per_token_ngonka | Presyo ng input token ng inirerekomendang modelo na may markup, nGNK |
tokens_remaining | Gaano karaming input token ang kayang bayaran ng balanse sa presyong ito — tantya |
curl -s https://gate.joingonka.ai/api/balance \
-H "Authorization: Bearer $JOINGONKA_API_KEY"GET /api/usage#
Gastos kada araw: mga request, token, gastos.
period—day,week,month,quarter, default aymonth.- O kaya
fromattosa format naYYYY-MM-DD, pareho nang sabay, hanggang 92 araw kasama — kung gayon, sa sagot ayperiod: custom. tz— offset sa minuto, tulad nggetTimezoneOffset()sa browser: para sa UTC+3 —-180. Kung wala ito — UTC.
Ang sagot ay array ng mga araw na may mga field na date, requests, tokens, costNgonka. Ang detalyadong talaan ng mga request ay iniimbak nang 90 araw.
curl -s "https://gate.joingonka.ai/api/usage?period=week&tz=-180" \
-H "Authorization: Bearer $JOINGONKA_API_KEY"GET /api/usage/by-model#
Gastos kada modelo: mga kabuuan sa models at seryeng «panahon × modelo» sa series — oras kapag period=day, kung hindi ay araw. Mga parameter — tulad ng sa /api/usage.
GET /api/usage/by-key#
Gastos kada key — keys. Mga parameter — tulad ng sa /api/usage.
GET /api/transactions#
Kasaysayan ng mga operasyon: mga deposito, singil para sa mga request, bonus, pag-withdraw.
limit— hanggang 200, default ay 50;offset— shift.type— filter:DEPOSIT_USDT,DEPOSIT_GNK,DEPOSIT_FIAT,INFERENCE,REFERRAL_REWARD,BONUS,WITHDRAWAL.fromatto— mga petsa, kasama ang dulo.
Ang sagot ay mga talaan na may mga field na id, type, amountNgonka, feeNgonka, description, createdAt at kabuuang bilang na total. Ang mga talaan ng INFERENCE na mas luma sa 90 araw ay pinagsasama-sama sa isa kada araw.
GET /api/deposits#
Mga deposito lamang. Mga parameter na limit, offset, from at to — tulad ng sa kasaysayan ng mga operasyon; may total sa sagot.
POST /api/deposit/gnk#
Mga detalye ng deposito ng GNK: address at memo. Magpadala ng GNK sa address na ito kasama ang memo — awtomatiko ang pag-kredito.
GET /api/deposit/usdt/rate#
Rate at komisyon ng deposito ng USDT: gnk_usd_price, fee_percent, fee_tiers.
POST /api/deposit/usdt#
Invoice para sa pagbabayad sa USDT: katawan {"amount": 25} — halaga sa dolyar mula 1 hanggang 10000; sa sagot ay payment_url. Kung pansamantalang sarado ang pagtanggap ng USDT — 503.
GET /api/pricing#
Mga presyo at komisyon nang walang key: models[], deposit_usdt_fee_tiers, rate ng GNK at bonus sa pagpaparehistro.
Sa cabinet lamang#
Ang pamamahala ng account ay nasa cabinet na gate.joingonka.ai/dashboard. Ang mga rutang ito ay hindi para sa mga integrasyon, ang ilan sa kanila ay tumutugon sa API key na 403 forbidden:
- mga API key — gate.joingonka.ai/keys;
- pag-withdraw ng GNK — mula 1 GNK;
- pagdeposito gamit ang card at mga address ng nagpadala ng WGNK;
- mga promo code;
- referral program at mga setting ng newsletter.