Docs Rivya AI

Panduan Siklus Hidup Tugas Rivya

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

Terakhir ditinjau pada 2026/04/28

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
  • pembuatan langsung diaktifkan untuk model tersebut
  • runtime berbasis tugas asinkron
  • panjang prompt valid
  • parameter formulir 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, 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 kredit tersedia, Rivya mengirim tugas ke layanan hulu yang cocok dan menyimpan ID tugas hulu.

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 polling 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 generation-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 generation-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.
  • Periksa apakah kredit direservasi sebelum pengiriman penyedia atau diselesaikan setelah penggunaan.
  • Cari panggilan balik penyedia, hasil polling, 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.

Daftar Isi