Rivya AI -dokumentaatio

Rivyan tehtävän elinkaaren opas

Ymmärrä Rivyan tehtävän tila, krediittivaraus, lähetys palveluntarjoajalle, takaisinsoitot, tilakyselyt, historia, ilmoitukset, epäonnistumiset ja krediitit.

Viimeksi tarkistettu 2026/04/28

Käytä tätä opasta, kun sinun täytyy ymmärtää, mitä tapahtuu sen jälkeen, kun lähetät Rivyassa kuva-, video- tai audiogenerointitehtävän.

Se selittää tehtävän tilat, krediittivarauksen, palveluntarjoajan valmistumisen, historian, ilmoitukset ja epäonnistuneiden tehtävien käsittelyn yhdessä paikassa.

Todelliset tehtävätilat

Nykyinen asynkroninen generoinnin elinkaari käyttää neljää näkyvää tilaa:

  • WAITING

  • GENERATING

  • SUCCESS

  • FAILED

Nämä tilat tallennetaan ai_task-tietueeseen ja niitä käytetään uudelleen Studiossa, historiassa, hallintapaneelissa ja ilmoitusvirrassa.

Mitä tapahtuu, kun lähetät tehtävän

1. Rivya validoi pyynnön

Ennen kuin mikään päätyy palveluntarjoajalle, Rivya tarkistaa:

  • malli on olemassa

  • suora generointi on käytössä kyseiselle mallille

  • suoritusmalli perustuu asynkronisiin tehtäviin

  • promptin pituus on kelvollinen

  • lomakeparametrit normalisoidaan

  • viitetiedostot vastaavat sitä, mitä malli hyväksyy

Joillakin malleilla on lisäsääntöjä. Esimerkiksi audioeristys vaatii ladatun audiotiedoston sekä keston varmistuksen.

2. Rivya luo tehtävätietueen

Rivya luo ensin ai_task-merkinnän tilalla WAITING.

Tietue tallentaa mallin, kategorian, promptin, parametrit, varatut krediitit, laskutustyypin ja myöhemmin tuloksen tai epäonnistumistilan.

3. Krediitit kulutetaan ennen palveluntarjoajalle lähetystä

Tämä on tärkeää: asynkronisessa generoinnissa Rivya käyttää tehtävän krediitit ennen kuin työ lähetetään taustapalveluun.

Jos krediittejä on liian vähän:

  • tehtävä merkitään epäonnistuneeksi

  • taustapalvelua ei koskaan kutsuta

  • riittämättömistä krediiteistä voidaan luoda ilmoitus

4. Palveluntarjoajan työ luodaan

Jos krediittejä on saatavilla, Rivya lähettää tehtävän vastaavaan taustapalveluun ja tallentaa taustapalvelun tehtävätunnuksen.

Tässä vaiheessa tila muuttuu arvoon GENERATING.

Miten Rivya saa tuloksen

Rivya tukee kahta valmistumispolkua:

  • palveluntarjoajan takaisinsoitto ympäristöissä, joissa takaisinsoitot ovat käytössä

  • tilan päivitys ja tilakyselyt, kun valmistumisesta ei saada takaisinsoittoa

Takaisinsoittopolku varmistaa myös webhook-allekirjoituksen ennen tehtävän viimeistelyä.

Jos takaisinsoitto saapuu ennen kuin palveluntarjoajan tulos on täysin valmis, Rivya voi lykätä käsittelyä ja yrittää uudelleen tarkistamalla taustapalvelun tilan.

Onnistumispolku

Onnistumisessa Rivya:

  • tallentaa tulos-URL:t

  • asettaa tilaksi SUCCESS

  • selvittää tehtävän

  • tekee tuotoksen saatavaksi generointihistoriassa

  • luo generoinnin onnistumisilmoituksen

Siksi valmis kuva tai video pysyy näkyvissä sen jälkeen, kun poistut sivulta.

Epäonnistumispolku

Epäonnistumisessa Rivya:

  • tallentaa virheilmoituksen

  • asettaa tilaksi FAILED

  • hyvittää krediitit, kun epäonnistuminen tapahtui varauksen jälkeen ja se pitää perua

  • luo generoinnin epäonnistumisilmoituksen pysyvää tarkistusta varten

Tämä eroaa väliaikaisesta ponnahdusviestistä. Epäonnistumisesta tulee osa tilin tietuetta.

Missä tehtävän tila näkyy

Sama tehtävä voi näkyä useassa paikassa:

  • aktiivisessa Studiossa, kun se on käynnissä

  • Historia-sivulla sen jälkeen, kun se ratkeaa

  • Ilmoituskeskus tärkeille lopputuloksille

  • /dashboard-sivun viimeaikaisissa generoinneissa

Tämä jaettu tila on yksi syy siihen, että tuote tuntuu yhtenäiseltä eikä kertakäyttöiseltä.

Miten Chat eroaa

Chat on myös laskutettavaa, mutta se ei käytä samaa asynkronista tehtävätietuetta. Chat-vuorot tallennetaan:

  • chat-istuntoina

  • chat-viesteinä

Token-pohjaisissa chat-malleissa Rivya voi varata krediitit ensin ja selvittää lopullisen määrän vasta, kun käyttö palaa. Jos lopullinen määrä on pienempi, erotus hyvitetään.

Laaja sääntö on siis:

  • kuva-, video- ja audiogenerointi käyttävät ai_task-tietuetta

  • chat käyttää tallennettuja istuntoja ja viestitason selvitystä

Lue seuraavaksi

Tehtävän tilan tarkistuslista

Kun generointi on epäselvä, hidas, epäonnistunut tai puuttuu, tarkista:

  • Tunnista ensin tehtävän tyyppi: chat-selvitys, kuva, video, audio tai työkalutaustainen chat.

  • Tarkista, varattiinko krediitit ennen palveluntarjoajalle lähetystä vai selvitettiinkö ne käytön jälkeen.

  • Etsi palveluntarjoajan takaisinsoitto, tilakyselyn tulos, historiakohde ja ilmoitus ennen kuin oletat tuloksen kadonneen.

  • Erota käyttäjän korjattavissa olevat epäonnistumiset palveluntarjoajan tai infrastruktuurin epäonnistumisista.

  • Varmista, pitäisikö epäonnistuneen tehtävän palauttaa krediitit ennen saman promptin ajamista uudelleen.

Tarkista ennen uutta ajoa

Tarkista uudelleen, kun sama prompti epäonnistuu jatkuvasti, tehtävä pysyy liian pitkään käynnissä, krediitit näyttävät kuluneen ilman tuotosta tai olet lähettämässä raskaampaa duplikaattiajoa.