Rivya API দিয়ে বহুমাধ্যম কার্যপ্রবাহ তৈরি করুন

ভালো Rivya API সংযোগ শুধু একটি মডেল-এ একটি অনুরোধ পাঠানো নয়।

বাস্তব পণ্য কার্যপ্রবাহ সাধারণত ছোট একটি ধারা: সঠিক মডেল বাছা, ইনপুট প্রস্তুত করা, দরকার হলে সূত্র ফাইল আপলোড করা, কাজ পাঠান করা, অবস্থা দেখা, ক্রেডিট সামলানো এবং ফলাফল প্রস্তুত হলে পণ্য-কে জানানো করা।

এই নিবন্ধ পরিকল্পনার কাঠামো দেখায়। সবচেয়ে ছোট চালু করার উপযোগী পথের জন্য Rivya API দ্রুত শুরু ব্যবহার করুন, আর নির্ভুল অনুরোধ ক্ষেত্রের জন্য API নথি দেখুন।

নিচের কার্যপ্রবাহ-টি বাস্তবায়িত প্রকাশ্য API সংযোগের চুক্তি ব্যাখ্যা করে। কাজ শুরুর আগে নিশ্চিত করুন যে ব্যবস্থাপনা ও হিসাব-এর জন্য প্রকাশ্য API চালু আছে, বাছাই করা মডেল API-তে ব্যবহারের জন্য প্রস্তুত এবং ওয়েবহুক-এর মতো ঐচ্ছিক সুবিধা সত্যিই পাওয়া যাচ্ছে।

পণ্য মুহূর্ত দিয়ে শুরু করুন

সংযোগবিন্দু বাছার আগে পণ্য মুহূর্ত এক বাক্যে লিখুন।

উদাহরণ:

• seller listing brief submit করলে একটি product image draft তৈরি করুন।

• campaign manager still direction approve করার পর একটি short video concept generate করুন।

• internal research tool-এর ভেতরে chat turn পাঠিয়ে response user-এর কাছে stream করুন।

• reference image upload করুন, supported model request submit করুন এবং result ready হলে user-কে notify করুন।

এই বাক্য সংযোগ-কে আলগা API কল-এর সমষ্টি হয়ে যাওয়া থেকে বাঁচায়।

কোড লেখার আগে কার্যপ্রবাহের মানচিত্র তৈরি করুন

অনুরোধের কাঠামো খোলার আগে এই সারণি ব্যবহার করুন।

কার্যপ্রবাহ এতটা পরিষ্কার হওয়া উচিত, যাতে প্রতিটি API অংশ থাকার কারণ বোঝা যায়।

ধাপ 1: সংযোগ-এর জন্য কী তৈরি করুন

যে নির্দিষ্ট অ্যাপ, পরিবেশ বা কার্যপ্রবাহ কীটি ব্যবহার করবে, তার জন্য API কী তৈরি করুন।

একটি কী সব কিছুর জন্য ব্যবহার করবেন না। উদ্দেশ্য ধরে কীটির নাম দিলে পরে পর্যালোচনা সহজ হয়:

• production-image-workflow

• staging-video-tests

• internal-chat-assistant

• webhook-smoke-test

কী দোকান করার আগে API পরিচয় যাচাই পড়ুন। সম্পূর্ণ গোপন মান একবারই দেখানো হয়, তাই দল-এর উচিত সঙ্গে সঙ্গে সঠিক সার্ভার-পক্ষের গোপন মান দোকান-এ সংরক্ষণ করুন করা।

ধাপ 2: প্রকাশ্য API তালিকা থেকে মডেল বাছুন

হাতে করা পরীক্ষায় কাজ করেছে বলেই মডেল স্থায়ীভাবে কোডে বসাবেন না।

API মডেল এবং মডেল API সূত্র দিয়ে নিশ্চিত করুন:

• প্রকাশ্য মডেল ID

• API দিয়ে পাওয়া যায় কি না

• সমর্থিত ইনপুট পদ্ধতি

• প্রম্পট ও পরামিতির প্রত্যাশা

• ফাইল API দরকার কি না

• ক্রেডিটের আচরণ ও প্রস্তুতির নির্দেশনা

এই ধাপে অনেক সংযোগ পরিষ্কার হয়। হাতে করা Studio পরীক্ষার জন্য নিখুঁত মডেল স্বয়ংক্রিয় পণ্য প্রক্রিয়ার সঠিক প্রথম মডেল নাও হতে পারে।

ধাপ 3: প্রথম সংস্করণ-এ ফাইল API লাগবে কি না ঠিক করুন

মডেল যদি লেখা ইনপুট দিয়ে চালনা করতে পারে, প্রথম সংস্করণ শুধু লেখাভিত্তিক রাখুন।

কার্যপ্রবাহ সত্যিই সূত্র মাধ্যম চাইলে তবেই ফাইল API যোগ করুন।

যোগ করলে আগে নির্ধারণ করুন:

• পণ্য কোন ধরনের ফাইল গ্রহণ করে

• ফাইল শব্দ পরিষ্কার ধাপ-এর মালিক কে

• আপলোড ব্যর্থ হলে কী হবে

• ফেরত পাওয়া ফাইলের তথ্য মডেল পরামিতিতে কীভাবে ব্যবহার হবে

• একই ফাইল পুনর্ব্যবহার হবে নাকি আবার আপলোড হবে

এতে ভঙ্গুর ফাইল ব্যবহারের অভিজ্ঞতা একটি পরিচ্ছন্ন দেখতে তৈরির বোতামের আড়ালে লুকিয়ে থাকে না।

ধাপ 4: একটি তৈরি কাজ পাঠান করুন

ছবি, ভিডিও ও শব্দ তৈরির স্বাভাবিক ধরন হলো:

1. মডেল ID, প্রম্পট ও সমর্থিত পরামিতি প্রস্তুত করুন

2. নিরাপদে আবার চেষ্টার জন্য একই অনুরোধের পুনরাবৃত্তি ঠেকানোর কী যোগ করুন

3. তৈরি সংযোগবিন্দু দিয়ে পাঠান করুন

4. প্রকাশ্য কাজ ID সংরক্ষণ করুন করুন

5. কাজটি চূড়ান্ত অবস্থায় পৌঁছানো পর্যন্ত বারবার অবস্থা যাচাই করুন

অনুরোধ আকৃতি-এর জন্য তৈরি তৈরি এবং ফলাফল পরিচালনা-এর জন্য তৈরি অবস্থা ব্যবহার করুন।

পণ্যের উচিত queued, processing, succeeded ও failed-কে ব্যবহারকারীর জন্য দৃশ্যমান অবস্থা হিসেবে দেখানো। ব্যবহারকারীকে ব্যবস্থার বিস্তারিত পড়ে কাজ ধীর হওয়ার কারণ অনুমান করতে দেবেন না।

ধাপ 5: কথোপকথন মডেল-এর জন্য কথোপকথন API ব্যবহার করুন

কথোপকথন মডেল-এর জন্য কথোপকথন API ব্যবহার করা উচিত, তৈরি সংযোগবিন্দু নয়।

কারণ কথোপকথন কাজ-এর আচরণ আলাদা:

• কথোপকথন কথোপকথনের পালা API-তৈরি করা সেশন-এর অংশ হতে পারে

• স্ট্রিমবিহীন ও SSE স্ট্রিমিং ব্যবহারকারীকে আলাদা অভিজ্ঞতা দেয়

• ছবি সংযুক্তি ফাইল API থেকে পাওয়া ফাইল ID ব্যবহার করে

• ক্রেডিট নিষ্পত্তি সাধারণ অসমকালীন মাধ্যমের কাজ নয়, কথোপকথনের পালা অনুসরণ করে

আপনার পণ্য যদি নিজের স্তরে সহকারীর উত্তর দেখাতে চায়, কথোপকথন API সঠিক পথ হতে পারে। ব্যবহারকারী এখনো ধারণা অনুসন্ধান করলে Rivya কথোপকথন বা Studio ভালো হতে পারে।

ধাপ 6: বারবার অবস্থা যাচাই দিয়ে শুরু করুন, তারপর ওয়েবহুক যোগ করুন

প্রথম সংস্করণ-এর জন্য বারবার অবস্থা যাচাই বোঝা সহজ।

ব্যবস্থাপনা-এ ওয়েবহুক চালু থাকলে এই অবস্থায় API ওয়েবহুক যোগ করুন:

• পণ্য-এ অনেক অসমকালীন কাজ আছে

• অপেক্ষারত গ্রাহকের সরাসরি বারবার অবস্থা যাচাই করা উচিত নয়

• পরের ধাপের ব্যবস্থা প্রবেশ করা সম্পন্ন হওয়া ঘটনা চায়

• আবার চেষ্টা ও সদৃশ ঘটনা সামলানো আগেই নকশা করা

ওয়েবহুক গ্রহণকারী সরল ও কঠোর হওয়া উচিত: স্বাক্ষর যাচাই, সদৃশ-নিরাপদ ঘটনা গ্রহণ, একটি পণ্য নথি হালনাগাদ এবং শুধু নিরাপদ লগ লেখা।

ধাপ 7: পণ্য-এ ক্রেডিট দৃশ্যমান করুন

Rivya API Studio-র মতো একই হিসাব ক্রেডিট ব্যবহার করে।

আপনার সংযোগ কতটা দেখাবে তা ঠিক করতে হবে। অন্তত দল-এর জানা উচিত:

• কোন হিসাব API কী-এর মালিক

• কোন কার্যপ্রবাহ ক্রেডিট খরচ করতে পারে

• ক্রেডিট খুব কম হলে কী হবে

• ব্যর্থ তৈরির অবস্থা কীভাবে ব্যাখ্যা করা হবে

• ক্রেডিট এবং বিল প্রশ্ন-এর জন্য ব্যবহারকারী কোথায় যাবে

ব্যবহারকারীর জন্য দৃশ্যমান ক্রেডিট ভান্ডার বুঝতে API ক্রেডিট, Rivya-তে ক্রেডিট ও বিলিং এবং Rivya ক্রেডিট, প্যাক ও পরিকল্পনা বোঝার উপায় ব্যবহার করুন।

ছোট প্রথম সংস্করণ

ভালো প্রথম সংস্করণ ইচ্ছাকৃতভাবে সীমিত হয়।

যেমন:

1. একটি API কী

2. একটি নির্বাচিত ছবি মডেল

3. এখনও ফাইল আপলোড নেই

4. একটি তৈরি অনুরোধ

5. একটি অবস্থা বারবার অবস্থা যাচাই পথ

6. আপনার পণ্যে একটি সরল ফলাফলের পূর্বরূপ

7. একটি পরিষ্কার ক্রেডিট ত্রুটি বার্তা

এই সংস্করণ আরও চলমান অংশ যোগ করার আগে সংযোগটি প্রমাণ করে।

আরও সম্পূর্ণ সংস্করণ

প্রথম সংস্করণ কাজ করার পর আরও পূর্ণ কার্যপ্রবাহ যোগ করা যায়:

• সূত্র ছবি বা ভিডিও-এর জন্য ফাইল API

• মডেল-নির্দিষ্ট পরামিতি নিয়ন্ত্রণ

• আপনার পণ্য নথির সঙ্গে যুক্ত পুনরাবৃত্তি প্রতিরোধ

• সুবিধাটি চালু থাকলে সম্পন্ন হওয়া-এর জন্য প্রবেশ করা ওয়েবহুক

• সহকারীর কথোপকথনের পালার জন্য কথোপকথন API

• কথোপকথনে তাৎক্ষণিক ফলাফল চাইলে সার্ভার-পক্ষের ঘটনার প্রবাহ

• ব্যর্থ কাজের জন্য প্রশাসক বা সহায়তার দৃশ্য

প্রতিটি সংযোজন বাস্তব পণ্য প্রয়োজনের উত্তর দেবে। এটি শুধু প্রদর্শনী বড় দেখালে বাদ দিন।

সাধারণ সংযোগ ভুল

এই ধরন এড়িয়ে চলুন:

• একসঙ্গে প্রতিটি API সুবিধা দিয়ে শুরু করা

• হিসাবের মালিকের কাছ থেকে ক্রেডিট ব্যবহার লুকানো

• API প্রক্রিয়ায় শুধু Studio-ভিত্তিক অনুমান ব্যবহার করা

• ফাইল আপলোডকে পরে ভাবার বিষয় ধরা

• পুনরাবৃত্তি প্রতিরোধ ছাড়া তৈরির অনুরোধ আবার চেষ্টা করা

• অসমকালীন তৈরি হওয়া উচিত এমন কাজ-এর জন্য কথোপকথন API ব্যবহার করা

• কথোপকথন কথোপকথনের পালা-এর জন্য তৈরি সংযোগবিন্দু ব্যবহার করা

• সম্পূর্ণ API কী, ওয়েবহুকের গোপন মান বা অস্থায়ী ফাইলের বিস্তারিত লগ করা

সবচেয়ে নিরাপদ API কার্যপ্রবাহ মালিকানা, অবস্থা ও ব্যর্থতা পরিচালনা নিয়ে স্পষ্ট থাকে।

এরপর কোথায় যাবেন

• প্রকাশ্য API কেন্দ্রের জন্য উন্নয়নকারী থেকে শুরু করুন।

• প্রথম অনুরোধ চালাতে Rivya API দ্রুত শুরু ব্যবহার করুন।

• মডেল ID বাছার আগে API মডেল ব্যবহার করুন।

• মডেল সত্যিই সূত্র মাধ্যম চাইলে তবেই ফাইল API ব্যবহার করুন।

• কথোপকথন কথোপকথনের পালা এবং স্ট্রিমিং কথোপকথন প্রতিক্রিয়া-এর জন্য কথোপকথন API ব্যবহার করুন।

• বারবার অবস্থা যাচাই যথেষ্ট না হলে এবং ওয়েবহুক প্রবেশাধিকার চালু থাকলে API ওয়েবহুক ব্যবহার করুন।

• কার্যপ্রবাহে এখনো মানুষের অনুসন্ধান দরকার হলে স্বয়ংক্রিয় করার আগে Studio-এর বদলে কখন Rivya API ব্যবহার করবেন পড়ুন।