Guide de dépannage Rivya

Utilisez ce guide de dépannage lorsque le chat, les uploads, les tâches de génération, l'historique, les notifications, les crédits ou l'état de facturation de Rivya ne se comportent pas comme prévu.

Lorsque Rivya semble cassé, la solution la plus rapide consiste à décider quelle couche échoue réellement.

La plupart des problèmes se situent dans l'un de ces cinq endroits :

• accès et connexion

• incompatibilité modèle ou entrée

• état de tâche asynchrone

• état du portefeuille ou du paiement

• recherche du travail enregistré

Cette séparation est beaucoup plus utile que de traiter chaque cas comme un « bug » générique.

1. Le chat ne s'envoie pas

Si le chat ne s'exécute pas réellement, vérifiez d'abord les causes simples :

• vous êtes peut-être encore dans un flux de landing public et devez vous connecter avant d'envoyer

• le brouillon de message est peut-être vide

• la session enregistrée n'a peut-être pas été chargée correctement

Si le problème est propre à une session, rouvrez la conversation depuis History au lieu de deviner sur quel chemin vous étiez.

Si la tâche est étroite et répétitive, il peut aussi être plus propre de repartir depuis une entrée d'outil plutôt que de continuer dans un fil de chat simple trop large.

2. Une génération ne démarre pas

Si une génération image, vidéo ou audio échoue avant de vraiment commencer, les causes habituelles sont :

• le contenu de prompt requis manque

• un formulaire audio de type dialogue est incomplet

• le modèle sélectionné exige un fichier de référence et aucun n'a été fourni

• le compte n'a pas assez de crédits

Aujourd'hui, des crédits insuffisants peuvent faire échouer l'exécution avant même que le service amont soit appelé. C'est pourquoi une impression de « rien ne s'est passé » peut quand même laisser un vrai enregistrement d'échec et une notification.

3. Les uploads échouent

Les uploads sont pilotés par le modèle, pas par la catégorie.

Cela signifie :

• tous les modèles d'une catégorie n'acceptent pas les mêmes types de référence

• tous les modèles n'acceptent pas le même nombre de fichiers

• les limites de taille et de type sont appliquées avant la vraie requête de génération

Si un upload échoue, vérifiez :

• si le modèle prend en charge ce type de fichier

• si vous avez déjà atteint la limite actuelle de fichiers de référence

• si le type ou la taille du fichier enfreint les règles d'upload actuelles

Si le workflow est du nettoyage ou de l'isolation audio, rappelez-vous que les chemins avec audio uploadé sont structurellement différents de la génération TTS ou voix qui commence par un prompt.

4. Tâche bloquée en cours

Les exécutions image, vidéo et audio sont des tâches asynchrones dans Rivya.

Les états visibles sont :

• WAITING

• GENERATING

• SUCCESS

• FAILED

Si une tâche semble bloquée, ne surveillez pas seulement la page actuelle.

Vérifiez aussi ces surfaces :

• le Studio actif

• History

• Centre de notifications

• les générations récentes sur /dashboard

Certaines tâches se terminent par callback, d'autres par polling ou rafraîchissement. Donc « encore en génération » ne signifie pas à lui seul « perdu ». Souvent, la tâche attend encore que le résultat amont final soit stabilisé.

5. Une tâche a échoué

Dans Rivya, l'échec est généralement conservé, pas caché.

Une tâche échouée peut garder :

• le statut d'échec lui-même

• un message d'erreur

• un état de remboursement, lorsque les crédits réservés doivent être inversés

• une notification de génération échouée

La bonne étape suivante est donc généralement :

1. lire l'état d'échec

2. décider si le problème venait des crédits, du prompt ou d'une incompatibilité d'entrée

3. relancer seulement après avoir corrigé cette cause précise

Ne traitez pas chaque échec comme un problème d'interface temporaire.

6. Le résultat semble disparu

En général, le résultat n'a pas disparu. Il est simplement sur la mauvaise surface.

Utilisez History lorsque la question est :

Qu'ai-je créé ou discuté ?

Utilisez le Centre de notifications lorsque la question est :

Quel événement important de compte ou de workflow s'est produit ?

La règle générale est :

• le chat revient dans l'historique de chat

• les images, vidéos et audios reviennent dans l'historique de génération

• les événements de facturation et de crédits apparaissent souvent le plus clairement dans les notifications

7. L'état de paiement semble ancien

Si le checkout est terminé mais que le portefeuille ou l'état de facturation semble encore obsolète, suivez le chemin de facturation avant de supposer que le paiement est perdu.

Le flux produit actuel est :

1. terminer le checkout

2. revenir via /payment

3. laisser le produit poller et rafraîchir l'état de facturation ou de portefeuille

4. vérifier /settings/billing ou /settings/credits

Les notifications peuvent aussi conserver les résultats de facturation, elles valent donc la peine d'être vérifiées lorsque l'état du compte semble désynchronisé.

8. Où vérifier d'abord

Utilisez ce raccourci :

• Studio actuel : travail live en cours

• History : sorties enregistrées et conversations enregistrées

• Centre de notifications : événements opérationnels déjà arrivés

• /settings/billing : état de l'abonnement

• /settings/credits : solde du portefeuille, packs, expiration et transactions

La plupart des confusions viennent du fait de vérifier d'abord la mauvaise couche.

À lire ensuite

• Cycle de vie des tâches dans Rivya

• Workflows image dans Rivya

• Workflows vidéo dans Rivya

• Workflows audio dans Rivya

• Références et uploads dans Rivya

• Crédits et facturation dans Rivya

• Payment Checkout dans Rivya

Checklist de triage de dépannage

Choisissez le premier endroit à vérifier avant de répéter la même action :

• Le chat ne s'envoie pas : vérifiez la connexion, l'état de session, la disponibilité du modèle et le comportement des crédits.

• Les uploads échouent : vérifiez le type de fichier, la taille, la prise en charge du modèle et si la tâche a vraiment besoin d'un fichier.

• La génération est bloquée : vérifiez le statut de tâche, les callbacks fournisseur, le polling, l'historique et les notifications.

• La facturation semble obsolète : vérifiez le retour Checkout, le règlement webhook, les paramètres de facturation et les paramètres de crédits.

• Les résultats semblent manquants : vérifiez le bon type d'historique et si la tâche a réellement été terminée.

Revérifier avant d'escalader

Escaladez seulement après pouvoir nommer la zone de compte, l'ID de tâche ou le contexte de paiement, le résultat attendu, le résultat réel et le dernier état visible. Cela transforme le support en diagnostic plutôt qu'en devinette.