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/08/29

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

  • modelin şu anda kullanılabilir olduğunu

  • bu model için doğrudan uretimin etkin oldugunu

  • çalışma zamanı'in async görev tabanli oldugunu

  • istem uzunlugunun gecerli oldugunu

  • form parametrelerinin normallestirildigini

  • referans dosyalarin modelin kabul ettikleriyle eslestigini

Belgelenmiş bazı modellerin ek kuralları vardır. Audio Isolation tarihsel olarak yüklenen bir ses dosyasıyla süre doğrulaması gerektiriyordu; ancak şu anda kullanılamaz. Rivya bunu kullanılabilirlik kapısında reddetmeli, görev oluşturmamalı, kredi ayırmamalı veya yükleme odaklı akışı denememelidir.

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

Model kullanılabilir, doğrudan üretim etkin ve krediler yeterliyse Rivya görevi eşleşen üst servise gönderir ve üst 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 sohbet 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

  • sohbet 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: sohbet kapatma, görsel, video, ses veya arac destekli sohbet.

  • Seçilen modelin şu anda kullanılabilir olduğunu doğrulayın; belgelenmiş bir sayfa görev başlatılabildiğini kanıtlamaz.

  • 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ı istem 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.