Documentație Rivya AI

Ghidul ciclului de viață al sarcinilor Rivya

Înțelege starea sarcinilor Rivya, rezervarea creditelor, trimiterea către furnizori, notificările de răspuns, verificarea periodică, istoricul, eșecurile și creditele.

Ultima revizuire la 2026/08/29

Folosește acest ghid când trebuie să înțelegi ce se întâmplă după trimiterea unei sarcini de generare de imagini, materiale video sau audio în Rivya.

El explică într-un singur loc stările sarcinii, rezervarea creditelor, finalizarea la furnizor, istoricul, notificările și gestionarea eșecurilor.

Stările reale ale sarcinii

Ciclul actual de generare asincronă folosește patru stări vizibile:

  • WAITING

  • GENERATING

  • SUCCESS

  • FAILED

Aceste stări sunt stocate în ai_task și folosite în Studio, istoric, panoul de control și notificări.

Ce se întâmplă când trimiți o sarcină

1. Rivya validează cererea

Înainte de a trimite ceva unui furnizor, Rivya verifică:

  • dacă modelul există

  • dacă modelul este disponibil în acel moment

  • dacă generarea directă este activată pentru model

  • dacă execuția folosește sarcini asincrone

  • dacă lungimea promptului este validă

  • dacă parametrii formularului sunt normalizați

  • dacă fișierele de referință corespund cerințelor modelului

Unele modele documentate au reguli suplimentare. Audio Isolation necesită istoric un fișier audio și verificarea duratei, dar este indisponibil; Rivya trebuie să îl respingă la poarta de disponibilitate, fără a crea sarcină, rezerva credite sau încerca fluxul de încărcare.

2. Rivya creează înregistrarea sarcinii

Rivya creează mai întâi o înregistrare ai_task, cu starea WAITING.

Înregistrarea păstrează modelul, categoria, promptul, parametrii, creditele rezervate, tipul facturării și, ulterior, rezultatul sau informațiile despre eșec.

3. Creditele sunt consumate înainte de trimiterea către furnizor

Acest detaliu este important: pentru generarea asincronă, Rivya consumă creditele sarcinii înainte de a o trimite furnizorului.

Dacă soldul creditelor este insuficient:

  • sarcina este marcată ca eșuată

  • serviciul furnizorului nu este apelat

  • poate fi creată o notificare privind creditele insuficiente

4. Este creată sarcina furnizorului

Dacă modelul este disponibil, generarea directă este activă și există suficiente credite, Rivya trimite sarcina serviciului potrivit și păstrează identificatorul acesteia.

În acel moment, starea devine GENERATING.

Cum află Rivya rezultatul

Rivya folosește două căi de finalizare:

  • notificare de răspuns de la furnizor, în mediile unde aceasta este activă

  • actualizarea stării și verificare periodică atunci când notificarea de răspuns nu este disponibilă

Calea bazată pe notificarea de răspuns verifică și semnătura webhookului înainte de finalizarea sarcinii.

Dacă notificarea sosește înainte ca rezultatul furnizorului să fie complet, Rivya poate amâna finalizarea și poate verifica din nou starea.

Calea de succes

Când sarcina reușește, Rivya:

  • stochează adresele URL ale rezultatului

  • setează starea la SUCCESS

  • decontează sarcină

  • afișează rezultatul în istoricul generărilor

  • creează o notificare de generare reușită

De aceea, o imagine sau un material video finalizat rămâne vizibil după ce părăsești pagină.

Calea de eșec

Când sarcina eșuează, Rivya:

  • stochează mesajul de eroare

  • setează starea la FAILED

  • returnează creditele atunci când eșecul a apărut după rezervare și consumul trebuie anulat

  • creează o notificare persistentă despre generarea eșuată

Aceasta este diferită de o notificare temporară: eșecul devine parte din istoricul contului.

Unde poți vedea starea sarcinii

Aceeași sarcină poate apărea în mai multe locuri:

  • zona Studio activă cât timp sarcină rulează

  • Istoric, după decontare

  • Centrul de notificări, pentru rezultate importante

  • /dashboard, în lista generărilor recente

Această stare partajată păstrează coerența produsului și continuitatea activității.

Cum diferă Chat

Și Chat consumă credite, dar nu folosește aceeași înregistrare asincronă. Conversațiile sunt stocate ca:

  • sesiuni de chat

  • mesaje de chat

Pentru modelele de chat tarifate după tokenuri, Rivya poate rezerva creditele și apoi deconta suma finală după primirea utilizării. Dacă suma finală este mai mică, diferența este returnată.

Regulă generală este:

  • generarea de imagini, materiale video și audio folosește ai_task

  • chatul folosește sesiuni salvate și decontare la nivel de mesaj

Citește mai departe

Listă de verificare pentru starea sarcinii

Când o generare este neclară, lentă, eșuată sau lipsește, verifică:

  • Identifică mai întâi tipul sarcinii: conversație, imagine, video, audio sau chat asistat de un instrument.

  • Confirmă că modelul ales este disponibil; o pagină documentată nu dovedește că sarcina poate începe.

  • Verifică dacă au fost rezervate credite înainte de trimiterea către furnizor sau dacă au fost decontate după utilizare.

  • Caută notificarea furnizorului, rezultatul verificării periodice, elementul din istoric și notificarea din produs înainte să presupui că rezultatul s-a pierdut.

  • Separă erorile pe care le poți corecta de problemele furnizorului sau infrastructurii.

  • Confirmă dacă o sarcină eșuată trebuie să returneze creditele înainte să rulezi din nou același prompt.

Verifică din nou înainte de o nouă rulare

Verifică din nou când același prompt continuă să eșueze, când o sarcină rămâne prea mult în curs, când creditele par consumate fără rezultat sau când urmează să trimiți o rulare duplicată mai costisitoare.