Créditos de la API
Entiende cómo las llamadas a Rivya API usan créditos de cuenta, comprobaciones de saldo, créditos reservados, reembolsos por tareas fallidas y resolución de problemas de créditos.
Última revisión el 10 de mayo de 2026
La API de Rivya usa el mismo saldo de créditos de la cuenta que Studio.
Usa GET /api/v1/credits para leer el saldo actual de la cuenta de la clave API.
Ruta
GET https://rivya.ai/api/v1/creditsHeader requerido:
Authorization: Bearer rvya_sk_...Respuesta
{
"current_credits": 123
}Facturación de generaciones
Cuando envías una generación, Rivya comprueba si la cuenta tiene créditos suficientes.
En trabajos de imagen, video y audio, los créditos normalmente se reservan o consumen al iniciar la tarea. La respuesta de generación incluye:
reserved_creditsfinal_credits
final_credits puede seguir siendo 0 mientras el trabajo está en cola o procesándose.
Trabajos fallidos
Si una tarea falla según las reglas de fallo existentes de Rivya, la gestión de reembolsos sigue la misma política de producto que Studio.
Usa estado de generación para confirmar el estado final y tareas fallidas y reembolsos de créditos para entender el modelo de fallos a nivel de producto.
Errores comunes de créditos
insufficient_credits: la cuenta no tiene créditos suficientesapi_key_invalid: la clave API no puede identificar una cuentapublic_api_disabled: la API pública está temporalmente desactivada