Kesilapan paling mudah ialah menganggap Rivya API dan Rivya Studio sebagai laluan yang bersaing.
Lebih baik memahaminya sebagai dua tahap dalam produk yang sama. Studio ialah tempat manusia meneroka, memilih, menyemak, dan meneruskan kerja secara visual. API ialah tempat aliran kerja yang stabil menjadi sebahagian daripada produk, skrip, atau proses backend lain.
Jika anda masih mempelajari permukaan API, mula dengan Apakah Rivya API?. Halaman ini lebih sempit: cara memutuskan sama ada tugas tertentu patut berada dalam Studio atau dalam API.
Keputusan Dalam Satu Jadual
| Soalan | Gunakan Studio apabila... | Gunakan API apabila... |
|---|---|---|
| Adakah output masih bersifat penerokaan? | ya | tidak, aliran kerja sudah boleh diulang |
| Adakah seseorang perlu membandingkan hasil? | ya | hanya selepas aplikasi anda menerima hasil |
| Adakah pilihan model sudah stabil? | belum | ya, atau dipilih daripada senarai model API |
| Adakah tugas memerlukan media rujukan? | seseorang masih menyediakannya | aplikasi anda boleh memuat naiknya melalui Files API |
| Adakah hasil perlu mengemas kini sistem lain? | belum | ya, melalui polling atau webhooks |
| Adakah penggunaan kredit perlu kekal kelihatan? | ya, semasa ujian | ya, tetapi melalui kawalan API peringkat akaun |
Ini bukan tentang permukaan mana yang lebih maju. Ini tentang sama ada tugas itu sudah bersedia untuk diautomasi.
Gunakan Studio Selagi Kerja Masih Berubah
Studio ialah tempat yang betul apabila keputusan manusia masih menjadi kerja utama.
Ini termasuk:
memilih antara model image, video, audio, atau chat
menguji sama ada arah prompt wajar dikekalkan
membandingkan hasil visual sebelah-menyebelah
memutuskan sama ada media rujukan membantu atau mengganggu
menggunakan history tersimpan untuk meneruskan daripada hasil sebelumnya
Ini sangat benar untuk kerja kreatif. Jika brief belum stabil, mengautomasikan permintaan biasanya menjadikan kekeliruan bergerak lebih cepat, bukan menjadi lebih kecil.
Gunakan API Apabila Aliran Kerja Boleh Diulang
API menjadi laluan yang lebih baik apabila input dan langkah seterusnya sudah cukup boleh diramal.
Tanda yang baik:
produk anda sudah tahu model atau kategori model yang diperlukan
input pengguna boleh dipetakan kepada request body yang stabil
kerja backend boleh melakukan polling status tanpa seseorang menatap skrin
webhook boleh mengemas kini rekod yang betul apabila tugas selesai
aplikasi boleh menerangkan penggunaan kredit kepada pasukan atau pemilik akaun
Pada ketika itu, menggunakan Studio untuk setiap percubaan boleh menjadi laluan yang lebih perlahan. API membolehkan produk anda memulakan tugas secara langsung.
Sempadan Praktikal: Penemuan Berbanding Integrasi
Gunakan Studio untuk penemuan.
Gunakan API untuk integrasi.
Penemuan bermaksud:
"Model mana patut kita gunakan?"
"Bentuk prompt apa yang berfungsi?"
"Adakah media rujukan memperbaiki tugas ini?"
"Adakah kualiti output cukup baik untuk kes penggunaan ini?"
Integrasi bermaksud:
"Tindakan pengguna ini patut mencipta satu tugas penjanaan."
"Tugas ini patut dicuba semula secara idempotent."
"Fail ini patut dimuat naik dan dilampirkan kepada permintaan model."
"Tugas yang selesai ini patut mengemas kini rekod produk kami."
Sempadan itu menghalang API daripada menjadi permukaan eksperimen yang tersembunyi.
Cara Kredit Patut Mempengaruhi Keputusan
Penggunaan Studio dan API sama-sama menggunakan kredit akaun Rivya yang sama.
Ini bermaksud tingkah laku kredit patut menjadi sebahagian daripada reka bentuk produk, bukan perkara tambahan selepas itu.
Gunakan Studio dahulu apabila pasukan masih perlu mempelajari bentuk kos. Gunakan API apabila tugas cukup stabil sehingga produk boleh menerangkan bila kredit mungkin ditempah atau digunakan.
Untuk peraturan awam semasa, baca Kredit API. Jika aliran kerja terlalu mahal untuk diterangkan kepada pemilik akaun, ia belum sedia untuk automasi API.
Di Mana Fail Mengubah Pilihan
Media rujukan sering menjadi tempat integrasi menjadi lebih serius.
Dalam Studio, seseorang boleh memuat naik, memeriksa, mencuba semula, dan menentukan sama ada fail cukup baik. Dalam API, produk anda perlu mengendalikan laluan fail dengan sengaja melalui Files API.
Gunakan Studio apabila:
imej, video, atau audio rujukan masih memerlukan pembersihan manusia
pasukan belum pasti rujukan mana yang patut membimbing model
peraturan fail belum jelas kepada pengguna
Gunakan API apabila:
aplikasi boleh mengumpulkan fail dengan selamat
keperluan rujukan model diketahui
fail boleh dimuat naik sebelum permintaan penjanaan atau chat
ralat boleh ditunjukkan dalam produk anda sendiri tanpa menyembunyikan apa yang berlaku
Files API ialah jambatan yang berguna, tetapi ia tidak menghapuskan keperluan untuk mereka bentuk pengalaman fail.
Di Mana Chat Mengubah Pilihan
Chat boleh berada di kedua-dua sisi.
Gunakan Rivya Chat secara langsung apabila seseorang sedang meneroka, menulis, menyemak, atau membuat keputusan.
Gunakan Chat API apabila giliran chat perlu berada dalam produk anda sendiri atau aliran kerja server. Itu boleh merangkumi giliran bukan streaming, streaming SSE pilihan, sesi yang dicipta API, dan lampiran fail yang disokong.
Soalan utamanya ialah tempat perbualan itu patut hidup. Jika perbualan itu sebahagian daripada kerja Rivya, gunakan Rivya. Jika perbualan itu sebahagian daripada pengalaman produk anda, gunakan API.
Bila Webhooks Menjadi Isyarat
Jika aliran kerja anda memerlukan API Webhooks, ia mungkin sudah melepasi tahap Studio manual.
Webhooks berguna apabila sistem lain perlu bertindak balas terhadap tugas penjanaan yang selesai:
menandakan aset sebagai sedia
memberitahu pengguna
menggerakkan langkah semakan ke hadapan
memindahkan tugas gagal ke sokongan atau logik cuba semula
Itu kerja integrasi. Studio masih berguna untuk menguji laluan model, tetapi gelung produksi berada dalam API.
Pola Migrasi Yang Selamat
Jangan pindahkan seluruh aliran kerja ke API sekaligus.
Gunakan urutan ini:
uji tugas secara manual dalam Studio
catat model stabil, bentuk prompt, fail input, dan hasil yang dijangka
baca API Models dan rujukan model
hantar satu penjanaan melalui API Quickstart
tambah Files API hanya jika model memerlukan media rujukan
tambah Webhooks hanya selepas polling berfungsi
tambah Chat API hanya jika produk memerlukan giliran chat di luar Studio
Setiap langkah patut menjadikan aliran kerja lebih mudah dioperasikan, bukan sekadar lebih automatik.
Bila Perlu Kekal Dalam Studio
Kekal dalam Studio apabila tugas masih memerlukan:
semakan subjektif
pembentukan prompt
perbandingan visual
penerokaan model
history kreatif tersimpan
seseorang menentukan sama ada langkah seterusnya ialah image, video, audio, atau chat
Itu bukan kelemahan. Studio direka untuk tahap itu.
Bila Perlu Beralih Ke API
Beralih ke API apabila:
tugas yang sama berulang dengan kerap
input boleh distrukturkan
model diketahui
aplikasi perlu mencipta tugas daripada UI sendiri
status, ralat, dan kredit boleh dikendalikan dengan jelas
polling atau webhooks sesuai dengan backend produk
API paling kuat apabila ia menukar aliran kerja Rivya yang sudah difahami menjadi tindakan produk yang boleh dipercayai.
Langkah Seterusnya Dalam Rivya
Gunakan Developers untuk pratonton permukaan API.
Baca Rivya API Quickstart sebelum menulis kod produksi.
Baca API Authentication sebelum menyimpan API key.
Baca Cara Membina Aliran Kerja AI Multimodal dengan Rivya API jika soalan seterusnya ialah cara menghubungkan model, fail, chat, dan webhooks.
Gunakan Menggerakkan Kerja Merentas Rivya Chat, Image, Video, Audio jika projek masih berada dalam kerja Studio yang dipimpin manusia.
