Rivya AI dokumentáció

Rivya-feladatok életciklusának útmutatója

Ismerd meg a Rivya feladatállapotait, kreditfoglalását, szolgáltatói beküldését, visszahívásait, állapotlekérdezését, előzményeit, értesítéseit, hibáit és kreditkezelését.

Utoljára ellenőrizve: 2026/08/29

Akkor használd ezt az útmutatót, amikor meg kell értened, mi történik egy kép-, videó- vagy hanggenerálási feladat beküldése után a Rivyában.

Egy helyen magyarázza el a feladatállapotokat, a kreditfoglalást, a szolgáltatói befejezést, az előzményeket, az értesítéseket és a sikertelen feladatok kezelését.

A valódi feladatállapotok

A jelenlegi aszinkron generálási életciklus négy látható állapotot használ:

  • WAITING

  • GENERATING

  • SUCCESS

  • FAILED

Ezek az állapotok az ai_task rekordban tárolódnak, és a Studio, az előzmények, a dashboard és az értesítési folyamat is újrahasználja őket.

Mi történik beküldéskor

1. A Rivya ellenőrzi a kérést

Mielőtt bármi eljutna egy szolgáltatóhoz, a Rivya ellenőrzi:

  • létezik-e a modell

  • a modell jelenleg elérhető

  • engedélyezett-e a közvetlen generálás ennél a modellnél

  • az adott futtatási mód aszinkron feladatokra épül-e

  • megfelelő-e a generálási kérés hossza

  • normalizálva vannak-e az űrlapparaméterek

  • a referenciafájlok megfelelnek-e annak, amit a modell elfogad

Egyes dokumentált modellekre további szabályok vonatkoznak. Az Audio Isolation korábban feltöltött hangfájlt és időtartam-ellenőrzést igényelt, de jelenleg nem elérhető; a Rivyának az elérhetőségi ellenőrzésnél el kell utasítania a kérést anélkül, hogy feladatot hozna létre, kreditet foglalna vagy elindítaná a feltöltési folyamatot.

2. A Rivya létrehozza a feladatrekordot

A Rivya először létrehoz egy ai_task bejegyzést WAITING állapottal.

Ez a rekord tárolja a modellt, a kategóriát, a generálási kérést, a paramétereket, a lefoglalt krediteket, a számlázási típust, majd később az eredményt vagy a hibaállapotot.

3. A kreditek a szolgáltatói beküldés előtt fogyasztódnak el

Ez fontos: aszinkron generálásnál a Rivya még azelőtt elköltöttnek tekinti a feladat kreditjeit, hogy a munkát elküldené a felsőbb szolgáltatásnak.

Ha túl kevés a kredit:

  • a feladat sikertelenként lesz megjelölve

  • a felsőbb szolgáltatás soha nem kap hívást

  • létrejöhet egy elégtelen kreditről szóló értesítés

4. Létrejön a szolgáltatói feladat

Ha a modell elérhető, a közvetlen generálás engedélyezett és van elég kredit, a Rivya elküldi a feladatot a megfelelő szolgáltatásnak, és tárolja a külső azonosítót.

Ekkor az állapot GENERATING értékre vált.

Hogyan tudja meg a Rivya az eredményt

A Rivya két befejezési útvonalat támogat:

  • szolgáltatói visszahívás azokban a környezetekben, ahol ez engedélyezett

  • állapotfrissítés és rendszeres állapotlekérdezés, amikor a visszahívásos befejezés nem érhető el

A visszahívásos útvonal a feladat véglegesítése előtt a webhook aláírását is ellenőrzi.

Ha a visszahívás azelőtt érkezik meg, hogy a szolgáltatói eredmény teljesen elkészülne, a Rivya elhalaszthatja a véglegesítést, és a külső szolgáltató állapotának ellenőrzésével újra próbálkozhat.

Sikeres útvonal

Siker esetén a Rivya:

  • eltárolja az eredmény URL-jeit

  • az állapotot SUCCESS értékre állítja

  • elszámolja a feladatot

  • elérhetővé teszi a kimenetet a generálási előzményekben

  • generálási sikerértesítést hoz létre

Ezért marad látható egy elkészült kép vagy videó akkor is, miután elhagyod az oldalt.

Hibás útvonal

Hiba esetén a Rivya:

  • eltárolja a hibaüzenetet

  • az állapotot FAILED értékre állítja

  • visszatéríti a krediteket, ha a hiba foglalás után történt, és vissza kell fordítani

  • tartósan visszanézhető generálási hibaértesítést hoz létre

Ez eltér egy rövid ideig látható felugró üzenettől. A hiba a fiók rekordjának részévé válik.

Hol látod a feladat állapotát

Ugyanaz a feladat több helyen is megjelenhet:

Ez a közös állapot az egyik oka annak, hogy a termék következetesnek érződik, nem pedig eldobható munkamenetek sorának.

Miben más a Chat

A Chat is számlázható, de nem ugyanazt az aszinkron feladatrekordot használja. A chatfordulók így tárolódnak:

  • chatmunkamenetek

  • chatüzenetek

Tokenalapú chatmodelleknél a Rivya először lefoglalhat krediteket, majd a használat visszaérkezése után elszámolhatja a végső összeget. Ha a végső összeg alacsonyabb, a különbözet visszatérül.

Az általános szabály tehát:

  • a kép-, videó- és hanggenerálás ai_task rekordot használ

  • a chat mentett munkameneteket és üzenetszintű elszámolást használ

Olvasd el ezeket is

Feladatállapot ellenőrzőlista

Amikor egy generálás zavaros, lassú, sikertelen vagy hiányzik, ellenőrizd:

  • Először azonosítsd a feladat típusát: chatelszámolás, kép, videó, hang vagy eszközzel támogatott chat.

  • Ellenőrizze, hogy a kiválasztott modell elérhető-e; egy dokumentált oldal nem bizonyítja, hogy feladat indítható.

  • Nézd meg, hogy a kreditek a szolgáltatói beküldés előtt lettek-e lefoglalva, vagy a használat után lettek-e elszámolva.

  • Keresd meg a szolgáltatói visszahívást, az állapotlekérdezés eredményét, az előzményelemet és az értesítést, mielőtt azt feltételeznéd, hogy az eredmény elveszett.

  • Válaszd szét a felhasználó által javítható hibákat a szolgáltatói vagy infrastrukturális hibáktól.

  • Újrafuttatás előtt erősítsd meg, hogy egy sikertelen feladatnak vissza kell-e fordítania a krediteket.

Ellenőrizd újra, mielőtt ismét futtatod

Ellenőrizd újra, ha ugyanaz a generálási kérés folyamatosan hibázik, egy feladat túl sokáig marad folyamatban, a kreditek kimenet nélkül tűnnek elköltöttnek, vagy éppen egy költségesebb ismételt futtatás beküldésére készülsz.