Documentación
Precios, saldo y quota en la documentación de NexoRouter.
Precios, saldo y quota
NexoRouter usa saldo prepago y facturación por uso. Primero agregas saldo; después los requests de API consumen quota según el uso del modelo.
La captura de Billing usa datos demo desidentificados. Tu saldo, quota, transacciones y recibos reales serán diferentes.
Conceptos principales
| Concepto | Significado |
|---|---|
| Saldo prepago | Saldo de cuenta compartido por API keys. |
| Quota | Unidad interna de uso. 1 USD = 500000 quota. |
| Presupuesto de API key | Límite opcional para una key. |
| Alcance de modelos | Lista opcional de modelos que una key puede llamar. |
| Usage Logs | Registros de request con modelo, key, tokens, costo, latencia, estado y request ID. |
| Billing | Área del Dashboard para saldo, top-ups y pagos recientes. |
Opciones de top-up
El Dashboard ofrece paquetes estándar:
| Paquete | USD | Quota agregada |
|---|---|---|
| Starter | $5 | 2500000 |
| Growth | $20 | 10000000 |
| Scale | $100 | 50000000 |
| Enterprise | $500 | 250000000 |
También hay top-ups personalizados de $5 a $10000, redondeados a centavos.
El monto que eliges es el crédito API que se agrega a tu saldo. Stripe Checkout
muestra por separado una tarifa de servicio del 5.5 %, con un mínimo de
$0.80. Por ejemplo, una compra de $20 en crédito API tiene un subtotal de
$21.10 antes de impuestos aplicables. La tarifa de servicio no es
reembolsable. Los impuestos aplicables, si los hubiera, se muestran por
separado en el checkout.
Cómo se cobra un request
La mayoría de requests de chat usan:
- input tokens;
- output tokens.
Cada modelo tiene su propio precio de input y output. El cargo real aparece en Usage Logs como USD y quota.
Balance y presupuestos por key
El saldo del workspace se comparte, pero los key budgets limitan riesgo.
Configuración recomendada:
| Key | Budget | Scope |
|---|---|---|
local-dev | $5 | Todos los chat models o un modelo de bajo costo |
staging | $20 | Modelos usados por staging |
production | Presupuesto personalizado o workspace balance | Solo modelos que la app usa |
Saldo insuficiente
insufficient_quota significa que el workspace balance o el presupuesto de esa key no alcanza para el request.
Solución:
- Abre Billing y revisa saldo actual.
- Abre Usage Logs y revisa gasto reciente.
- Agrega saldo o crea una key nueva con el presupuesto correcto.
- Reintenta.
Control de costos
- Crea keys separadas para dev, staging y production.
- Usa presupuestos estrictos en experimentos y herramientas externas.
- Empieza con modelos de menor costo durante pruebas de integración.
- Configura
max_tokensdurante desarrollo. - Evita reintentos automáticos infinitos.
- Para modelos lentos, sube el timeout del cliente en vez de cancelar y reintentar rápidamente.
Límites de pago
El soporte de pago sigue las rutas disponibles en el Dashboard:
- Los top-ups se hacen desde Billing.
- Stripe Checkout es la ruta de checkout online soportada.
- El crédito y la tarifa de servicio aparecen como conceptos separados. Solo el crédito se agrega al saldo de NexoRouter.
- El saldo se acredita después de procesar la confirmación firmada del pago.
- Los pagos de Stripe completados y elegibles muestran Abrir recibo en Billing. NexoRouter valida la sesión y abre el recibo alojado por Stripe; el dashboard no muestra identificadores internos del pago.
- Los reembolsos, disputas y créditos manuales requieren revisión humana. El reembolso del crédito revierte la quota correspondiente; la tarifa de servicio de compra de créditos no es reembolsable.
El recibo alojado por Stripe confirma el pago, pero no se convierte automáticamente en una factura fiscal local. Contacta soporte antes de pagar si tu organización necesita campos fiscales o de factura específicos.