Para agentes de IA: guía paso a paso de configuración — /docs/agents.md, índice de documentación — /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. |
| 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 |
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 defectomonth.- O
fromytoen formatoYYYY-MM-DD, ambos a la vez, hasta 92 días inclusive; entonces la respuesta traeperiod: custom. tz— desplazamiento en minutos, comogetTimezoneOffset()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.
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.fromyto— 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. Estas rutas no son para integraciones; algunas responden a la clave API 403 forbidden:
- claves API — 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.