Pilih antara Rivya API dan Studio dengan melihat pengulangan, kebutuhan tinjauan, kepastian model, kredit, berkas, webhooks, dan kepemilikan tim.
Produk
Dipublikasikan 12 Mei 2026Terakhir ditinjau 29 Agustus 2026Penulis:Tim Produk Rivya
Kesalahan termudah adalah memperlakukan Rivya API dan Rivya Studio sebagai dua jalur yang saling bersaing.
Lebih tepat memahaminya sebagai dua tahap dari produk yang sama. Studio adalah tempat orang mengeksplorasi, memilih, meninjau, dan melanjutkan pekerjaan secara visual. API adalah tempat alur kerja yang sudah stabil menjadi bagian dari produk lain, skrip, atau proses backend.
Perbandingan ini menjelaskan kontrak API yang telah diterapkan. Sisi API hanya berlaku ketika Public API dan fitur yang dirujuk, seperti webhook, aktif untuk penerapan dan tersedia bagi akun.
Jika Anda masih mempelajari permukaan API, mulai dari Apa Itu Rivya API?. Halaman ini lebih sempit: cara memutuskan apakah tugas tertentu termasuk ke Studio atau API.
Keputusan Dalam Satu Tabel
Pertanyaan
Gunakan Studio ketika...
Gunakan API ketika...
Apakah hasil masih eksploratif?
ya
tidak, alur kerja sudah dapat diulang
Apakah seseorang perlu membandingkan hasil?
ya
hanya setelah aplikasi Anda menerima hasil
Apakah pilihan model stabil?
belum
ya, atau dipilih dari daftar model API
Apakah tugas membutuhkan media referensi?
seseorang masih menyiapkannya
aplikasi Anda dapat mengunggahnya melalui Files API
Apakah hasil harus memperbarui sistem lain?
belum
ya, melalui pemeriksaan berkala atau webhook yang aktif
Apakah penggunaan kredit perlu tetap terlihat?
ya, saat testing
ya, tetapi lewat kontrol API tingkat akun
Ini bukan tentang permukaan mana yang lebih canggih. Ini tentang apakah tugas sudah siap diautomasi.
Gunakan Studio Saat Pekerjaan Masih Berubah
Studio adalah tempat yang tepat ketika keputusan manusia masih menjadi pekerjaan utama.
memilih antara model gambar, video, audio, atau chat
menguji apakah arah prompt layak dipertahankan
membandingkan hasil visual berdampingan
memutuskan apakah media referensi membantu atau mengganggu
memakai riwayat tersimpan untuk melanjutkan dari hasil sebelumnya
Ini terutama benar untuk pekerjaan kreatif. Jika ringkasan kreatif belum stabil, mengotomasi permintaan biasanya membuat kebingungan lebih cepat, bukan lebih kecil.
Gunakan API Saat Alur Kerja Dapat Diulang
API menjadi jalur yang lebih baik ketika masukan dan langkah berikutnya sudah cukup dapat diprediksi.
Tanda yang baik:
produk Anda sudah tahu model atau kategori model yang dibutuhkan
masukan pengguna dapat dipetakan ke permintaan body yang stabil
pekerjaan backend dapat melakukan pemeriksaan berkala status tanpa seseorang menatap layar
webhook aktif dapat memperbarui catatan yang tepat setelah tugas selesai
aplikasi dapat menjelaskan penggunaan kredit kepada tim atau pemilik akun
Pada titik itu, memakai Studio untuk setiap proses dapat menjadi jalur yang lebih lambat. API memungkinkan produk Anda memulai tugas secara langsung.
Batas Praktis: Penemuan Versus Integrasi
Gunakan Studio untuk penemuan.
Gunakan API untuk integrasi.
Penemuan berarti:
"Model mana yang harus kita gunakan?"
"Bentuk prompt apa yang bekerja?"
"Apakah media referensi memperbaiki tugas ini?"
"Apakah kualitas hasil cukup baik untuk use case ini?"
Integrasi berarti:
"Aksi pengguna ini harus membuat satu pekerjaan generasi."
"Pekerjaan ini harus dicoba ulang secara idempotent."
"File ini harus diunggah dan dilampirkan ke permintaan model."
"Tugas yang selesai ini harus memperbarui catatan produk kami."
Batas itu menjaga API agar tidak berubah menjadi permukaan eksperimen tersembunyi.
Bagaimana Kredit Mempengaruhi Keputusan
Penggunaan Studio dan API sama-sama mengambil kredit dari akun Rivya yang sama.
Artinya perilaku kredit harus menjadi bagian dari desain produk, bukan renungan setelahnya.
Gunakan Studio lebih dulu ketika tim masih perlu mempelajari bentuk biaya. Gunakan API ketika tugas sudah cukup stabil sehingga produk dapat menjelaskan kapan kredit mungkin dicadangkan atau dikonsumsi.
Untuk aturan publik saat ini, baca Kredit API. Jika alur kerja terlalu mahal untuk dijelaskan kepada pemilik akun, alur kerja itu belum siap untuk otomasi API.
Di Mana File Mengubah Pilihan
Media referensi sering menjadi titik ketika integrasi menjadi lebih serius.
Di Studio, seseorang dapat mengunggah, memeriksa, mencoba ulang, dan memutuskan apakah berkas cukup baik. Di API, produk Anda perlu menangani jalur berkas secara sengaja melalui Files API.
Gunakan Studio ketika:
gambar, video, atau audio referensi masih membutuhkan pembersihan manusia
tim belum yakin referensi mana yang harus memandu model
aturan berkas belum jelas bagi pengguna
Gunakan API ketika:
aplikasi dapat mengumpulkan berkas dengan aman
kebutuhan referensi model sudah diketahui
berkas dapat diunggah sebelum permintaan generasi atau chat
kesalahan dapat ditampilkan di produk Anda sendiri tanpa menyembunyikan apa yang terjadi
Files API adalah jembatan yang berguna, tetapi tidak menghapus kebutuhan untuk merancang pengalaman berkas.
Di Mana Chat Mengubah Pilihan
Chat dapat berada di kedua sisi.
Gunakan Rivya Chat langsung ketika seseorang sedang mengeksplorasi, menulis, meninjau, atau memutuskan.
Gunakan Chat API ketika giliran chat perlu hidup di dalam produk atau alur kerja server Anda sendiri. Itu dapat mencakup giliran non-aliran langsung, SSE aliran langsung opsional, sesi yang dibuat API, dan lampiran berkas yang didukung.
Pertanyaan kuncinya adalah tempat percakapan seharusnya hidup. Jika percakapan adalah bagian dari pekerjaan Rivya, gunakan Rivya. Jika percakapan adalah bagian dari pengalaman produk Anda, gunakan API.
Kapan Webhooks Menjadi Sinyal
Jika alur memerlukan API Webhooks, biasanya alur itu telah melewati tahap Studio manual. Pastikan webhook aktif untuk penerapan sebelum menjadikannya bagian desain produksi.
Webhooks berguna ketika sistem lain perlu merespons tugas generasi yang selesai:
menandai aset sebagai siap
memberi tahu pengguna
memajukan langkah tinjauan
memindahkan tugas gagal ke dukungan atau logika coba ulang
Itu pekerjaan integrasi. Studio masih dapat berguna untuk menguji jalur model, tetapi siklus produksi berada di API.
Pola Migrasi Yang Aman
Jangan pindahkan seluruh alur kerja ke API sekaligus.
Gunakan urutan ini:
uji tugas secara manual di Studio
catat model stabil, bentuk prompt, berkas masukan, dan hasil yang diharapkan