Rivya AI Dokümanları

Rivya Gorev Yasam Dongusu Rehberi

Rivya gorev durumunu, kredi ayirmayi, saglayiciya gonderimi, geri cagirmalari, yoklamayi, gecmisi, bildirimleri, hatalari ve kredileri anlayin.

Son inceleme 2026/04/28

Rivya'da bir gorsel, video veya ses uretim gorevi gonderdikten sonra ne oldugunu anlamaniz gerektiginde bu rehberi kullanin.

Gorev durumlarini, kredi ayirmayi, saglayici tamamlamasini, gecmisi, bildirimleri ve basarisiz gorev islemeyi tek yerde aciklar.

Gercek Gorev Durumlari

Guncel async uretim yasam dongusu dort gorunur durum kullanir:

  • WAITING
  • GENERATING
  • SUCCESS
  • FAILED

Bu durumlar ai_task uzerinde saklanir ve Studio, gecmis, panel ve bildirim akisinda yeniden kullanilir.

Gonderdiginizde Ne Olur

1. Rivya istegi dogrular

Bir saglayiciya herhangi bir sey ulasmadan once Rivya sunlari kontrol eder:

  • modelin var oldugunu
  • bu model icin dogrudan uretimin etkin oldugunu
  • runtime'in async gorev tabanli oldugunu
  • prompt uzunlugunun gecerli oldugunu
  • form parametrelerinin normallestirildigini
  • referans dosyalarin modelin kabul ettikleriyle eslestigini

Bazi modellerin ek kurallari vardir. Ornegin ses izolasyonu, yuklenen bir ses dosyasi ve sure dogrulamasi gerektirir.

2. Rivya gorev kaydini olusturur

Rivya once WAITING durumuyla bir ai_task girdisi olusturur.

Bu kayit modeli, kategoriyi, promptu, params'i, ayrilan kredileri, faturalandirma turunu ve daha sonra sonucu ya da hata durumunu saklar.

3. Krediler saglayiciya gonderimden once tuketilir

Bu onemlidir: async uretim icin Rivya, isi ust servise gondermeden once gorev kredilerini harcar.

Krediler cok dusukse:

  • gorev basarisiz olarak isaretlenir
  • ust servis hic cagrilmaz
  • yetersiz kredi bildirimi olusturulabilir

4. Saglayici isi olusturulur

Krediler varsa Rivya gorevi eslesen ust servise gonderir ve ust gorev ID'sini saklar.

Bu noktada durum GENERATING olur.

Rivya Sonucu Nasil Ogrenir

Rivya iki tamamlama yolunu destekler:

  • geri cagirma etkin ortamlarda saglayici geri cagirmasi
  • geri cagirma tamamlamasi kullanilamiyorsa durum yenileme ve yoklama

Geri cagirma yolu, bir gorevi sonlandirmadan once webhook imzasini da dogrular.

Saglayici sonucu tam hazir olmadan bir geri cagirma gelirse Rivya erteleyebilir ve ust durumu kontrol ederek tekrar deneyebilir.

Basari Yolu

Basari durumunda Rivya:

  • sonuc URL'lerini saklar
  • durumu SUCCESS olarak ayarlar
  • gorevi kapatir
  • ciktiyi uretim gecmisinde kullanilabilir hale getirir
  • uretim basarisi bildirimi olusturur

Bu yuzden tamamlanmis bir gorsel veya video sayfadan ayrildiktan sonra gorunur kalir.

Hata Yolu

Hata durumunda Rivya:

  • hata mesajini saklar
  • durumu FAILED olarak ayarlar
  • hata ayirmadan sonra olduysa ve geri alinmasi gerekiyorsa kredileri iade eder
  • kalici inceleme icin uretim basarisiz bildirimi olusturur

Bu gecici bir toast'tan farklidir. Hata hesabin kaydinin parcasi haline gelir.

Gorev Durumunu Nerede Gorursunuz

Ayni gorev birkac yerde gorunebilir:

Bu paylasilan durum, urunun tek kullanimlik degil tutarli hissettirmesinin nedenlerinden biridir.

Chat Nasil Farklidir

Chat de ucretlidir, ancak ayni async gorev kaydini kullanmaz. Chat turlari su sekilde saklanir:

  • sohbet oturumlari
  • sohbet mesajlari

Token tabanli chat modelleri icin Rivya once kredi ayirabilir ve sonra kullanim geri geldiginde son tutari kapatabilir. Son tutar daha dusukse fark iade edilir.

Bu nedenle genel kural sudur:

  • gorsel, video ve ses uretimi ai_task kullanir
  • chat kayitli oturumlari ve mesaj duzeyinde kapatmayi kullanir

Sonraki Okuma

Gorev Durumu Kontrol Listesi

Bir uretim kafa karistirici, yavas, basarisiz veya eksik oldugunda sunlari kontrol edin:

  • Once gorev turunu belirleyin: chat kapatma, gorsel, video, ses veya arac destekli chat.
  • Kredilerin saglayiciya gonderimden once ayrilip ayrilmadigini ya da kullanimdan sonra kapatilip kapatilmadigini kontrol edin.
  • Sonucun kayboldugunu varsaymadan once saglayici geri cagirmasini, yoklama sonucunu, gecmis ogesini ve bildirimi arayin.
  • Kullanici tarafindan duzeltilebilir hatalari saglayici veya altyapi hatalarindan ayirin.
  • Ayni promptu yeniden calistirmadan once basarisiz gorevin kredileri geri cevirip cevirmemesi gerektigini dogrulayin.

Yeniden Calistirmadan Once Kontrol Edin

Ayni prompt surekli basarisiz oldugunda, bir gorev cok uzun sure devam ediyor gorundugunde, krediler cikti olmadan tuketilmis gibi durdugunda veya daha agir bir yinelenen calistirma gondermek uzereyseniz yeniden kontrol edin.

İçindekiler