Para agentes de IA: guia passo a passo de configuração — /docs/agents.md, índice da documentação — /llms.txt.
Preços e conta
Preços dos modelos, taxas de depósito e saque, cotação do GNK. API da conta por chave: saldo, gasto por dia e por modelo, histórico de operações e depósitos.
Preços dos modelos#
Os preços já incluem a margem da plataforma 10%. Os valores ao vivo estão em GET /api/pricing, sem chave.
model | Entrada, $ por 1M de tokens | Saída, $ por 1M de tokens | nGNK por token: entrada / saída |
|---|---|---|---|
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 |
- Custo da requisição = tokens de entrada × preço de entrada + tokens de saída × preço de saída. O raciocínio do modelo conta como tokens de saída.
- A cobrança é em GNK (1 GNK = 10⁹
nGNK); os preços em dólares seguem a cotação do GNK $0.253. - Antes da requisição, o gateway confere o saldo com a estimativa de custo; se não cobrir —
402 insufficient_funds. - Após o cadastro, você recebe 0.1 GNK na conta — cerca de 3M tokens ao preço de entrada.
Taxas#
| Operação | Taxa | Observação |
|---|---|---|
| Margem sobre as requisições aos modelos | 10% | Já está incluída nos preços acima. |
| Recarga de GNK | grátis | Transferência para o endereço do gateway com o seu memo; o crédito é automático. |
| Recarga de USDT | 5% → 2.5% | Pagamento via OxaPay; quanto maior o valor, menor a taxa — Escala de taxas do USDT. |
| Recarga de WGNK a partir do Ethereum | 1% | Cobre o gas da rede Ethereum ao transferir para a Gonka. |
| Saque de GNK | 5% | Somente pelo painel, a partir de 1 GNK. |
| Cotação do GNK | $0.253 | É por ela que se calculam as recargas e os preços em dólares; atualiza automaticamente. |
Escala de taxas do USDT#
A alíquota depende do valor da recarga, com o limite incluído:
| Valor da recarga | Taxa |
|---|---|
| a partir de $0 | 5% |
| a partir de $25 | 4.5% |
| a partir de $50 | 4% |
| a partir de $100 | 3.5% |
| a partir de $250 | 3% |
| a partir de $500 | 2.75% |
| a partir de $1000 | 2.5% |
API da conta#
Saldo, gasto e recargas ficam disponíveis com a mesma chave que você usa nas requisições aos modelos (Authorization: Bearer jg-…). Essas requisições não consomem tokens.
Erros: sem chave — 401 authentication_error, parâmetros inválidos — 400 validation_error, rota do painel com API key — 403 forbidden.
GET /api/balance#
Saldo atual.
| Campo | Descrição |
|---|---|
balance_ngonka | Saldo em nGNK — como string, para não perder precisão |
balance_usd | Saldo em dólares pela cotação atual |
cost_per_token_ngonka | Preço do token de entrada do modelo recomendado com margem, nGNK |
tokens_remaining | Para quantos tokens de entrada o saldo dá nesse preço — estimativa |
curl -s https://gate.joingonka.ai/api/balance \
-H "Authorization: Bearer $JOINGONKA_API_KEY"GET /api/usage#
Consumo por dia: requisições, tokens, custo.
period—day,week,month,quarter, por padrãomonth.- Ou
frometono formatoYYYY-MM-DD, os dois juntos, até 92 dias inclusive — aí a resposta trazperiod: custom. tz— deslocamento em minutos, comogetTimezoneOffset()no navegador: para UTC+3,-180. Sem ele, UTC.
A resposta é um array de dias com os campos date, requests, tokens, costNgonka. Os registros detalhados de requisições ficam armazenados por 90 dias.
curl -s "https://gate.joingonka.ai/api/usage?period=week&tz=-180" \
-H "Authorization: Bearer $JOINGONKA_API_KEY"GET /api/usage/by-model#
Consumo por modelo: totais em models e uma série «período × modelo» em series — horas quando period=day, senão dias. Os parâmetros são como em /api/usage.
GET /api/usage/by-key#
Consumo por chave — keys. Os parâmetros são como em /api/usage.
GET /api/transactions#
Histórico de operações: recargas, cobranças por requisições, bônus, saques.
limit— até 200, por padrão 50;offset— deslocamento.type— filtro:DEPOSIT_USDT,DEPOSIT_GNK,DEPOSIT_FIAT,INFERENCE,REFERRAL_REWARD,BONUS,WITHDRAWAL.frometo— datas, fim inclusive.
A resposta são registros com os campos id, type, amountNgonka, feeNgonka, description, createdAt e o total total. Os registros INFERENCE com mais de 90 dias são agrupados em um por dia.
GET /api/deposits#
Apenas recargas. Os parâmetros limit, offset, from e to são como no histórico de operações; a resposta inclui total.
POST /api/deposit/gnk#
Dados para recarga de GNK: address e memo. Envie GNK para esse endereço com esse memo — o crédito é automático.
GET /api/deposit/usdt/rate#
Cotação e taxa de recarga em USDT: gnk_usd_price, fee_percent, fee_tiers.
POST /api/deposit/usdt#
Fatura de pagamento em USDT: o corpo {"amount": 25} — valor em dólares de 1 a 10000; a resposta traz payment_url. Se o recebimento de USDT estiver temporariamente fechado — 503.
GET /api/pricing#
Preços e taxas sem chave: models[], deposit_usdt_fee_tiers, cotação do GNK e bônus de cadastro.
Somente no painel#
O gerenciamento da conta fica no painel gate.joingonka.ai/dashboard. Essas rotas não são para integrações; algumas respondem à chave de API 403 forbidden:
- chaves de API — gate.joingonka.ai/keys;
- saque de GNK — a partir de 1 GNK;
- recarga com cartão e endereços de remetentes de WGNK;
- cupons promocionais;
- programa de indicação e configurações de envios.