Rivya-Leitfaden zur Fehlerbehebung

Nutzen Sie diesen Leitfaden zur Fehlerbehebung, wenn Rivya-Chat, Uploads, Generierungsaufgaben, History, Notifications, Credits oder Abrechnungsstatus nicht wie erwartet funktionieren.

Wenn Rivya kaputt wirkt, ist die schnellste Lösung, zuerst zu entscheiden, welche Ebene tatsächlich fehlschlägt.

Die meisten Probleme landen an einer von fünf Stellen:

• Zugriff und Anmeldung
• Modell- oder Eingabe-Mismatch
• asynchroner Aufgabenstatus
• Wallet- oder Zahlungsstatus
• Suche nach gespeicherter Arbeit

Diese Aufteilung ist deutlich nützlicher, als alles wie einen generischen "Bug" zu behandeln.

1. Chat lässt sich nicht senden

Wenn Chat nicht wirklich läuft, prüfen Sie zuerst die einfachen Ursachen:

• Sie befinden sich möglicherweise noch in einem öffentlichen Landing-Flow und müssen sich vor dem Senden anmelden
• die Entwurfsnachricht ist möglicherweise leer
• die gespeicherte Sitzung wurde möglicherweise nicht sauber geladen

Wenn das Problem sitzungsspezifisch ist, öffnen Sie die Konversation aus History erneut, statt zu raten, auf welchem Pfad Sie waren.

Wenn die Aufgabe eng und wiederholbar ist, kann es auch sauberer sein, über einen Tool-Einstieg neu zu starten, statt in einem breiten Plain-Chat-Thread weiterzumachen.

2. Eine Generierung startet nicht

Wenn Bild-, Video- oder Audio-Generierung fehlschlägt, bevor sie wirklich beginnt, sind die üblichen Ursachen:

• erforderlicher Prompt-Inhalt fehlt
• ein dialogartiges Audioformular ist unvollständig
• das ausgewählte Modell verlangt eine Referenzdatei, aber keine wurde bereitgestellt
• das Konto hat nicht genug Credits

Aktuell können unzureichende Credits den Lauf fehlschlagen lassen, bevor der Upstream-Service überhaupt aufgerufen wird. Darum kann sich "nichts ist passiert" trotzdem als echter fehlgeschlagener Datensatz mit Notification im Konto zeigen.

3. Uploads schlagen fehl

Uploads sind modellgesteuert, nicht kategoriegesteuert.

Das bedeutet:

• nicht jedes Modell in einer Kategorie akzeptiert dieselben Referenzarten
• nicht jedes Modell akzeptiert dieselbe Anzahl von Dateien
• Größen- und Typgrenzen werden vor der echten Generierungsanfrage erzwungen

Wenn ein Upload fehlschlägt, prüfen Sie:

• ob das Modell diese Dateiart überhaupt unterstützt
• ob Sie das aktuelle Referenzdateilimit bereits erreicht haben
• ob Dateityp oder Größe gegen die aktuellen Upload-Regeln verstoßen

Wenn der Workflow Audio-Bereinigung oder Isolation ist, denken Sie daran: Uploaded-Audio-Pfade unterscheiden sich strukturell von promptbasiertem TTS oder Stimmgenerierung.

4. Aufgabe hängt in Bearbeitung fest

Bild-, Video- und Audio-Läufe sind asynchrone Aufgaben in Rivya.

Die sichtbaren Status sind:

• WAITING
• GENERATING
• SUCCESS
• FAILED

Wenn eine Aufgabe festzuhängen scheint, schauen Sie nicht nur auf die aktuelle Seite.

Prüfen Sie auch diese Oberflächen:

• das aktive Studio
• History
• Notifications Center
• aktuelle Generierungen auf /dashboard

Einige Aufgaben schließen per Callback ab, andere per Polling oder Refresh. "Wird noch generiert" bedeutet also nicht automatisch "verloren". Oft wartet die Aufgabe noch darauf, dass das finale Upstream-Ergebnis vollständig abgeschlossen wird.

5. Eine Aufgabe ist fehlgeschlagen

Fehler in Rivya werden normalerweise bewahrt, nicht versteckt.

Eine fehlgeschlagene Aufgabe kann Folgendes behalten:

• den fehlgeschlagenen Status selbst
• eine Fehlermeldung
• Erstattungsstatus, wenn reservierte Credits rückgängig gemacht werden sollten
• eine Generation-Failed-Notification für dauerhafte Prüfung

Der richtige nächste Schritt ist normalerweise:

1. Fehlerstatus lesen
2. entscheiden, ob das Problem Credits, Prompt oder Eingabe-Mismatch war
3. erst nach Behebung dieser konkreten Ursache erneut ausführen

Behandeln Sie nicht jeden Fehler wie ein vorübergehendes UI-Problem.

6. Ergebnis wirkt verschwunden

Meistens ist das Ergebnis nicht verschwunden. Es liegt nur auf der falschen Oberfläche.

Nutzen Sie History, wenn die Frage lautet:

Nutzen Sie Notifications Center, wenn die Frage lautet:

Die breite Regel lautet:

• Chat kehrt in die Chat-History zurück
• Bild, Video und Audio kehren in die Generierungshistory zurück
• Abrechnungs- und Credit-Ereignisse sind oft am klarsten in Notifications sichtbar

7. Zahlungsstatus wirkt alt

Wenn Checkout abgeschlossen ist, Wallet oder Abrechnungsstatus aber noch alt wirken, folgen Sie zuerst dem Abrechnungspfad, bevor Sie annehmen, dass die Zahlung verloren ist.

Der aktuelle Produktfluss ist:

1. Checkout abschließen
2. über /payment zurückkehren
3. das Produkt Billing- oder Wallet-Status pollen und aktualisieren lassen
4. /settings/billing oder /settings/credits prüfen

Notifications können Abrechnungsergebnisse ebenfalls bewahren, daher lohnt sich ein Blick dorthin, wenn der Kontostatus nicht synchron wirkt.

8. Wo Sie zuerst prüfen sollten

Nutzen Sie diese Abkürzung:

• aktuelles Studio: laufende Live-Arbeit
• History: gespeicherte Ausgaben und gespeicherte Konversationen
• Notifications Center: operative Ereignisse, die bereits passiert sind
• /settings/billing: Abonnementstatus
• /settings/credits: Wallet-Guthaben, Pakete, Ablaufdaten und Transaktionen

Die meiste Verwirrung entsteht dadurch, dass zuerst die falsche Ebene geprüft wird.

Als Nächstes lesen

• Aufgabenlebenszyklus in Rivya
• Bild-Workflows in Rivya
• Video-Workflows in Rivya
• Audio-Workflows in Rivya
• Referenzen und Uploads in Rivya
• Credits und Abrechnung in Rivya
• Payment Checkout in Rivya

Triage-Checkliste zur Fehlerbehebung

Wählen Sie zuerst die richtige Prüfstelle, bevor Sie dieselbe Aktion wiederholen:

• Chat lässt sich nicht senden: Anmeldung, Sitzungsstatus, Modellverfügbarkeit und Credit-Verhalten prüfen.
• Uploads schlagen fehl: Dateityp, Größe, Modellunterstützung und ob die Aufgabe wirklich eine Datei braucht prüfen.
• Generierung hängt: Aufgabenstatus, Anbieter-Callbacks, Polling, History und Notifications prüfen.
• Billing wirkt alt: Checkout-Rückkehr, Webhook-Abschluss, Billing-Einstellungen und Credits-Einstellungen prüfen.
• Ergebnisse wirken fehlend: richtige History-Art prüfen und ob die Aufgabe tatsächlich abgeschlossen wurde.

Vor Eskalation erneut prüfen

Eskalieren Sie erst, wenn Sie Kontobereich, task id oder Zahlungskontext, erwartetes Ergebnis, tatsächliches Ergebnis und den letzten sichtbaren Status benennen können. So wird Support zur Diagnose statt zur Raterei.