
Rivya Journal

लेखक
श्रेणियां
विषय सूची
खोजना जारी रखें
Rivya टीम से संबंधित मार्गदर्शिकाएं, उत्पाद नोट्स और कार्यप्रवाह विश्लेषण पढ़ना जारी रखें।
सबसे आसान गलती है Rivya API और Rivya Studio को आपस में मुकाबला करती हुई दो राहें मान लेना।
उन्हें एक ही उत्पाद के दो चरण मानना बेहतर है। Studio वह जगह है जहां लोग दृश्य रूप से विकल्प तलाशते, चुनते, समीक्षा करते और काम आगे बढ़ाते हैं। API वह जगह है जहां स्थिर कार्यप्रवाह किसी दूसरे उत्पाद, स्क्रिप्ट या बैकएंड प्रक्रिया का हिस्सा बनता है।
यह तुलना लागू किए गए API एकीकरण अनुबंध को समझाती है। API वाला पक्ष तभी लागू होता है, जब व्यवस्था में सार्वजनिक API और यहां बताई सुविधा—जैसे वेबहुक—चालू हो और खाता को उसका पहुंच मिला हो।
अगर आप अभी API हिस्सा सीख रहे हैं, तो Rivya API क्या है? से शुरू करें। यह पेज ज्यादा सीमित है: यह तय करना कि कोई विशिष्ट काम Studio में रहे या API में जाए।
| सवाल | Studio कब इस्तेमाल करें... | API कब इस्तेमाल करें... |
|---|---|---|
| क्या नतीजे की दिशा अभी खोजी जा रही है? | हां | नहीं, कार्यप्रवाह पहले से दोहराने योग्य है |
| क्या किसी व्यक्ति को नतीजों की तुलना करनी है? | हां | केवल तब, जब आपका ऐप नतीजे प्राप्त कर ले |
| क्या मॉडल का चुनाव स्थिर है? | अभी नहीं | हां, या API मॉडल सूची से चुना गया है |
| क्या काम को संदर्भ मीडिया चाहिए? | व्यक्ति अभी उसे तैयार कर रहा है | आपका ऐप उसे Files API से अपलोड कर सकता है |
| क्या नतीजे से किसी दूसरी व्यवस्था को अपडेट करना है? | अभी नहीं | हां, बार-बार स्थिति जांच या चालू वेबहुक से |
| क्या क्रेडिट उपयोग दिखाई देना चाहिए? | हां, परीक्षण के दौरान | हां, लेकिन खाता-स्तरीय API नियंत्रणों से |
यह इस बारे में नहीं है कि कौन-सा हिस्सा अधिक उन्नत है। असली सवाल यह है कि काम स्वचालित होने के लिए तैयार है या नहीं।
जब मानवीय निर्णय ही मुख्य काम हो, तब Studio सही जगह है।
इसमें शामिल है:
चित्र, वीडियो, ध्वनि या बातचीत मॉडल के बीच चुनाव करना
परीक्षण करना कि कोई प्रॉम्प्ट दिशा रखने लायक है या नहीं
दृश्य नतीजों की साथ-साथ तुलना करना
तय करना कि संदर्भ माध्यम मदद कर रहा है या नुकसान
सहेजा हुआ इतिहास से पिछला नतीजा के बाद आगे बढ़ना करना
रचनात्मक सामग्री के काम में यह खास तौर पर सच है। अगर संक्षिप्त विवरण स्थिर नहीं है, तो अनुरोध स्वचालित करने से उलझन आम तौर पर कम होने के बजाय बढ़ती है।
जब इनपुट और अगला चरण पर्याप्त रूप से अनुमान लगाने योग्य हों, तब API बेहतर मार्ग बनती है।
अच्छे संकेत:
आपका उत्पाद पहले से जानता है कि उसे कौन सा मॉडल या मॉडल श्रेणी चाहिए
उपयोगकर्ता के इनपुट को अनुरोध की तय संरचना में बदला जा सकता है
बैकएंड किसी व्यक्ति के स्क्रीन देखते रहने के बिना काम की स्थिति जांच सकता है
काम पूरा होने पर सक्रिय वेबहुक सही रिकॉर्ड अपडेट कर सकता है
ऐप टीम या खाता स्वामी को क्रेडिट उपयोग समझा सकता है
इस बिंदु पर हर प्रयास के लिए Studio इस्तेमाल करना धीमा रास्ता बन सकता है। API आपके उत्पाद को काम सीधे शुरू करने देती है।
खोज के लिए Studio इस्तेमाल करें।
एकीकरण के लिए API इस्तेमाल करें।
खोज का मतलब है:
"कौन सा मॉडल इस्तेमाल करें?"
"कौन सा प्रॉम्प्ट आकार काम करता है?"
"क्या संदर्भ माध्यम इस काम को बेहतर बनाता है?"
“क्या नतीजे की गुणवत्ता इस उपयोग के लिए पर्याप्त है?”
एकीकरण का मतलब है:
"यह उपयोगकर्ता क्रिया एक निर्माण काम तैयार करे।"
"यह काम सुरक्षित ढंग से दोबारा भेजा जा सके, बिना दोहरा असर पैदा किए।"
"यह फ़ाइल अपलोड होकर मॉडल अनुरोध से जुड़ जाए।"
"यह पूरा हुआ काम हमारे उत्पाद रिकॉर्ड को अद्यतन करे।"
यह सीमा API को उत्पाद के भीतर छिपा हुआ प्रयोग बनने से रोकती है।
Studio और API दोनों उसी Rivya खाते के क्रेडिट वॉलेट से खर्च करते हैं।
इसका मतलब है कि क्रेडिट व्यवहार उत्पाद डिजाइन का हिस्सा होना चाहिए, बाद में जोड़ी गई व्याख्या नहीं।
जब टीम अभी लागत का स्वरूप समझ रही हो, पहले Studio इस्तेमाल करें। API तब अपनाएं जब काम इतना स्थिर हो कि उत्पाद साफ बता सके कि क्रेडिट कब रोके या खर्च किए जा सकते हैं।
मौजूदा सार्वजनिक नियम के लिए API क्रेडिट पढ़ें। अगर कोई कार्यप्रवाह खाता-मालिक को समझाने के लिहाज से बहुत महंगा है, तो वह अभी API स्वचालन के लिए तैयार नहीं है।
संदर्भ मीडिया अक्सर वह बिंदु होता है, जहां एकीकरण अधिक गंभीर हो जाता है।
Studio में कोई व्यक्ति फ़ाइल अपलोड और जांच सकता है, दोबारा प्रयास कर सकता है और तय कर सकता है कि फ़ाइल पर्याप्त अच्छी है या नहीं। API में आपके उत्पाद को Files API के जरिए फ़ाइल प्रक्रिया स्पष्ट रूप से संभालनी होती है।
Studio इस्तेमाल करें जब:
संदर्भ चित्र, वीडियो या ध्वनि को अभी मानवीय सुधार चाहिए
टीम को अभी तय नहीं है कि कौन-सा संदर्भ मॉडल का मार्गदर्शन करे
फाइल नियम उपयोगकर्ता को अभी साफ़ नहीं हैं
API इस्तेमाल करें जब:
ऐप फाइल को सुरक्षित ढंग से ले सकता है
मॉडल की संदर्भ संबंधी जरूरतें तय हैं
फाइल निर्माण या बातचीत अनुरोध से पहले अपलोड हो सकती है
त्रुटियां आपके अपने उत्पाद में साफ़ दिखाई जा सकते हैं, बिना घटना छिपाए
Files API एक उपयोगी सेतु है, लेकिन इससे फ़ाइल से जुड़ा अनुभव डिज़ाइन करने की जरूरत खत्म नहीं होती।
बातचीत दोनों ओर हो सकती है।
जब कोई व्यक्ति खोज रहा हो, लिख रहा हो, समीक्षा कर रहा हो या फैसला ले रहा हो, तब सीधे Rivya चैट इस्तेमाल करें।
जब बातचीत बातचीत का दौर को आपके अपने उत्पाद या सर्वर कार्यप्रवाह के अंदर रहना हो, तो बातचीत API इस्तेमाल करें। इसमें बिना स्ट्रीम वाला बातचीत के दौर, वैकल्पिक SSE स्ट्रीमिंग, API-तैयार किया गया सत्र और समर्थित फाइल संलग्नक शामिल हो सकते हैं।
मुख्य सवाल यह है कि बातचीत कहां उपलब्ध होनी चाहिए। बातचीत Rivya में हो रहे काम का हिस्सा है तो Rivya इस्तेमाल करें; आपके उत्पाद के अनुभव का हिस्सा है तो API इस्तेमाल करें।
अगर आपके कार्यप्रवाह को API वेबहुक चाहिए, तो वह शायद मानवीय Studio चरण से आगे जा चुका है। इसे निर्माण-डिजाइन का हिस्सा मानने से पहले पुष्टि करें कि व्यवस्था में वेबहुक चालू हैं।
वेबहुक तब उपयोगी हैं जब पूरा हुए निर्माण पर किसी दूसरी व्यवस्था को प्रतिक्रिया देनी हो:
सामग्री को तैयार चिह्नित करना
उपयोगकर्ता को सूचना देना
समीक्षा चरण को आगे बढ़ाना
विफल काम को सहायता या पुनःप्रयास की व्यवस्था में भेजना
यह एकीकरण का काम है। Studio अभी भी मॉडल वाला रास्ता परखने के लिए उपयोगी हो सकता है, लेकिन निर्माण की दोहराई जाने वाली प्रक्रिया API में होनी चाहिए।
पूरे कार्यप्रवाह को एक साथ API में चलता न करें।
यह क्रम अपनाएं:
Studio में काम स्वयं परखें
स्थिर मॉडल, प्रॉम्प्ट का स्वरूप, इनपुट फाइलें और अपेक्षित नतीजा लिखें
API मॉडल और मॉडल संदर्भ पढ़ें
API क्विकस्टार्ट से एक जनरेशन भेजें
Files API तभी जोड़ें, जब मॉडल को संदर्भ मीडिया चाहिए
वेबहुक सिर्फ बार-बार स्थिति जांच चलने और वेबहुक पहुंच चालू होने के बाद जोड़ें
बातचीत API केवल तब जोड़ें जब उत्पाद को Studio के बाहर बातचीत के दौर चाहिए
हर चरण को कार्यप्रवाह चलाना आसान बनाना चाहिए, केवल अधिक स्वचालित नहीं।
जब काम को अभी इन चीज़ों की जरूरत हो, Studio में रहें:
व्यक्तिगत पसंद पर आधारित समीक्षा
प्रॉम्प्ट को आकार देना
दृश्य तुलना
मॉडल खोज
सहेजा हुआ रचनात्मक सामग्री इतिहास
कोई व्यक्ति तय करे कि अगला चरण चित्र, वीडियो, ध्वनि या बातचीत है
यह कमजोरी नहीं है। Studio इसी चरण के लिए बनाया गया है।
API में चलता करें जब:
वही काम बार-बार दोहराया जाता है
इनपुट संरचित हो सकता है
मॉडल तय है
ऐप को अपने UI से काम तैयार करने हैं
स्थिति, त्रुटियां और क्रेडिट साफ ढंग से संभाले जा सकते हैं
बार-बार स्थिति जांच या चालू होने पर वेबहुक, उत्पाद के सर्वर-पक्ष के अनुकूल हों
API तब सबसे मजबूत होती है जब वह पहले से समझे हुए Rivya कार्यप्रवाह को भरोसेमंद उत्पाद क्रिया में बदलती है।
API वाले हिस्से का पूर्वावलोकन करने के लिए डेवलपर इस्तेमाल करें।
निर्माण कोड लिखने से पहले Rivya API की त्वरित शुरुआत पढ़ें।
API कुंजी स्टोर करने से पहले API पहचान सत्यापन पढ़ें।
अगर अगला सवाल मॉडल, फाइलें, बातचीत और वेबहुक को जोड़ना है, तो Rivya API से बहु-माध्यम AI कार्यप्रवाह कैसे बनाएं पढ़ें।
अगर परियोजना अभी भी मानवीय Studio काम में है, तो Rivya चैट, चित्र, वीडियो और ध्वनि में काम कैसे चलता है पढ़ें।