Comprenez les statuts de tâche Rivya, la réservation de crédits, la soumission fournisseur, les callbacks, le polling, l'historique, les notifications, les échecs et les crédits.

Utilisez ce guide lorsque vous devez comprendre ce qui se passe après avoir soumis une tâche de génération d'image, de vidéo ou d'audio dans Rivya.

Il explique au même endroit les états de tâche, la réservation de crédits, la complétion fournisseur, l'historique, les notifications et le traitement des tâches échouées.

Les vrais états de tâche

Le cycle de vie actuel de génération asynchrone utilise quatre états visibles :

WAITING
GENERATING
SUCCESS
FAILED

Ces états sont stockés sur ai_task et réutilisés dans Studio, l'historique, le dashboard et le flux de notifications.

Ce qui se passe lorsque vous soumettez

1. Rivya valide la requête

Avant que quoi que ce soit atteigne un fournisseur, Rivya vérifie :

que le modèle existe
que la génération directe est activée pour ce modèle
que le runtime repose sur des tâches asynchrones
que la longueur du prompt est valide
que les paramètres de formulaire sont normalisés
que les fichiers de référence correspondent à ce que le modèle accepte

Certains modèles ont des règles supplémentaires. Par exemple, l'isolation audio exige un fichier audio uploadé ainsi qu'une vérification de durée.

2. Rivya crée l'enregistrement de tâche

Rivya crée d'abord une entrée ai_task, avec le statut WAITING.

Cet enregistrement stocke le modèle, la catégorie, le prompt, les paramètres, les crédits réservés, le type de facturation, puis plus tard le résultat ou l'état d'échec.

3. Les crédits sont consommés avant la soumission fournisseur

C'est important : pour la génération asynchrone, Rivya dépense les crédits de la tâche avant d'envoyer le travail en amont.

Si les crédits sont insuffisants :

la tâche est marquée comme échouée
le service amont n'est jamais appelé
une notification de crédits insuffisants peut être créée

4. La tâche fournisseur est créée

Si les crédits sont disponibles, Rivya soumet la tâche au service amont correspondant et stocke l'ID de tâche amont.

À ce moment, le statut passe à GENERATING.

Comment Rivya apprend le résultat

Rivya prend en charge deux chemins de complétion :

callback fournisseur dans les environnements où les callbacks sont activés
rafraîchissement de statut et polling lorsque la complétion par callback n'est pas disponible

Le chemin de callback vérifie aussi la signature du webhook avant de finaliser une tâche.

Si un callback arrive avant que le résultat fournisseur soit complètement prêt, Rivya peut différer le traitement et réessayer en vérifiant le statut amont.

Chemin de succès

En cas de succès, Rivya :

stocke les URL de résultat
passe le statut à SUCCESS
règle la tâche
rend la sortie disponible dans l'historique de génération
crée une notification de génération réussie

C'est pourquoi une image ou une vidéo terminée reste visible après que vous quittez la page.

Chemin d'échec

En cas d'échec, Rivya :

stocke le message d'erreur
passe le statut à FAILED
rembourse les crédits lorsque l'échec s'est produit après réservation et doit être annulé
crée une notification de génération échouée pour une revue durable

C'est différent d'un toast temporaire. L'échec devient une partie du registre du compte.

Où voir l'état de tâche

La même tâche peut apparaître à plusieurs endroits :

dans le Studio actif pendant qu'elle s'exécute
dans History après son règlement
dans le Centre de notifications pour les résultats importants
sur /dashboard dans les générations récentes

Cet état partagé est l'une des raisons pour lesquelles le produit paraît cohérent plutôt que jetable.

En quoi Chat diffère

Chat est aussi facturable, mais il n'utilise pas le même enregistrement de tâche asynchrone. Les tours de chat sont stockés comme :

sessions de chat
messages de chat

Pour les modèles de chat facturés aux tokens, Rivya peut réserver les crédits d'abord, puis régler le montant final après retour de l'usage. Si le montant final est plus bas, la différence est remboursée.

La règle générale est donc :

la génération image, vidéo et audio utilise ai_task
le chat utilise les sessions enregistrées et le règlement au niveau des messages

Checklist d'état de tâche

Lorsqu'une génération est confuse, lente, échouée ou manquante, vérifiez :

Identifiez d'abord le type de tâche : règlement chat, image, vidéo, audio ou chat adossé à des outils.
Vérifiez si les crédits ont été réservés avant la soumission fournisseur ou réglés après usage.
Cherchez le callback fournisseur, le résultat de polling, l'élément d'historique et la notification avant de supposer que le résultat est perdu.
Séparez les échecs corrigeables par l'utilisateur des échecs fournisseur ou infrastructure.
Confirmez si une tâche échouée doit inverser les crédits avant de relancer le même prompt.

Revérifier avant de relancer

Revérifiez lorsque le même prompt échoue à répétition, qu'une tâche reste trop longtemps en cours, que des crédits semblent consommés sans sortie ou que vous êtes sur le point de soumettre une exécution dupliquée plus lourde.

Guide du cycle de vie des tâches Rivya