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.
