সবচেয়ে সহজ ভুল হলো Rivya API এবং Rivya Studio-কে পরস্পরের প্রতিদ্বন্দ্বী পথ হিসেবে দেখা।
এগুলিকে একই পণ্যের দুই ধাপ হিসেবে ভাবাই ভালো। Studio হলো যেখানে মানুষ ভিজ্যুয়ালি পরীক্ষা করে, নির্বাচন করে, রিভিউ করে এবং কাজ এগিয়ে নেয়। API হলো যেখানে একটি স্থিতিশীল workflow অন্য পণ্য, script বা backend প্রক্রিয়ার অংশ হয়ে যায়।
আপনি যদি এখনও API surface শিখছেন, আগে What Is the Rivya API? পড়ুন। এই পাতার লক্ষ্য আরও নির্দিষ্ট: কোনো নির্দিষ্ট কাজ Studio-তে থাকা উচিত, নাকি API-তে যাওয়া উচিত তা ঠিক করা।
একটি টেবিলে সিদ্ধান্ত
| প্রশ্ন | Studio ব্যবহার করুন যখন... | API ব্যবহার করুন যখন... |
|---|---|---|
| output কি এখনও exploratory? | হ্যাঁ | না, workflow ইতিমধ্যে repeatable |
| একজন মানুষের কি ফলাফল তুলনা করতে হবে? | হ্যাঁ | শুধু আপনার app ফলাফল পাওয়ার পরে |
| model choice কি স্থিতিশীল? | এখনও নয় | হ্যাঁ, অথবা API model list থেকে নির্বাচিত |
| কাজের কি reference media দরকার? | মানুষ এখনও সেটি প্রস্তুত করছে | আপনার app Files API দিয়ে upload করতে পারে |
| result কি অন্য system update করতে হবে? | এখনও নয় | হ্যাঁ, polling বা webhooks দিয়ে |
| credit usage কি visible থাকতে হবে? | হ্যাঁ, testing চলাকালে | হ্যাঁ, তবে account-level API controls দিয়ে |
এটি কোন surface বেশি advanced, সে বিষয়ে নয়। প্রশ্ন হলো কাজটি automation-এর জন্য প্রস্তুত কি না।
কাজ এখনও বদলালে Studio ব্যবহার করুন
মানুষের সিদ্ধান্তই যখন এখনও মূল কাজ, তখন Studio সঠিক জায়গা।
এর মধ্যে আছে:
- image, video, audio অথবা chat model-এর মধ্যে বেছে নেওয়া
- কোনো prompt direction রাখা মূল্যবান কি না তা পরীক্ষা করা
- visual result পাশাপাশি তুলনা করা
- reference media সাহায্য করছে নাকি ক্ষতি করছে তা নির্ধারণ করা
- আগের result থেকে চালিয়ে যেতে saved history ব্যবহার করা
Creative কাজের ক্ষেত্রে এটি আরও সত্য। brief স্থিতিশীল না হলে request automate করা সাধারণত বিভ্রান্তি কমায় না; বরং সেটিকে দ্রুততর করে।
Workflow repeatable হলে API ব্যবহার করুন
input এবং পরের ধাপ যথেষ্ট predictable হলে API ভালো পথ হয়ে ওঠে।
ভালো সংকেত:
- আপনার product ইতিমধ্যে জানে কোন model বা model category প্রয়োজন
- user input একটি stable request body-তে map করা যায়
- backend job কাউকে screen দেখিয়ে না রেখে status poll করতে পারে
- task শেষ হলে webhook সঠিক record update করতে পারে
- app team বা account owner-কে credit usage ব্যাখ্যা করতে পারে
এই পর্যায়ে প্রতিবার Studio ব্যবহার করা ধীর পথ হয়ে যেতে পারে। API আপনার product-কে task সরাসরি শুরু করতে দেয়।
একটি বাস্তব boundary: Discovery বনাম Integration
Discovery-এর জন্য Studio ব্যবহার করুন।
Integration-এর জন্য API ব্যবহার করুন।
Discovery মানে:
- "কোন model ব্যবহার করব?"
- "কী prompt shape কাজ করে?"
- "reference media কি এই task উন্নত করে?"
- "এই use case-এর জন্য output quality যথেষ্ট কি?"
Integration মানে:
- "এই user action একটি generation job তৈরি করবে।"
- "এই job idempotently retry করা উচিত।"
- "এই file upload করে model request-এ attach করা উচিত।"
- "এই completed task আমাদের product record update করবে।"
এই boundary API-কে hidden experiment surface হয়ে যাওয়া থেকে আটকায়।
Credits কীভাবে সিদ্ধান্তে প্রভাব ফেলবে
Studio এবং API usage উভয়ই একই Rivya account credits থেকে খরচ হয়।
তাই credit behavior product design-এর অংশ হওয়া উচিত, পরে জোড়া লাগানো ব্যাখ্যা নয়।
team এখনও cost shape শিখলে প্রথমে Studio ব্যবহার করুন। task এতটাই stable হলে API ব্যবহার করুন যে product ব্যাখ্যা করতে পারে কখন credits reserve বা consume হতে পারে।
বর্তমান public rules-এর জন্য API Credits পড়ুন। কোনো workflow account owner-কে ব্যাখ্যা করার জন্য খুব ব্যয়বহুল হলে, সেটি এখনও API automation-এর জন্য প্রস্তুত নয়।
Files কোথায় সিদ্ধান্ত বদলায়
Reference media প্রায়ই integration-কে আরও serious করে তোলে।
Studio-তে একজন মানুষ upload, inspect, retry করতে পারে এবং file যথেষ্ট ভালো কি না সিদ্ধান্ত নিতে পারে। API-তে আপনার product-কে Files API দিয়ে file path সচেতনভাবে handle করতে হবে।
Studio ব্যবহার করুন যখন:
- reference image, video বা audio এখনও human cleanup চায়
- team নিশ্চিত নয় কোন reference model-কে guide করবে
- file rules এখনও user-এর কাছে পরিষ্কার নয়
API ব্যবহার করুন যখন:
- app নিরাপদে file collect করতে পারে
- model-এর reference requirements জানা
- generation বা chat request-এর আগে file upload করা যায়
- কী ঘটেছে তা লুকিয়ে না রেখে error আপনার product-এ দেখানো যায়
Files API একটি দরকারি bridge, কিন্তু এটি file experience design করার প্রয়োজন সরিয়ে দেয় না।
Chat কোথায় সিদ্ধান্ত বদলায়
Chat দুই দিকেই থাকতে পারে।
মানুষ যখন explore, write, review বা decide করছে, তখন সরাসরি Rivya Chat ব্যবহার করুন।
chat turn যদি আপনার নিজের product বা server workflow-এর ভিতরে থাকতে হয়, Chat API ব্যবহার করুন। এর মধ্যে non-streaming turns, optional SSE streaming, API-created sessions এবং supported file attachments থাকতে পারে।
মূল প্রশ্ন হলো conversation কোথায় থাকবে। conversation যদি Rivya work-এর অংশ হয়, Rivya ব্যবহার করুন। conversation যদি আপনার product experience-এর অংশ হয়, API ব্যবহার করুন।
Webhooks কখন signal
আপনার workflow যদি API Webhooks চায়, তাহলে সেটি সম্ভবত manual Studio stage পেরিয়ে গেছে।
অন্য system completed generation tasks-এ respond করতে চাইলে webhooks দরকারি:
- asset ready হিসেবে mark করা
- user-কে notify করা
- review step এগিয়ে নেওয়া
- failed task-কে support বা retry logic-এ পাঠানো
এটি integration work। model path পরীক্ষা করতে Studio এখনও দরকারি হতে পারে, কিন্তু production loop API-তে থাকা উচিত।
নিরাপদ migration pattern
পুরো workflow একবারে API-তে সরাবেন না।
এই sequence ব্যবহার করুন:
- Studio-তে task manually test করুন
- stable model, prompt shape, input files এবং expected result লিখে রাখুন
- API Models এবং model reference পড়ুন
- API Quickstart দিয়ে একটি generation submit করুন
- model reference media চাইলে তবেই Files API যোগ করুন
- polling কাজ করার পরে Webhooks যোগ করুন
- product যদি Studio-এর বাইরে chat turns চায় তবেই Chat API যোগ করুন
প্রতিটি ধাপ workflow চালানো সহজ করবে, শুধু বেশি automated করবে না।
কখন Studio-তেই থাকবেন
task এখনও এগুলো চাইলে Studio-তেই থাকুন:
- subjective review
- prompt shaping
- visual comparison
- model exploration
- saved creative history
- পরের ধাপ image, video, audio না chat হবে তা একজন মানুষের সিদ্ধান্ত
এটি দুর্বলতা নয়। Studio এই stage-এর জন্যই design করা।
কখন API-তে যাবেন
API-তে যান যখন:
- একই task প্রায়ই repeat হয়
- input structured করা যায়
- model জানা
- app-কে নিজের UI থেকে task তৈরি করতে হয়
- status, errors এবং credits পরিষ্কারভাবে handle করা যায়
- polling বা webhooks product backend-এর সঙ্গে fit করে
API সবচেয়ে শক্তিশালী তখন, যখন এটি আগে থেকেই বোঝা Rivya workflow-কে reliable product action-এ বদলে দেয়।
Rivya-তে পরের ধাপ
- API surface preview করতে Developers ব্যবহার করুন।
- production code লেখার আগে Rivya API Quickstart পড়ুন।
- API key সংরক্ষণের আগে API Authentication পড়ুন।
- পরের প্রশ্ন যদি models, files, chat এবং webhooks কীভাবে যুক্ত করবেন হয়, How to Build a Multimodal AI Workflow with Rivya API পড়ুন।
- project যদি এখনও human-led Studio work হয়, Moving Work Across Rivya Chat, Image, Video, Audio ব্যবহার করুন।
