Rivya API কী?

Rivya API হলো নিজের পণ্য, স্ক্রিপ্ট বা কার্যপ্রবাহ থেকে Rivya সমর্থিত মডেলের সক্ষমতা ব্যবহারের জন্য উন্নয়নকারী সংযোগের চুক্তি—যদি ব্যবস্থাপনায় প্রকাশ্য API চালু থাকে এবং আপনার হিসাব সেটি ব্যবহারের অনুমতি পায়।

এটি Rivya Studio থেকে আলাদা কোনো পণ্য নয়। এটি একই হিসাব সীমা, একই ক্রেডিট ভান্ডার এবং Rivya জুড়ে ব্যবহারকারীরা যে প্রকাশ্য মডেল স্তর দেখেন সেটিই ব্যবহার করে। পার্থক্য হলো কাজ কীভাবে শুরু হয়: Studio-তে ক্লিক করার বদলে আপনার অ্যাপ্লিকেশন API কী দিয়ে অনুরোধ পাঠায়।

সংযোগবিন্দুর বিস্তারিত জানতে Rivya API পরিচিতি এবং Rivya API দ্রুত শুরু দিয়ে শুরু করুন। এই নিবন্ধে পণ্য-স্তরের ব্যাখ্যা আছে: API কীসের জন্য, কোথায় এটি উপযুক্ত এবং কখন এটি প্রথম পথ হওয়া উচিত নয়।

সংক্ষিপ্ত সংস্করণ

Rivya API v1 যোগ্য প্রবেশ করা হিসাব-কে API কী তৈরি করতে এবং ওয়েব পরত-এর বাইরে থেকে API-প্রস্তুত Rivya মডেল ব্যবহার করতে দেয়। উন্নয়নকারী পাতা বাস্তবায়িত সংযোগের চুক্তি ব্যাখ্যা করে; কোনো অনুরোধ চলবে কি না তা নির্ভর করে বর্তমানে পাওয়া ব্যবস্থাপনা, হিসাব অনুমতি ও মডেল প্রস্তুতি-এর ওপর।

বাস্তবায়িত API অংশ-এ আছে:

• API মডেল তালিকা দিয়ে মডেল অনুসন্ধান

• অসমকালীন ছবি, ভিডিও এবং শব্দ তৈরির কাজ

• সূত্র মাধ্যম দরকার এমন মডেল-এর জন্য ফাইল API আপলোড

• প্রকাশ্য কাজের ID দিয়ে তৈরির অবস্থা বারবার যাচাই

• হিসাব ক্রেডিট যাচাই

• কথোপকথন API কথোপকথনের পালা, ঐচ্ছিক SSE স্ট্রিমিং সহ

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

• ব্যবহারবান্ধব আবরণ চাই এমন দলের জন্য TypeScript SDK-এর পরীক্ষামূলক সংস্করণ

প্রকাশ্য উন্নয়নকারী কেন্দ্র হলো উন্নয়নকারী। ধাপে ধাপে পরিচিতি, API কী বিন্যাসের সংযোগ এবং নিরাপদ ত্রুটি অনুসন্ধান প্রক্রিয়া চাইলে এটি সেরা প্রবেশপথ।

Rivya-র API কেন আছে

মানুষ যখন এখনও মডেল বেছে নিচ্ছে, প্রম্পট আকৃতি করছে, ফলাফল পর্যালোচনা করছে এবং পরের ধাপ ঠিক করছে, তখন Studio দরকারি।

সেই সিদ্ধান্ত পুনরাবৃত্তিযোগ্য পণ্য বা পরিচালনাগত কার্যপ্রবাহ হয়ে গেলে API দরকারি।

API প্রবেশাধিকার চালু থাকলে সাধারণ উদাহরণ:

• ব্যবহারকারী সংক্ষিপ্ত বিবরণ পাঠানোর পরে পণ্যের ছবির বিভিন্ন রূপ তৈরি করতে চায়

• বিপণন কার্যপ্রবাহ কাঠামোবদ্ধ প্রচার ইনপুট থেকে দৃশ্য খসড়া তৈরি করতে চায়

• অভ্যন্তরীণ সরঞ্জাম ব্রাউজার না খুলেই ভিডিও বা শব্দের কাজ পাঠাতে চায়

• সমর্থন বা বিষয়বস্তু ব্যবস্থা নিজের পরত-এর ভিতরে একটি কথোপকথন মডেল কথোপকথনের পালা চায়

• পশ্চাৎপ্রান্তের সেবা তৈরির কাজ শেষ হলে আগত প্রত্যুত্তর চায়

এসব ক্ষেত্রে Rivya API বিল, মডেল নির্বাচন এবং কাজের অবস্থার জন্য আলাদা প্রযুক্তি স্তর চাপিয়ে না দিয়ে কাজকে একই Rivya হিসাবের সঙ্গে যুক্ত রাখে।

API কোন কিছুর বিকল্প নয়

API সরাসরি Rivya ব্যবহারের সব পদ্ধতির বিকল্প নয়।

Studio বা প্রকাশ্য কাজ অংশ ব্যবহার করুন যখন:

• প্রম্পট এখনো মানুষের অনুসন্ধান ও বিচার চায়

• মডেল নির্বাচন স্থিতিশীল নয়

• নির্মাতাকে ফলাফল চোখে দেখে তুলনা করতে হয়

• প্রকল্প সংরক্ষিত ইতিহাস এবং হাতে করা পর্যালোচনার ওপর নির্ভর করে

• দল এখনও কোন ইনপুট এবং ফলাফল বিন্যাস পুনরাবৃত্তিযোগ্য হবে তা ঠিক করেনি

কার্যপ্রবাহ স্বয়ংক্রিয় করার মতো পরিষ্কার হলে API ব্যবহার করুন।

এই সীমাটি গুরুত্বপূর্ণ। অস্পষ্ট সৃজনশীল প্রশ্ন সাধারণত প্রথমে Studio-তেই থাকা ভালো। অনুমানযোগ্য ইনপুটসহ পরিচিত পণ্য প্রক্রিয়া API-তে যেতে পারে।

প্রধান নির্মাণ উপাদান

API-কে ছয়টি সংযুক্ত অংশ হিসেবে ভাবুন।

অনুরোধ ও প্রতিক্রিয়ার কাঠামোর মূল উৎস হলো API নথি। এই নিবন্ধ আপনাকে আগে কোন অংশ দরকার তা ঠিক করতে সাহায্য করবে।

ক্রেডিট কীভাবে কাজ করে

API ব্যবহার Studio-এর মতো একই Rivya হিসাবের ক্রেডিট ভান্ডার থেকে খরচ হয়।

এর মানে API কোনো নামহীন মডেল মধ্যস্থ সেবা নয়। একটি অনুরোধ নির্দিষ্ট Rivya হিসাবের, সেই হিসাব থেকে তৈরি API কী ব্যবহার করে এবং API ক্রেডিট-এ বর্ণিত একই পণ্য-স্তরের ক্রেডিট সীমা অনুসরণ করে।

দলের জন্য এটি দরকারি, কারণ Studio-র পরীক্ষা এবং API ব্যবহার একই পরিচালনাগত কাঠামোয় থাকে। আপনি হাতে একটি মডেল পরীক্ষা করে পুনরাবৃত্তিযোগ্য অংশটি সংযোগে নিতে পারেন, দ্বিতীয় বিলিং স্তর তৈরি না করেই।

ফাইল কীভাবে উপযুক্ততা করে

কিছু মডেল শুধু লেখা দিয়েই চালনা করতে পারে। অন্যগুলির সূত্র ছবি, ভিডিও বা শব্দ ফাইল দরকার।

API সংযোগের জন্য সেই উৎস ফাইল API দিয়ে যাওয়া উচিত। আপলোড একটি ব্যবস্থাপিত ফাইল নথি তৈরি করে, যা সমর্থিত মডেল পরামিতিতে ব্যবহার করা যায়।

ব্যবহারিক নিয়ম সহজ:

• মডেল শুধু লেখাভিত্তিক ইনপুট নিলে তৈরি সংযোগবিন্দু দিয়ে শুরু করুন

• মডেল সূত্র মাধ্যম চাইলে আগে ফাইল আপলোড করুন

• মডেলটি কথোপকথন মডেল হলে এবং ছবি সংযুক্তি চাইলে কথোপকথন API ও ফাইল ID ব্যবহার করুন

শুধু ব্রাউজারভিত্তিক আপলোড প্রক্রিয়া বা সংরক্ষিত Studio সেশনের ওপর সংযোগ নকশা করবেন না। প্রয়োজন বলেই API-এর নিজস্ব প্রকাশ্য ফাইল সীমা আছে।

ওয়েবহুক কোথায় সাহায্য করে

বারবার অবস্থা যাচাই করাই সবচেয়ে সহজ প্রথম সংযোগ পথ। তৈরির কাজ পাঠান, প্রকাশ্য কাজের ID সংরক্ষণ করুন এবং সফল বা ব্যর্থ হওয়া পর্যন্ত অবস্থা যাচাই করুন।

ব্যবস্থাপনা-এ ওয়েবহুক চালু থাকলে সংযোগ উৎপাদন-এর কাছাকাছি যাওয়ার সঙ্গে সঙ্গে সেগুলি দরকারি হয়:

• প্রতিটি কাজের জন্য কর্মী প্রক্রিয়াকে বারবার অবস্থা যাচাই করাতে চান না

• তৈরি শেষ হলে অ্যাপকে নথি হালনাগাদ করতে হবে

• নিরাপদে আবার চেষ্টা করা যায় এমন আগত ঘটনা চান

• ব্যর্থ কাজ স্পষ্ট পুনরুদ্ধার পথ-এ যেতে হবে

আগত ঘটনার সংযোগের চুক্তির জন্য API ওয়েবহুক ব্যবহার করুন। পরিকল্পনায় রাখার আগে সুবিধাটি পাওয়া যাচ্ছে কি না নিশ্চিত করুন। ওয়েবহুক গ্রহণকারীর কাজ সীমিত রাখুন: স্বাক্ষর যাচাই করুন, একই ঘটনা একাধিকবার এলে নিরাপদে সামলান এবং গোপন মান লগে রাখবেন না।

ভালো প্রথম API প্রকল্প

সেরা প্রথম API প্রকল্প সাধারণত ছোট ও সুনির্দিষ্ট হয়।

উদাহরণ:

1. ব্যবস্থাপনা ও হিসাব-এর জন্য API প্রবেশাধিকার চালু আছে কি না নিশ্চিত করুন

2. বিন্যাস-এ API কী তৈরি করুন

3. মডেল তালিকা কল করুন

4. একটি API-প্রস্তুত মডেল বেছে নিন

5. একই অনুরোধের পুনরাবৃত্তি ঠেকানোর কীসহ একটি তৈরির কাজ পাঠান

6. অবস্থা সংযোগবিন্দু বারবার অবস্থা যাচাই করুন

7. আগে ও পরে ক্রেডিট যাচাই করুন করুন

8. তারপরই ব্যবস্থাপনা-এ প্রকাশিত ফাইল API, কথোপকথন API বা ওয়েবহুক যোগ করুন

এই পথ প্রথম পরীক্ষায় সব API সুবিধা মিশিয়ে না দিয়ে কার্যকর সংযোগ দেয়।

কখন API ভুল শুরুর জায়গা

API সম্ভবত সঠিক প্রথম ধাপ নয় যখন:

• দল এখনও মডেল গুচ্ছ বেছে নেয়নি

• কাঙ্ক্ষিত ফলাফল প্রতি চালনায় বদলাচ্ছে

• প্রম্পট মানুষের রুচি ও হাতে করা পর্যালোচনার ওপর নির্ভর করে

• সংযোগ ক্রেডিট ব্যবহার লুকিয়ে দেবে সেই মানুষদের কাছ থেকে যাদের এটি বুঝতে হবে

• পণ্যটি স্বয়ংক্রিয় করার আগে প্রকাশ্য প্রদর্শনী চায়

এই ক্ষেত্রে ছবি, ভিডিও, শব্দ, কথোপকথন বা AI মডেল থেকে শুরু করুন। পথ পুনরাবৃত্তিযোগ্য হলে স্থিতিশীল অংশ API-তে নিন।

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

• প্রকাশ্য API কেন্দ্র এবং ত্রুটি অনুসন্ধানের জন্য উন্নয়নকারী খুলুন।

• প্রথম নিরাপদ অনুরোধ করতে Rivya API দ্রুত শুরু পড়ুন।

• সার্ভার-এ কী রাখার আগে API পরিচয় যাচাই পড়ুন।

• মডেল ID বেছে নেওয়ার আগে API মডেল পড়ুন।

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

• সম্পূর্ণ ছবি, ভিডিও, শব্দ বা কথোপকথন সংযোগ পরিকল্পনা করলে Rivya API দিয়ে বহুমাধ্যম AI কার্যপ্রবাহ তৈরির উপায় পড়ুন।