Rivya AI -dokumentaatio

Rivyan tehtävän elinkaaren opas

Ymmärrä Rivyan tehtävän tila, kreditivaraus, palveluntarjoajalle lähetys, callbackit, polling, historia, ilmoitukset, epäonnistumiset ja kreditit.

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, kreditivarauksen, 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, dashboardissa 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
  • runtime perustuu async task -malliin
  • 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 kreditit, laskutustyypin ja myöhemmin tuloksen tai epäonnistumistilan.

3. Kreditit kulutetaan ennen palveluntarjoajalle lähetystä

Tämä on tärkeää: asynkronisessa generoinnissa Rivya käyttää tehtävän kreditit ennen kuin työ lähetetään upstream-palveluun.

Jos kredittejä on liian vähän:

  • tehtävä merkitään epäonnistuneeksi
  • upstream-palvelua ei koskaan kutsuta
  • riittämättömistä krediteistä voidaan luoda ilmoitus

4. Palveluntarjoajan työ luodaan

Jos kredittejä on saatavilla, Rivya lähettää tehtävän vastaavaan upstream-palveluun ja tallentaa upstream-tehtävän ID:n.

Tässä vaiheessa tila muuttuu arvoon GENERATING.

Miten Rivya saa tuloksen

Rivya tukee kahta valmistumispolkua:

  • palveluntarjoajan callback ympäristöissä, joissa callbackit ovat käytössä
  • tilan päivitys ja polling, kun callback-valmistuminen ei ole saatavilla

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

Jos callback saapuu ennen kuin palveluntarjoajan tulos on täysin valmis, Rivya voi lykätä käsittelyä ja yrittää uudelleen tarkistamalla upstream-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ää kreditit, kun epäonnistuminen tapahtui varauksen jälkeen ja se pitää perua
  • luo generoinnin epäonnistumisilmoituksen pysyvää tarkistusta varten

Tämä eroaa väliaikaisesta toast-viestistä. 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 kreditit 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 kreditit ennen palveluntarjoajalle lähetystä vai selvitettiinkö ne käytön jälkeen.
  • Etsi palveluntarjoajan callback, polling-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 kreditit 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ä, kreditit näyttävät kuluneen ilman tuotosta tai olet lähettämässä raskaampaa duplikaattiajoa.

Sisällysluettelo