> Para agentes de IA: guía paso a paso de configuración — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), índice de documentación — [`/llms.txt`](https://gate.joingonka.ai/llms.txt).

# Precios y cuenta

Precios de los modelos, comisiones de ingreso y retiro, tipo de cambio de GNK. API de cuenta por clave: saldo, gasto por día y por modelo, historial de operaciones y recargas.

## Precios de los modelos

Los precios ya incluyen el margen de la plataforma 10%. Los valores en vivo están en `GET /api/pricing`, sin clave.

| `model` | Entrada, $ por 1M de tokens | Salida, $ por 1M de tokens | nGNK por token: entrada / salida |
| --- | ---: | ---: | ---: |
| `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 |

- Costo de la solicitud = tokens de entrada × precio de entrada + tokens de salida × precio de salida. El razonamiento del modelo se cuenta como tokens de salida.
- El cobro es en GNK (1 GNK = 10⁹ `nGNK`); los precios en dólares se calculan según la cotización de GNK $0.253.
- Antes de la solicitud, el gateway compara el saldo con la estimación de costo; si no alcanza — `402 insufficient_funds`.
- Tras registrarte recibes 0.1 GNK en la cuenta — unos 3M tokens al precio de entrada.

## Comisiones

| Operación | Comisión | Nota |
| --- | --- | --- |
| Margen sobre las solicitudes a los modelos | 10% | Ya está incluido en los precios de arriba. |
| Recarga de GNK | gratis | Transferencia a la dirección del gateway con tu `memo`; la acreditación es automática. |
| Recarga de USDT | 5% → 2.5% | Pago vía OxaPay; cuanto mayor el monto, menor la comisión — [Escala de comisiones de USDT](https://gate.joingonka.ai/es/docs/billing#usdt-tiers). |
| Recarga de WGNK desde Ethereum | 1% | Cubre el gas de la red Ethereum al transferir a Gonka. |
| Retiro de GNK | 5% | Solo desde el panel, a partir de 1 GNK. |
| Cotización de GNK | $0.253 | Con ella se calculan las recargas y los precios en dólares; se actualiza automáticamente. |

### Escala de comisiones de USDT

La tasa depende del monto de la recarga, con el umbral incluido:

| Monto de la recarga | Comisión |
| --- | ---: |
| desde $0 | 5% |
| desde $25 | 4.5% |
| desde $50 | 4% |
| desde $100 | 3.5% |
| desde $250 | 3% |
| desde $500 | 2.75% |
| desde $1000 | 2.5% |

## API de cuenta

El saldo, el gasto y las recargas están disponibles con la misma clave que usas para las solicitudes a los modelos (`Authorization: Bearer jg-…`). Estas solicitudes no consumen tokens.

Errores: sin clave — `401 authentication_error`, parámetros inválidos — `400 validation_error`, ruta del panel con API key — `403 forbidden`.

### GET `/api/balance`

Saldo actual.

| Campo | Descripción |
| --- | --- |
| `balance_ngonka` | Saldo en nGNK — como string, para no perder precisión |
| `balance_usd` | Saldo en dólares según la cotización actual |
| `cost_per_token_ngonka` | Precio del token de entrada del modelo recomendado con margen, nGNK |
| `tokens_remaining` | Para cuántos tokens de entrada alcanza el saldo a este precio: estimación |

```bash
curl -s https://gate.joingonka.ai/api/balance \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"
```

### GET `/api/usage`

Consumo por día: solicitudes, tokens, costo.

- `period` — `day`, `week`, `month`, `quarter`, por defecto `month`.
- O `from` y `to` en formato `YYYY-MM-DD`, ambos a la vez, hasta 92 días inclusive; entonces la respuesta trae `period: custom`.
- `tz` — desplazamiento en minutos, como `getTimezoneOffset()` en el navegador: para UTC+3 es `-180`. Sin él, UTC.

La respuesta es un arreglo de días con los campos `date, requests, tokens, costNgonka`. Los registros detallados de solicitudes se conservan 90 días.

```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: totales en `models` y una serie «periodo × modelo» en `series` — horas si `period=day`, si no, días. Los parámetros son como en `/api/usage`.

### GET `/api/usage/by-key`

Consumo por clave: `keys`. Los parámetros son como en `/api/usage`.

### GET `/api/transactions`

Historial de operaciones: recargas, cargos por solicitudes, bonos, retiros.

- `limit` — hasta 200, por defecto 50; `offset` — desplazamiento.
- `type` — filtro: `DEPOSIT_USDT`, `DEPOSIT_GNK`, `DEPOSIT_FIAT`, `INFERENCE`, `REFERRAL_REWARD`, `BONUS`, `WITHDRAWAL`.
- `from` y `to` — fechas, extremo final inclusive.

La respuesta son registros con los campos `id, type, amountNgonka, feeNgonka, description, createdAt` y el total `total`. Los registros `INFERENCE` de más de 90 días se agrupan en uno por día.

### GET `/api/deposits`

Solo recargas. Los parámetros `limit`, `offset`, `from` y `to` son como en el historial de operaciones; la respuesta incluye `total`.

### POST `/api/deposit/gnk`

Datos para recargar GNK: `address` y `memo`. Transfiere GNK a esta dirección con este `memo`: la acreditación es automática.

### GET `/api/deposit/usdt/rate`

Tipo de cambio y comisión de recarga en USDT: `gnk_usd_price`, `fee_percent`, `fee_tiers`.

### POST `/api/deposit/usdt`

Factura de pago en USDT: el cuerpo `{"amount": 25}` — importe en dólares de 1 a 10000; la respuesta trae `payment_url`. Si la recepción de USDT está cerrada temporalmente: `503`.

### GET `/api/pricing`

Precios y comisiones sin clave: `models[]`, `deposit_usdt_fee_tiers`, tipo de cambio de GNK y bono de registro.

### Solo en el panel

La gestión de la cuenta se hace en el panel [gate.joingonka.ai/dashboard](https://gate.joingonka.ai/dashboard). Estas rutas no son para integraciones; algunas responden a la clave API `403 forbidden`:

- claves API — [gate.joingonka.ai/keys](https://gate.joingonka.ai/keys);
- retiro de GNK — desde 1 GNK;
- recarga con tarjeta y direcciones de remitentes de WGNK;
- códigos promocionales;
- programa de referidos y configuración de envíos.