Verstehen Sie Rivya-Aufgabenstatus, Credit-Reservierung, Anbieter-Submission, Callbacks, Polling, History, Notifications, Fehler und Credits.

Nutzen Sie diesen Leitfaden, wenn Sie verstehen möchten, was nach dem Einreichen einer Bild-, Video- oder Audio-Generierungsaufgabe in Rivya passiert.

Er erklärt Aufgabenstatus, Credit-Reservierung, Anbieter-Abschluss, History, Notifications und Behandlung fehlgeschlagener Aufgaben an einer Stelle.

Die echten Aufgabenstatus

Der aktuelle asynchrone Generierungslebenszyklus nutzt vier sichtbare Status:

WAITING
GENERATING
SUCCESS
FAILED

Diese Status werden auf ai_task gespeichert und über Studio, History, Dashboard und Notifications hinweg wiederverwendet.

Was beim Einreichen passiert

1. Rivya validiert die Anfrage

Bevor etwas einen Anbieter erreicht, prüft Rivya:

ob das Modell existiert
ob direkte Generierung für dieses Modell aktiviert ist
ob die Runtime auf async tasks basiert
ob die Prompt-Länge gültig ist
ob Formularparameter normalisiert sind
ob Referenzdateien zu dem passen, was das Modell akzeptiert

Einige Modelle haben zusätzliche Regeln. Audio-Isolation erfordert zum Beispiel eine hochgeladene Audiodatei plus Dauerprüfung.

2. Rivya erstellt den Aufgabendatensatz

Rivya erstellt zuerst einen ai_task-Eintrag mit dem Status WAITING.

Dieser Datensatz speichert Modell, Kategorie, Prompt, Params, reservierte Credits, Abrechnungstyp und später Ergebnis oder Fehlerzustand.

3. Credits werden vor der Anbieter-Submission verbraucht

Das ist wichtig: Bei asynchroner Generierung gibt Rivya die Aufgaben-Credits aus, bevor der Job upstream gesendet wird.

Wenn die Credits zu niedrig sind:

wird die Aufgabe als fehlgeschlagen markiert
wird der Upstream-Service nie aufgerufen
kann eine Benachrichtigung wegen unzureichender Credits erstellt werden

4. Der Anbieterjob wird erstellt

Wenn Credits verfügbar sind, reicht Rivya die Aufgabe beim passenden Upstream-Service ein und speichert die Upstream-Task-ID.

An diesem Punkt wechselt der Status zu GENERATING.

Wie Rivya das Ergebnis erfährt

Rivya unterstützt zwei Abschlusswege:

Anbieter-Callback in Umgebungen mit aktivierten Callbacks
Statusaktualisierung und Polling, wenn Callback-Abschluss nicht verfügbar ist

Der Callback-Pfad verifiziert außerdem die Webhook-Signatur, bevor eine Aufgabe finalisiert wird.

Wenn ein Callback eintrifft, bevor das Anbieterergebnis vollständig bereit ist, kann Rivya zurückstellen und durch erneutes Prüfen des Upstream-Status später noch einmal versuchen.

Erfolgspfad

Bei Erfolg tut Rivya Folgendes:

Ergebnis-URLs speichern
Status auf SUCCESS setzen
die Aufgabe abrechnen
die Ausgabe in der Generierungshistory verfügbar machen
eine Generation-Success-Notification erstellen

Darum bleibt ein fertiges Bild oder Video sichtbar, nachdem Sie die Seite verlassen haben.

Fehlerpfad

Bei Fehlern tut Rivya Folgendes:

Fehlermeldung speichern
Status auf FAILED setzen
Credits erstatten, wenn der Fehler nach der Reservierung passiert ist und rückgängig gemacht werden sollte
eine Generation-Failed-Notification für dauerhafte Prüfung erstellen

Das unterscheidet sich von einem temporären Toast. Der Fehler wird Teil des Kontodatensatzes.

Wo Sie den Aufgabenstatus sehen

Dieselbe Aufgabe kann an mehreren Stellen erscheinen:

im aktiven Studio, während sie läuft
in History, nachdem sie abgeschlossen ist
im Notifications Center für wichtige Ergebnisse
auf /dashboard unter den letzten Generierungen

Dieser gemeinsame Zustand ist einer der Gründe, warum das Produkt zusammenhängend wirkt statt wegwerfbar.

Wie sich Chat unterscheidet

Chat ist ebenfalls abrechenbar, nutzt aber nicht denselben asynchronen Aufgabendatensatz. Chat-Turns werden gespeichert als:

Chat-Sitzungen
Chat-Nachrichten

Bei tokenbasierten Chat-Modellen kann Rivya Credits zunächst reservieren und den finalen Betrag nach zurückgemeldeter Nutzung abrechnen. Wenn der finale Betrag niedriger ist, wird die Differenz erstattet.

Die grobe Regel lautet also:

Bild-, Video- und Audio-Generierung nutzen ai_task
Chat nutzt gespeicherte Sitzungen und nachrichtenbasierte Abrechnung

Als Nächstes lesen

Checkliste zum Aufgabenstatus

Wenn eine Generierung verwirrend, langsam, fehlgeschlagen oder verschwunden wirkt, prüfen Sie:

Identifizieren Sie zuerst den Aufgabentyp: Chat-Abrechnung, Bild, Video, Audio oder toolgestützter Chat.
Prüfen Sie, ob Credits vor Anbieter-Submission reserviert oder nach Nutzung abgerechnet wurden.
Suchen Sie nach Anbieter-Callback, Polling-Ergebnis, History-Eintrag und Notification, bevor Sie annehmen, dass das Ergebnis verloren ist.
Trennen Sie nutzerkorrigierbare Fehler von Anbieter- oder Infrastrukturfehlern.
Bestätigen Sie, ob eine fehlgeschlagene Aufgabe Credits rückgängig machen sollte, bevor Sie denselben Prompt erneut ausführen.

Vor dem erneuten Ausführen prüfen

Prüfen Sie erneut, wenn derselbe Prompt weiter fehlschlägt, eine Aufgabe zu lange in Bearbeitung bleibt, Credits ohne Ausgabe verbraucht wirken oder Sie kurz davor sind, einen schwereren Duplikatlauf einzureichen.

Rivya-Leitfaden zum Aufgabenlebenszyklus