Guía de tareas fallidas y reembolsos de créditos en Rivya
Gestiona tareas fallidas en Rivya, revisión de créditos, reintentos, problemas de subida, errores del proveedor, notificaciones, historial y estados de procesamiento.
Usa esta guía cuando una generación de imagen, video o audio falle, parezca atascada o termine sin un resultado usable.
Explica dónde revisar el estado de la tarea, cómo funciona el manejo de créditos y qué cambiar antes de gastar créditos en otra ejecución.
Qué cuenta como tarea fallida
Una tarea fallida es distinta de una tarea que sigue procesándose.
Una tarea puede estar fallida cuando Rivya o el proveedor informa que la generación no puede completarse. Una tarea puede seguir procesándose cuando fue aceptada, pero el resultado aún no volvió.
Antes de asumir que una tarea falló, revisa el estado de la tarea en el historial o superficie de notificaciones correspondiente.
Cómo funcionan los reembolsos de créditos
El ciclo de vida de tareas de Rivya está diseñado para reservar créditos para trabajo de generación y manejar resultados fallidos según la lógica de facturación actual del producto.
En la práctica, revisa el resultado de la tarea, su estado y el saldo de créditos después de una generación fallida. Si la tarea falló antes de producir un resultado usable, Rivya puede devolver créditos según la ruta actual de manejo de fallos.
Como el comportamiento del proveedor puede variar según el flujo de trabajo, no asumas que todo retraso es un fallo ni que todo reintento debe enviarse de inmediato.
Dónde revisar el estado de la tarea
Usa primero estos lugares:
el historial de generación del workflow
saldo de créditos de la cuenta
la página donde se inició la tarea
Para el flujo subyacente, lee ciclo de vida de tareas en Rivya.
Qué probar antes de enviar de nuevo
Antes de reintentar, revisa:
si la subida terminó correctamente
si el tipo y tamaño de archivo están admitidos
si el prompt pide comportamiento no admitido
si el modelo seleccionado es adecuado actualmente para el trabajo
si la tarea en realidad sigue procesándose
si una primera ejecución más simple sería más segura
Si la tarea usa referencias, prueba reducir la complejidad de las referencias o aclarar qué debe controlar cada referencia.
Cuando una tarea sigue procesándose
Algunas tareas de generación tardan más que una interacción web normal.
Si la tarea sigue procesándose:
evita enviar duplicados repetidos de inmediato
revisa notificaciones para ver actualizaciones
vuelve mediante historial cuando esté disponible
espera el estado final antes de tratarla como fallida
El trabajo asíncrono es una razón por la que Rivya mantiene notificaciones e historial separados de los toasts de una sola página.
Checklist de reintento
Antes de reintentar una generación fallida o poco clara, revisa:
Confirma el estado exacto de la tarea antes de iniciar otra ejecución.
Revisa la subida, el prompt, el modelo y los ajustes usados.
Decide qué debe cambiar en el reintento: prompt más simple, menos referencias, otro modelo o archivo corregido.
Revisa saldo de créditos y coste esperado antes de usar un ajuste más pesado.
Conserva el contexto de la tarea fallida si necesitas diagnosticar o contactar soporte.
El objetivo es reintentar con una razón más clara, no repetir la misma solicitud fallida.
Cuándo revisar antes de reintentar
Revisa antes de reintentar cuando la tarea siga procesándose, el estado de créditos no esté claro o la misma subida o prompt haya fallado más de una vez.
En esos casos, inspecciona historial, notificaciones y estado de tarea antes de iniciar una ejecución duplicada.
Páginas relacionadas
Guía del ciclo de vida de tareas en Rivya
Entiende el estado de las tareas en Rivya, la reserva de credits, el envío al proveedor, los callbacks, el polling, el historial, las notificaciones y los fallos.
Cola de generación y tiempos de espera
Entiende colas de generación en Rivya, tiempos de espera, tareas largas de imagen, video y audio, notificaciones, historial y reintentos seguros.