Preguntas frecuentes
Facturación y créditos
Cómo se cobran los créditos de servicio, cuándo recargar y qué significa una respuesta 402.
El uso de la API en Felo API Platform es prepago. Compras créditos de servicio expresados en USD y cada solicitud se descuenta de ese saldo según la tarifa aplicable.
Cómo funciona la facturación
- Una recarga compra créditos de servicio, no un saldo en efectivo custodiado por la plataforma.
- Los créditos están expresados en USD para que los cargos puedan mostrarse en dólares.
- Las recargas empiezan en $1. No se requiere suscripción.
- Los créditos se usan únicamente para compensar los cargos de la API de la plataforma. No se pueden retirar ni canjear por efectivo.
- Las recargas completadas no son reembolsables, incluidos los créditos no utilizados, salvo cuando la ley aplicable de carácter obligatorio disponga lo contrario.
El mismo saldo de créditos paga las llamadas a modelos, las llamadas a la Data API y las llamadas a las API de Felo. No necesitas una cuenta o un saldo independiente para cada proveedor.
Cuánto cuesta una solicitud
El cargo depende del endpoint:
| Superficie | Base de facturación |
|---|---|
| Model API | Tarifas por token de entrada, salida y caché, más las herramientas facturables que correspondan; se aplica el multiplicador de descuento del canal |
| Data API | La base de facturación publicada para ese endpoint, que puede ser por solicitud correcta, por elemento devuelto o según el uso real |
API de Felo (/v2) | La tarifa de la salida de ese flujo de trabajo |
Los precios de los modelos se muestran por 1 M de tokens en la página de precios y en la página de cada modelo. Consulta Modelos y precios para ver la fórmula y un ejemplo de cálculo.
Consulta tu saldo y recarga
Abre Facturación de la consola. La consola muestra tu saldo actual de créditos, los importes de recarga y los registros de uso. Los métodos de pago disponibles dependen de tu región y se muestran al finalizar la compra.
La respuesta 402
Un 402 significa que el saldo no cubre la llamada:
{
"status": 402,
"code": "INSUFFICIENT_CREDITS",
"message": "...",
"request_id": "..."
}Qué hacer:
- Comprueba el saldo en Facturación de la consola.
- Recarga.
- Vuelve a enviar la solicitud. Un 402 no es un límite de solicitudes, así que esperar no lo resolverá.
En una tarea asíncrona, un 402 al enviarla significa que la tarea nunca se creó. Comprueba el endpoint de estado de la tarea antes de volver a enviarla.
Facturación frente a límites de solicitudes
Son límites distintos:
- Los créditos limitan cuánto puedes gastar. Quedarte sin ellos devuelve un 402.
- Los límites de solicitudes limitan la frecuencia con la que puedes llamar. Superar uno devuelve un 429.
Consulta Errores, límites y reintentos para ver los encabezados de 429 y las reglas de reintento.
Suscripciones y créditos
El uso de la API siempre se paga con créditos de servicio. El único comportamiento de suscripción descrito en esta documentación es la exención de los límites de solicitudes de /v2/chat para las cuentas con una suscripción de pago de Felo vigente; no sustituye a los créditos de servicio.
Preguntas sobre facturación
Si tienes un cargo en disputa o una recarga que no llegó, escribe a soporte con:
- El correo electrónico de la cuenta
- La hora aproximada del cargo
- El
request_idde cualquier error relacionado - El importe de la recarga y la referencia de pago
Nunca envíes tu clave de API completa.