Jurnal Rivya
Penulis
Kategori
Daftar Isi
Terus jelajahi
Lanjutkan dengan panduan terkait, catatan produk, dan uraian workflow dari tim 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.
| 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.
Studio adalah tempat yang tepat ketika keputusan manusia masih menjadi pekerjaan utama.
Itu mencakup:
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.
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.
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.
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.
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.
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.
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.
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
baca Model API dan referensi model
kirim satu generasi melalui Mulai cepat Rivya API
tambahkan Files API hanya jika model membutuhkan media referensi
tambahkan Webhooks hanya setelah pemeriksaan berkala berjalan dan akses webhook diaktifkan
tambahkan Chat API hanya jika produk membutuhkan giliran chat di luar Studio
Setiap langkah harus membuat alur kerja lebih mudah dioperasikan, bukan hanya lebih otomatis.
Tetap di Studio ketika tugas masih membutuhkan:
tinjauan subjektif
pembentukan prompt
perbandingan visual
eksplorasi model
riwayat kreatif tersimpan
seseorang yang memutuskan apakah langkah berikutnya adalah gambar, video, audio, atau chat
Itu bukan kelemahan. Studio memang dirancang untuk tahap itu.
Pindah ke API ketika:
tugas yang sama sering berulang
masukan dapat distrukturkan
model diketahui
aplikasi perlu membuat tugas dari UI sendiri
status, kesalahan, dan kredit dapat ditangani dengan jelas
pemeriksaan berkala, atau webhook jika aktif, sesuai dengan backend produk
API paling kuat ketika mengubah alur kerja Rivya yang sudah dipahami menjadi aksi produk yang andal.
Gunakan Pengembang untuk melihat pratinjau permukaan API.
Baca Mulai cepat Rivya API sebelum menulis kode produksi.
Baca Autentikasi API sebelum menyimpan API kunci.
Baca Cara Membangun Alur Kerja AI Multimodal dengan Rivya API jika pertanyaan berikutnya adalah cara menghubungkan model, berkas, chat, dan webhooks.
Gunakan Memindahkan Pekerjaan Lintas Rivya Chat, Image, Video, Audio jika proyek masih termasuk pekerjaan Studio yang dipimpin manusia.
