Begrijp taakstatussen in Rivya, creditreservering, providerindiening, callbacks, polling, geschiedenis, notificaties, fouten en credits.

Gebruik deze gids wanneer je wilt begrijpen wat er gebeurt nadat je in Rivya een taak voor het genereren van een afbeelding, video of audio hebt ingediend.

De gids legt taakstatussen, creditreservering, afronding door providers, geschiedenis, notificaties en de afhandeling van mislukte taken op een plek uit.

De echte taakstatussen

De huidige levenscyclus voor asynchrone generatie gebruikt vier zichtbare statussen:

WAITING
GENERATING
SUCCESS
FAILED

Deze statussen worden opgeslagen op ai_task en hergebruikt in Studio, History, het dashboard en de notificatiestroom.

Wat er gebeurt wanneer je indient

1. Rivya valideert de aanvraag

Voordat iets een provider bereikt, controleert Rivya:

of het model bestaat
of directe generatie is ingeschakeld voor dat model
of de runtime op asynchrone taken is gebaseerd
of de promptlengte geldig is
of formulierparameters zijn genormaliseerd
of referentiebestanden passen bij wat het model accepteert

Sommige modellen hebben extra regels. Audio-isolatie vereist bijvoorbeeld een audiobestand als upload plus verificatie van de duur.

2. Rivya maakt het taakrecord aan

Rivya maakt eerst een ai_task-record aan met status WAITING.

Dat record bewaart het model, de categorie, prompt, parameters, gereserveerde credits, het factureringstype en later het resultaat of de foutstatus.

3. Credits worden verbruikt voor providerindiening

Dit is belangrijk: bij asynchrone generatie besteedt Rivya de taakcredits voordat de taak naar de upstreamservice wordt verzonden.

Als credits te laag zijn:

wordt de taak gemarkeerd als mislukt
wordt de upstreamservice nooit aangeroepen
kan een notificatie voor onvoldoende credits worden aangemaakt

4. De providertaak wordt aangemaakt

Als er credits beschikbaar zijn, dient Rivya de taak in bij de bijpassende upstreamservice en bewaart het upstream taak-ID.

Op dat moment gaat de status naar GENERATING.

Hoe Rivya het resultaat leert kennen

Rivya ondersteunt twee routes voor afronding:

providercallbacks in omgevingen waarin callbacks beschikbaar zijn
statusverversing en polling wanneer afronding via callbacks niet beschikbaar is

De callbackroute verifieert ook de webhookhandtekening voordat een taak wordt afgerond.

Als een callback binnenkomt voordat het providerresultaat volledig klaar is, kan Rivya de afronding uitstellen en het later opnieuw proberen door de upstreamstatus te controleren.

Succespad

Bij succes doet Rivya het volgende:

resultaat-URL's opslaan
status op SUCCESS zetten
de taak afrekenen
de output beschikbaar maken in de generatiegeschiedenis
een notificatie voor geslaagde generatie aanmaken

Daarom blijft een voltooide afbeelding of video zichtbaar nadat je de pagina verlaat.

Foutpad

Bij een fout doet Rivya het volgende:

foutmelding opslaan
status op FAILED zetten
credits terugstorten wanneer de fout na reservering plaatsvond en moet worden teruggedraaid
een notificatie voor mislukte generatie aanmaken voor latere controle

Dit is anders dan een tijdelijke toastmelding. De fout wordt onderdeel van het accountrecord.

Waar je de taakstatus ziet

Dezelfde taak kan op meerdere plekken verschijnen:

de actieve Studio terwijl de taak draait
Geschiedenis nadat de taak is afgerond
Notificatiecentrum voor belangrijke uitkomsten
/dashboard in recente generaties

Die gedeelde status is een van de redenen waarom het product samenhangend aanvoelt in plaats van tijdelijk en losstaand.

Hoe Chat verschilt

Chat is ook factureerbaar, maar gebruikt niet hetzelfde asynchrone taakrecord. Chatbeurten worden opgeslagen als:

chatsessies
chatberichten

Voor chatmodellen op basis van tokens kan Rivya eerst credits reserveren en daarna het definitieve bedrag afrekenen zodra het gebruik is teruggekomen. Als het definitieve bedrag lager is, wordt het verschil teruggestort.

De brede regel is dus:

afbeeldings-, video- en audiogeneratie gebruiken ai_task
chat gebruikt opgeslagen sessies en afrekening op berichtniveau

Lees verder

Checklist voor taakstatus

Wanneer een generatie verwarrend of traag is, mislukt lijkt of ontbreekt, controleer dan:

Bepaal eerst het taaktype: chatafrekening, afbeelding, video, audio of tool-ondersteunde chat.
Controleer of credits voor providerindiening waren gereserveerd of na gebruik zijn afgerekend.
Zoek naar de providercallback, het pollingresultaat, het geschiedenisitem en de notificatie voordat je aanneemt dat het resultaat verloren is.
Scheid fouten die de gebruiker kan corrigeren van provider- of infrastructuurfouten.
Bevestig of een mislukte taak credits moet terugdraaien voordat je dezelfde prompt opnieuw uitvoert.

Controleer opnieuw voordat je nogmaals uitvoert

Controleer opnieuw wanneer dezelfde prompt blijft falen, een taak te lang bezig blijft, credits verbruikt lijken zonder output, of je op het punt staat een zwaardere dubbele uitvoering in te dienen.

Rivya-gids voor de taaklevenscyclus