> Para agentes de IA: guia passo a passo de configuração — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), índice da documentação — [`/llms.txt`](https://gate.joingonka.ai/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](https://gate.joingonka.ai/pt/docs/billing#usdt-tiers). |
| 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 |

```bash
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ão `month`.
- Ou `from` e `to` no formato `YYYY-MM-DD`, os dois juntos, até 92 dias inclusive — aí a resposta traz `period: custom`.
- `tz` — deslocamento em minutos, como `getTimezoneOffset()` 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.

```bash
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`.
- `from` e `to` — 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](https://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](https://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.