Pahami status tugas Rivya, reservasi kredit, pengiriman ke penyedia, callback, polling, riwayat, notifikasi, kegagalan, dan kredit.

Gunakan panduan ini ketika Anda perlu memahami apa yang terjadi setelah mengirim tugas generasi gambar, video, atau audio di Rivya.

Panduan ini menjelaskan status tugas, reservasi kredit, penyelesaian penyedia, history, notifikasi, dan penanganan tugas gagal dalam satu tempat.

Status Tugas Yang Sebenarnya

Siklus hidup generasi asinkron saat ini memakai empat status yang terlihat:

WAITING
GENERATING
SUCCESS
FAILED

Status tersebut disimpan di ai_task dan dipakai ulang di alur Studio, history, dashboard, dan notifikasi.

Apa Yang Terjadi Saat Anda Mengirim

1. Rivya memvalidasi permintaan

Sebelum apa pun mencapai penyedia, Rivya memeriksa:

model ada
generasi langsung diaktifkan untuk model tersebut
runtime berbasis tugas asinkron
panjang prompt valid
parameter form dinormalisasi
file referensi cocok dengan yang diterima model

Beberapa model memiliki aturan tambahan. Misalnya, isolasi audio membutuhkan file audio yang diunggah plus verifikasi durasi.

2. Rivya membuat catatan tugas

Rivya membuat entri ai_task terlebih dahulu, dengan status WAITING.

Catatan itu menyimpan model, kategori, prompt, params, kredit yang direservasi, tipe penagihan, dan nanti status hasil atau kegagalan.

3. Kredit dikonsumsi sebelum pengiriman ke penyedia

Ini penting: untuk generasi asinkron, Rivya membelanjakan kredit tugas sebelum mengirim pekerjaan ke upstream.

Jika kredit terlalu rendah:

tugas ditandai gagal
layanan upstream tidak pernah dipanggil
notifikasi kredit tidak cukup dapat dibuat

4. Pekerjaan penyedia dibuat

Jika kredit tersedia, Rivya mengirim tugas ke layanan upstream yang cocok dan menyimpan ID tugas upstream.

Pada titik itu status berpindah ke GENERATING.

Bagaimana Rivya Mengetahui Hasilnya

Rivya mendukung dua jalur penyelesaian hasil:

callback penyedia di lingkungan yang mendukung callback
refresh status dan polling ketika penyelesaian callback tidak tersedia

Jalur callback juga memverifikasi tanda tangan webhook sebelum memfinalkan tugas.

Jika callback tiba sebelum hasil penyedia benar-benar siap, Rivya dapat menunda dan mencoba lagi dengan memeriksa status upstream.

Jalur Sukses

Saat sukses, Rivya:

menyimpan URL hasil
mengatur status ke SUCCESS
menyelesaikan tugas
membuat output tersedia di history generasi
membuat notifikasi generation-success

Itulah mengapa gambar atau video yang selesai tetap terlihat setelah Anda meninggalkan halaman.

Jalur Gagal

Saat gagal, Rivya:

menyimpan pesan error
mengatur status ke FAILED
mengembalikan kredit ketika kegagalan terjadi setelah reservasi dan memang harus dibalik
membuat notifikasi generation-failed untuk review yang tahan lama

Ini berbeda dari toast sementara. Kegagalan menjadi bagian dari catatan akun.

Di Mana Anda Melihat Status Tugas

Tugas yang sama dapat muncul di beberapa tempat:

Studio aktif saat masih berjalan
Panduan Riwayat Rivya setelah selesai
Panduan Notifications Center Rivya untuk hasil besar
/dashboard di generasi terbaru

Status bersama itu adalah salah satu alasan produk terasa koheren, bukan sekali pakai.

Bagaimana Chat Berbeda

Chat juga dapat ditagih, tetapi tidak memakai catatan async task yang sama. Giliran chat disimpan sebagai:

sesi chat
pesan chat

Untuk model chat berbasis token, Rivya dapat mereservasi kredit lebih dulu lalu menyelesaikan jumlah akhir setelah data penggunaan masuk. Jika jumlah akhir lebih rendah, selisihnya dikembalikan.

Jadi aturan besarnya adalah:

generasi gambar, video, dan audio memakai ai_task
chat memakai sesi tersimpan dan penyelesaian biaya tingkat pesan

Baca Berikutnya

Daftar Periksa Status Tugas

Ketika generasi terasa membingungkan, lambat, gagal, atau hilang, periksa:

Identifikasi tipe tugas terlebih dahulu: settlement chat, gambar, video, audio, atau chat berbasis tool.
Periksa apakah kredit direservasi sebelum pengiriman penyedia atau diselesaikan setelah penggunaan.
Cari callback penyedia, hasil polling, item history, dan notifikasi sebelum menganggap hasilnya hilang.
Pisahkan kegagalan yang bisa diperbaiki pengguna dari kegagalan penyedia atau infrastruktur.
Pastikan apakah tugas gagal harus membalik kredit sebelum menjalankan ulang prompt yang sama.

Periksa Ulang Sebelum Menjalankan Lagi

Periksa ulang ketika prompt yang sama terus gagal, tugas terlalu lama berada dalam progres, kredit terlihat terkonsumsi tanpa output, atau Anda akan mengirim run duplikat yang lebih berat.

Panduan Siklus Hidup Tugas Rivya