Rivya AI Dokümanları

Rivya Görev Yasam Dongusu Rehberi

Rivya görev durumunu, kredi ayirmayi, saglayiciya gonderimi, geri cagirmalari, yoklamayi, geçmişi, bildirimleri, hatalari ve kredileri anlayin.

Son inceleme 2026/04/28

Rivya'da bir görsel, video veya ses üretim görevi gonderdikten sonra ne oldugunu anlamaniz gerektiginde bu rehberi kullanin.

Görev durumlarini, kredi ayirmayi, saglayici tamamlamasini, geçmişi, bildirimleri ve basarisiz görev islemeyi tek yerde aciklar.

Gerçek Görev Durumlari

Güncel async üretim yasam dongusu dort görünür durum kullanir:

  • WAITING
  • GENERATING
  • SUCCESS
  • FAILED

Bu durumlar ai_task uzerinde saklanir ve Studio, geçmiş, panel ve bildirim akisinda yeniden kullanilir.

Gonderdiginizde Ne Olur

1. Rivya isteği dogrular

Bir saglayiciya herhangi bir sey ulasmadan önce Rivya şunları kontrol eder:

  • modelin var oldugunu
  • bu model için doğrudan uretimin etkin oldugunu
  • runtime'in async görev tabanli oldugunu
  • prompt uzunlugunun gecerli oldugunu
  • form parametrelerinin normallestirildigini
  • referans dosyalarin modelin kabul ettikleriyle eslestigini

Bazi modellerin ek kurallari vardir. Ornegin ses izolasyonu, yüklenen bir ses dosyasi ve süre dogrulamasi gerektirir.

2. Rivya görev kaydini olusturur

Rivya önce WAITING durumuyla bir ai_task girdisi olusturur.

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

3. Krediler saglayiciya gonderimden önce tuketilir

Bu önemlidir: async üretim için Rivya, işi ust servise gondermeden önce görev kredilerini harcar.

Krediler çok dusukse:

  • görev basarisiz olarak isaretlenir
  • ust servis hic cagrilmaz
  • yetersiz kredi bildirimi olusturulabilir

4. Saglayici işi olusturulur

Krediler varsa Rivya görevi eslesen ust servise gonderir ve ust görev 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 görevi sonlandirmadan önce webhook imzasini da dogrular.

Saglayici sonucu tam hazır 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
  • görevi kapatir
  • çıktıyı üretim gecmisinde kullanilabilir hale getirir
  • üretim basarisi bildirimi olusturur

Bu yuzden tamamlanmis bir görsel veya video sayfadan ayrildiktan sonra görünür 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 için üretim basarisiz bildirimi olusturur

Bu gecici bir toast'tan farklidir. Hata hesabin kaydinin parçası haline gelir.

Görev Durumunu Nerede Gorursunuz

Aynı görev birkac yerde gorunebilir:

Bu paylasilan durum, ürünün tek kullanimlik değil tutarlı hissettirmesinin nedenlerinden biridir.

Chat Nasil Farklidir

Chat de ucretlidir, ancak aynı async görev kaydini kullanmaz. Chat turlari şu sekilde saklanir:

  • sohbet oturumlari
  • sohbet mesajlari

Token tabanli chat modelleri için Rivya önce kredi ayirabilir ve sonra kullanım geri geldiginde son tutari kapatabilir. Son tutar daha dusukse fark iade edilir.

Bu nedenle genel kural sudur:

  • görsel, video ve ses üretimi ai_task kullanir
  • chat kayıtlı oturumlari ve mesaj duzeyinde kapatmayi kullanir

Sonraki Okuma

Görev Durumu Kontrol Listesi

Bir üretim kafa karistirici, yavas, basarisiz veya eksik oldugunda şunları kontrol edin:

  • Önce görev turunu belirleyin: chat kapatma, görsel, video, ses veya arac destekli chat.
  • Kredilerin saglayiciya gonderimden önce ayrilip ayrilmadigini ya da kullanımdan sonra kapatilip kapatilmadigini kontrol edin.
  • Sonucun kayboldugunu varsaymadan önce saglayici geri cagirmasini, yoklama sonucunu, geçmiş ogesini ve bildirimi arayin.
  • Kullanici tarafindan duzeltilebilir hatalari saglayici veya altyapi hatalarindan ayirin.
  • Aynı promptu yeniden çalıştırmadan önce basarisiz görevin kredileri geri cevirip cevirmemesi gerektigini doğrulayın.

Yeniden Çalıştırmadan Önce Kontrol Edin

Aynı prompt sürekli basarisiz oldugunda, bir görev çok uzun süre devam ediyor gorundugunde, krediler çıktı olmadan tuketilmis gibi durdugunda veya daha agir bir yinelenen çalıştırma gondermek uzereyseniz yeniden kontrol edin.

İçindekiler