Documentación

Facturación

Pago por uso con una cartera prepagada. Cada llamada se mide con precisión de microcentavo y se registra en un libro mayor inmutable. Sin suscripción ni compromiso; el saldo no caduca.

Recarga mediante Stripe → el saldo queda en tu cartera → el coste de cada llamada a la API se descuenta en tiempo real. Si el saldo llega a cero, las llamadas devuelven 402 insufficient_quota hasta que vuelvas a recargar.

Modelo de precios

Para cada llamada, Kunavo calcula el coste del usuario como el mayor de estos dos importes:

user_cost = max(catalog_cost, upstream_cost × markup_factor)

Coste de catálogo: el precio mostrado en la ficha del modelo (por 1M de tokens, por imagen, por segundo de vídeo, etc.) multiplicado por las unidades de uso reales.
Coste del proveedor: lo que el proveedor cobró a Kunavo por esa llamada concreta, expresado en créditos, donde 1 crédito = $0.005.
Factor de recargo: normalmente 1.5 (un recargo del 50% sobre el coste del proveedor). Para algunos modelos de proveedores chinos cuyo precio mayorista se aproxima más a la tarifa oficial del proveedor, el factor se reduce a 1.2 para mantener nuestros precios por debajo de la tarifa oficial.

La función max() garantiza que: (a) nunca pagues menos que el precio de catálogo anunciado y (b) no perdamos dinero en una llamada si el coste del proveedor aumenta inesperadamente.

Unidades de facturación por modalidad

Modalidad	Unidad	Granularidad
Chat	por 1M de tokens de entrada + por 1M de tokens de salida	Facturación exacta por token; los tokens de razonamiento se facturan a la tarifa de salida.
Imagen (t2i / edición)	por imagen	Por imagen generada; las generaciones parciales no se cobran.
Vídeo	por vídeo	Precio fijo por clip, según el nivel de resolución.

Los prompts largos se facturan con la tarifa del proveedor para contextos largos. En GPT-5.5, GPT-5.6 Sol y Terra, y GPT-6 Astra, un prompt con más de 272K tokens de entrada se factura íntegramente a la tarifa de entrada 2×, incluidas las lecturas y escrituras de caché, y a la tarifa de salida 1.5× que publica OpenAI. Claude no aplica recargo por contexto largo: su contexto de 1M se factura a la tarifa estándar.

Tokens en caché

Los modelos de chat almacenan en caché los prefijos estables de los prompts. Las lecturas de caché se facturan muy por debajo de la tarifa de entrada normal: 0.10× tanto en Claude como en OpenAI, y 0.025× on Claude Fable 5.1, 0.05× on Claude Opus 5.5. Las escrituras de caché se facturan a 1.25× la tarifa de entrada en todos los modelos Claude, incluidas las escrituras con TTL de 1 hora (por debajo de 2× de Anthropic), y en GPT-5.6 Sol, Terra y Luna, y GPT-6 Astra; en los demás modelos se facturan a la tarifa de entrada normal. Cada categoría aplica el descuento propio del modelo, por lo que los precios de caché reciben el mismo descuento respecto a la lista del proveedor que sus precios de entrada y salida. El importe mínimo max() anterior se calcula teniendo en cuenta la caché, de modo que el descuento te llega a ti en lugar de quedar neutralizado por el precio de catálogo.

Consulta la guía de almacenamiento en caché de prompts para ver la tabla completa de precios, cómo habilitar cache_control y cómo el enrutamiento por afinidad de Kunavo mantiene activa la caché.

Precisión

Todos los importes de Kunavo se almacenan en micro_cents:

1 USD = 100,000,000 micro_cents
1 cent = 1,000,000 micro_cents
Cargo mínimo representable: 0.0001 cent ($0.000001). Muchas llamadas de chat habituales se facturan con este importe mínimo.

Para importes pequeños, el panel de control redondea a 6 decimales en USD; al superar un centavo, redondea a 2. La contabilidad interna es exacta.

Recarga

Recarga tu saldo en /app/billing mediante Stripe Checkout: tarjetas (Visa, Mastercard, Amex, JCB, UnionPay) donde Stripe esté disponible, y Apple Pay, Google Pay y Link en todos los lugares excepto India. Los métodos sujetos al país aparecen para el mercado del comprador: en Estados Unidos, Cash App Pay, Klarna, Afterpay, débito bancario ACH (se liquida en 3–5 días laborables) y criptomonedas (stablecoins), además de Affirm en recargas de $100 o más y Zip en recargas de $100 a $1,500; Alipay y WeChat Pay en China continental; KakaoPay, Naver Pay, PAYCO, Samsung Pay y tarjetas nacionales coreanas en Corea del Sur; UPI en India; Pix en Brasil; iDEAL en Países Bajos, Bancontact en Bélgica, EPS en Austria, MB WAY en Portugal y Satispay en Italia; BLIK en Polonia; Bacs Direct Debit en el Reino Unido; y Pay by Bank para compradores del Reino Unido, Irlanda y Finlandia.

Las recargas se expresan en USD y Stripe realiza la conversión. La página de pago muestra el importe en tu propia moneda y lo liquida en ella; así Pix se cobra en reales y BLIK en zlotys frente a un precio en dólares. El tipo de cambio de Stripe incluye una comisión del 2–4 % que paga el comprador (documentación de Adaptive Pricing de Stripe, consultada el 2026-10-03); pagar en USD la evita, pero los métodos locales requieren la moneda local. Esto no incluye SEPA Direct Debit: no está entre los métodos habilitados en nuestra cuenta, por lo que nunca aparece y ninguna configuración de moneda lo cambia. Cualquier tarjeta emitida en países SEPA funciona con normalidad, incluida una tarjeta de débito vinculada a una cuenta SEPA.

Precios por niveles

Recarga	Ventajas incluidas	Bono
$10	$10.00	—
$100	$110.00	+$10 (10%)
$1,000	$1,200.00	+$200 (20%)
$5,000	$6,250.00	+$1,250 (25%)

El saldo no caduca. Recarga una vez y úsalo durante meses. También puedes establecer un límite de gasto mensual por clave de API desde /app/keys para fijar un tope estricto a una carga de trabajo individual: cuando el gasto de esa clave durante el mes natural vaya a superar el importe que hayas establecido, sus llamadas se rechazarán con un 402 insufficient_quota y no se cobrará nada. Las demás claves seguirán funcionando. En la misma pantalla puedes configurar una lista de IP permitidas por clave; las llamadas desde cualquier otra dirección recibirán un 403.

Recarga automática

Opcional. Guarda una tarjeta una vez en /app/billing y configura tres cifras: el saldo por debajo del cual se activa la recarga, el importe que se añade cada vez y un límite mensual. A partir de entonces, la cartera se recarga automáticamente, en segundos tras una liquidación que reduzca el saldo por debajo del umbral y, si entretanto se rechaza una solicitud por falta de saldo, antes de responderla. Así, un agente sin supervisión no se detiene por un 402.

Configuración	Intervalo	Notas
Activar por debajo de	$5 – $1,000	Configúralo por encima del importe de tu solicitud individual más grande.
Importe de cada recarga	$10–$1,000, en dólares enteros	$100 y $1,000 reciben la misma bonificación que una recarga manual; los demás importes no reciben ninguna.
Límite mensual	importe–$20,000	Cuenta lo que se te cobra en cada mes natural; no incluye bonificaciones.

Tarjetas o Link. Alipay, WeChat Pay, Pix y los demás métodos locales y bancarios no se pueden cobrar automáticamente, por lo que la recarga automática necesita una tarjeta —o una cuenta Link que tenga una— aunque normalmente pagues con ellos. Se permiten como máximo cinco cargos al día; tres rechazos consecutivos la pausan y te envían un correo; retirar la tarjeta, una disputa o un bloqueo por fraude la detiene inmediatamente. Cada cargo envía un recibo y el extracto muestra KUNAVO* AUTOTOPUP.

Mientras se procesa una recarga, una solicitud rechazada devuelve 402 con Retry-After: 3; los demás rechazos indican qué hacer a continuación. Puedes desactivarla o cambiar las cifras en cualquier momento desde la misma página.

Plazos de los webhooks

Tras completar Stripe Checkout, el saldo se actualiza mediante un webhook, que suele activarse entre 5 y 10 segundos después de la confirmación del pago. Los pagos con tarjeta son casi instantáneos; un método que solo confirme de forma asíncrona puede tardar días en liquidarse. Esos pedidos aparecen como processing hasta que llegan los fondos; entonces, el webhook de liquidación abona el saldo en la cartera. No tienes que volver a pagar y nada caduca mientras tanto. Un pedido que nunca se completa aparece como pending y nuestro proceso de limpieza lo etiqueta como expired después de 24 horas. Esa etiqueta es solo visual y no cancela nada.

Libro mayor de créditos

Cada cambio de saldo se registra en un libro mayor de solo anexado:

Tipo	Dirección	Cuándo
topup	crédito (+)	Pago de Stripe confirmado.
consume	débito (−)	Llamada a la API facturada al completarse.
refund	crédito (+)	Reembolso de Stripe o crédito manual del administrador.
manual_adjust	crédito (+/−)	Corrección del operador (por ejemplo, reembolso por un incidente).

Cada fila registra balance_after_micro_cents, lo que te permite ver el saldo después de cada evento. Consulta el historial completo en /app/billing.

Registros de uso

Cada llamada a la API genera una fila en usage_logs:

Modelo, estado (correcto / error), código de estado HTTP
Tokens de entrada / salida, tokens almacenados en caché + tokens de escritura en caché, cantidad de imágenes, segundos, caracteres
upstream_cost_micro_cents — lo que Kunavo pagó al proveedor upstream
cost_micro_cents — lo que pagaste (después del margen)
Latencia, IP de la solicitud, agente de usuario, prefijo de la clave de API

Visible en /app/usage con filtros y páginas de detalles por llamada.

Llamadas fallidas: ¿tienen algún costo?

No. Kunavo solo cobra por status = success. Si el proveedor upstream devuelve un error 4xx / 5xx o nuestra tarea agota el tiempo de espera, la llamada queda registrada, pero el costo es $0. Asumimos nosotros el costo del proveedor upstream en lugar de trasladártelo.

Reembolsos

Los reembolsos se evalúan caso por caso a través de support@kunavo.com. Estos son algunos casos habituales en los que reembolsamos:

Una interrupción del servicio por parte de Kunavo que te hizo perder saldo.
Errores de precios que dieron lugar a cobros excesivos respecto al catálogo mostrado.
Una recarga duplicada por accidente a través de Stripe.

De forma predeterminada, los reembolsos se emiten como crédito en tu monedero; también puedes solicitar reembolsos a tu cuenta bancaria a través de Stripe.