Docs Rivya AI

Panduan Siklus Hidup Tugas Rivya

Pahami status tugas Rivya, reservasi kredit, pengiriman ke penyedia, panggilan balik, pemeriksaan berkala, riwayat, notifikasi, kegagalan, dan kredit.

Terakhir ditinjau pada 2026/08/29

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

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

Status Tugas Yang Sebenarnya

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

  • WAITING

  • GENERATING

  • SUCCESS

  • FAILED

Status tersebut disimpan di ai_task dan dipakai ulang di alur Studio, riwayat, dasbor, dan notifikasi.

Apa Yang Terjadi Saat Anda Mengirim

1. Rivya memvalidasi permintaan

Sebelum apa pun mencapai penyedia, Rivya memeriksa:

  • model ada

  • model saat ini tersedia

  • pembuatan langsung diaktifkan untuk model tersebut

  • runtime berbasis tugas asinkron

  • panjang prompt valid

  • parameter formulir dinormalisasi

  • berkas referensi cocok dengan yang diterima model

Sebagian model terdokumentasi memiliki aturan tambahan. Audio Isolation dahulu memerlukan berkas audio dan pemeriksaan durasi, tetapi saat ini tidak tersedia; Rivya seharusnya menolaknya di gerbang ketersediaan, bukan membuat tugas, menahan kredit, atau mencoba alur unggahan.

2. Rivya membuat catatan tugas

Rivya membuat entri ai_task terlebih dahulu, dengan status WAITING.

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

3. Kredit dikonsumsi sebelum pengiriman ke penyedia

Ini penting: untuk pembuatan asinkron, Rivya membelanjakan kredit tugas sebelum mengirim pekerjaan ke layanan hulu.

Jika kredit terlalu rendah:

  • tugas ditandai gagal

  • layanan hulu tidak pernah dipanggil

  • notifikasi kredit tidak cukup dapat dibuat

4. Pekerjaan penyedia dibuat

Jika model tersedia, generasi langsung aktif, dan kredit mencukupi, Rivya mengirim tugas ke layanan upstream yang sesuai dan menyimpan ID tugas upstream.

Pada titik itu status berpindah ke GENERATING.

Bagaimana Rivya Mengetahui Hasilnya

Rivya mendukung dua jalur penyelesaian hasil:

  • panggilan balik penyedia di lingkungan yang mendukung panggilan balik

  • penyegaran status dan pemeriksaan berkala ketika penyelesaian panggilan balik tidak tersedia

Jalur panggilan balik juga memverifikasi tanda tangan webhook sebelum memfinalkan tugas.

Jika panggilan balik tiba sebelum hasil penyedia benar-benar siap, Rivya dapat menunda dan mencoba lagi dengan memeriksa status hulu.

Jalur Sukses

Saat sukses, Rivya:

  • menyimpan URL hasil

  • mengatur status ke SUCCESS

  • menyelesaikan tugas

  • membuat keluaran tersedia di riwayat pembuatan

  • membuat notifikasi pembuatan-success

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

Jalur Gagal

Saat gagal, Rivya:

  • menyimpan pesan kesalahan

  • mengatur status ke FAILED

  • mengembalikan kredit ketika kegagalan terjadi setelah reservasi dan memang harus dibalik

  • membuat notifikasi pembuatan-failed untuk tinjauan yang tahan lama

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

Di Mana Anda Melihat Status Tugas

Tugas yang sama dapat muncul di beberapa tempat:

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

Bagaimana Chat Berbeda

Chat juga dapat ditagih, tetapi tidak memakai catatan tugas asinkron 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: penyelesaian biaya obrolan, gambar, video, audio, atau chat berbasis alat.

  • Pastikan model terpilih saat ini tersedia; halaman terdokumentasi bukan bukti bahwa tugas dapat dimulai.

  • Periksa apakah kredit direservasi sebelum pengiriman penyedia atau diselesaikan setelah penggunaan.

  • Cari panggilan balik penyedia, hasil pemeriksaan berkala, item riwayat, 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 proses, kredit terlihat terkonsumsi tanpa keluaran, atau Anda akan mengirim proses duplikat yang lebih berat.