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 2026/05/10
Rivya API usa el mismo wallet de créditos de cuenta que Studio.
Usa GET /api/v1/credits para leer el saldo actual de la cuenta de la clave API.
Endpoint
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
Páginas relacionadas
Chat API
Usa Rivya Chat API para turnos sin streaming o con SSE, sesiones creadas por API, adjuntos de imagen file_id y liquidación de créditos basada en tokens.
Errores y límites de la API
Maneja códigos públicos de error de Rivya API, estados HTTP, límites de tasa, conflictos de idempotencia y decisiones de reintento.