RouterHub কী প্রদান করে
RouterHub-কে OpenRouter-এর একটি বিকল্প হিসেবে উপস্থাপন করা হয়েছে, যেখানে একটি লাইভ মডেল ক্যাটালগ এবং API অ্যাক্সেসের প্রক্রিয়া রয়েছে। এই রিপোজিটরিটি মডেল খোঁজা, API ব্যবহার, মাইগ্রেশন, মূল্য, ভ্যারিয়েন্ট, ব্যবহারক্ষেত্র, নিরাপত্তা এবং সমস্যা সমাধান নিয়ে একটি ডকুমেন্টেশন হাব হিসেবে কাজ করে।
ডকুমেন্টেশনটি কয়েকটি নির্দিষ্ট গাইডের ধারাবাহিকতায় সাজানো। আপনি শুরু থেকে শেষ পর্যন্ত পড়তে পারেন, অথবা আপনার কাজের সঙ্গে সম্পর্কিত বিষয়ে সরাসরি যেতে পারেন।
সঠিক জায়গা থেকে শুরু করুন
- সেবাটি মূল্যায়ন করতে: OpenRouter-এর বিকল্প কী? এবং RouterHub বনাম OpenRouter দিয়ে শুরু করুন।
- মাইগ্রেশনের পরিকল্পনা করতে: নথিভুক্ত বেস URL, API কী এবং মডেল ম্যাপিং প্রক্রিয়ার জন্য মাইগ্রেশন গাইড পড়ুন।
- একটি মডেল খুঁজতে: মডেল পরিবার, ID এবং প্রোটোকল পর্যালোচনা করতে মডেল ক্যাটালগ গাইড এবং লাইভ ক্যাটালগ ব্যবহার করুন।
- প্রথম অনুরোধ করতে: API কুইকস্টার্ট অনুসরণ করুন।
- খরচ যাচাই করতে: প্রতি-টোকেনের উদাহরণের জন্য মূল্য দেখুন।
- ভ্যারিয়েন্ট তুলনা করতে: সেন্সরবিহীন ও অ্যাবলিটারেটেড গাইড দেখুন।
অ্যাক্সেস সেট আপ করুন
- RouterHub নিবন্ধন পৃষ্ঠা খুলুন এবং API কী পাওয়ার জন্য অনবোর্ডিং প্রক্রিয়া অনুসরণ করুন।
- আপনার অ্যাপ্লিকেশনের জন্য সঠিক মডেল ID এবং সমর্থিত প্রোটোকল শনাক্ত করতে মডেল ক্যাটালগের ডকুমেন্টেশন পর্যালোচনা করুন।
- আপনি যদি বিদ্যমান OpenRouter ইন্টিগ্রেশন মাইগ্রেট করেন, নথিভুক্ত বেস URL, কী ব্যবস্থাপনা এবং মডেল ম্যাপিংয়ের জন্য মাইগ্রেশন গাইড দেখুন।
- প্রথম অনুরোধ তৈরি ও পাঠাতে API কুইকস্টার্ট ব্যবহার করুন।
আপনার API কী গোপন রাখুন। এটি সরাসরি সোর্স কোডে না রেখে একটি এনভায়রনমেন্ট ভেরিয়েবল বা অন্য কোনো সিক্রেট-ম্যানেজমেন্ট সিস্টেমে সংরক্ষণ করুন।
সঠিক মডেল খুঁজুন
মডেল নির্বাচন RouterHub ব্যবহারের একটি গুরুত্বপূর্ণ অংশ। রিপোজিটরিতে বিশেষভাবে মডেল পরিবার, মডেল ID এবং প্রোটোকল নিয়ে একটি ক্যাটালগ গাইড রয়েছে। কোনো শনাক্তকারী অনুমান না করে ওই গাইডের সঙ্গে লাইভ মডেল ক্যাটালগ ব্যবহার করুন।
একটি ব্যবহারিক নির্বাচন প্রক্রিয়া এমন হতে পারে:
- কাজটি নির্ধারণ করুন, যেমন কোডিং, এজেন্ট ওয়ার্কফ্লো, গবেষণা বা লেখা।
- উপলভ্য মডেল পরিবার ও ভ্যারিয়েন্টের তথ্য দেখুন।
- ক্যাটালগে দেখানো সঠিক মডেল ID কপি করুন।
- আপনি যে ক্লায়েন্ট বা ইন্টিগ্রেশন ব্যবহার করবেন, তার সঙ্গে মডেলের প্রোটোকল মেলে কি না নিশ্চিত করুন।
- প্রোডাকশন ট্র্যাফিক পাঠানোর আগে মূল্যসংক্রান্ত ডকুমেন্টেশন দেখুন।
প্রথম API অনুরোধ করুন
রিপোজিটরিটি প্রথম অনুরোধের জন্য ব্যবহারকারীদের API কুইকস্টার্টে নির্দেশ করে। সঠিক এন্ডপয়েন্ট ও অনুরোধের ফরম্যাট ওই গাইডে রক্ষণাবেক্ষণ করা হয়, তাই গৌণ কোনো উদাহরণ থেকে এন্ডপয়েন্ট হার্ড-কোড না করে গাইডের বর্তমান মান ব্যবহার করুন।
আপনার অনুরোধ সেটআপে সাধারণত নথিভুক্ত নিচের মানগুলো প্রয়োজন হবে:
API key: <your RouterHub API key>
Base URL: <value from the RouterHub API quickstart>
Model ID: <exact ID from the model catalogue>
Protocol: <protocol supported by the selected model>বাস্তবায়নের জন্য API কুইকস্টার্ট খুলুন, সেখানকার অনুরোধের উদাহরণ কপি করুন, API কী নিরাপদে সেট করুন এবং ক্যাটালগ থেকে নির্বাচিত সঠিক ID দিয়ে মডেলের মান প্রতিস্থাপন করুন।
বিদ্যমান OpenRouter ইন্টিগ্রেশন মাইগ্রেট করুন
আপনার অ্যাপ্লিকেশন ইতিমধ্যে OpenRouter ব্যবহার করলে, রিপোজিটরির মাইগ্রেশন গাইড অনুসরণ করুন। README-তে মাইগ্রেশনের তিনটি বিষয় উল্লেখ করা হয়েছে: বেস URL পরিবর্তন, RouterHub API কী ব্যবহার এবং মডেল শনাক্তকারী ম্যাপ করা।
পরীক্ষার আগে এই চেকলিস্ট ব্যবহার করুন:
- মাইগ্রেশন ডকুমেন্টেশন অনুযায়ী প্রদানকারীর বেস URL আপডেট করুন।
- বিদ্যমান ক্রেডেনশিয়ালের বদলে RouterHub API কী ব্যবহার করুন।
- প্রতিটি মডেলের নাম পর্যালোচনা করে সঠিক RouterHub মডেল ID-তে ম্যাপ করুন।
- নির্বাচিত মডেলের প্রত্যাশিত প্রোটোকল নিশ্চিত করুন।
- ইন্টিগ্রেশনটি প্রোডাকশনে নেওয়ার আগে একটি ছোট পরীক্ষামূলক অনুরোধ পাঠান।
পরিবর্তনের কারণ সম্পর্কে আরও জানতে কেন পরিবর্তন করবেন পড়ুন। এতে ডকুমেন্টেশনে আলোচিত প্রিপেইড বিলিং, মডেল ID এবং সেন্সরবিহীন বিকল্পের বিষয়গুলো রয়েছে।
মূল্য ও ভ্যারিয়েন্ট পর্যালোচনা করুন
মূল্য
মূল্য গাইডে প্রতি-টোকেনের উদাহরণ ব্যাখ্যা করা হয়েছে। আপনার নির্ধারিত কাজের খরচ অনুমান করতে এবং অনুরোধের পরিমাণ বাড়ানোর আগে মডেল তুলনা করতে এটি ব্যবহার করুন।
সেন্সরবিহীন ও অ্যাবলিটারেটেড মডেল
এই ভ্যারিয়েন্টগুলো তুলনা করার জন্য সেন্সরবিহীন ও অ্যাবলিটারেটেড গাইডটি তৈরি করা হয়েছে। রিপোজিটরির নিরাপত্তা গাইডও পড়ুন এবং যেকোনো মডেল আইনসম্মত ও দায়িত্বশীলভাবে ব্যবহার করুন।
ব্যবহারিক ব্যবহারক্ষেত্র দেখুন
প্রথম অনুরোধ সফল হলে, ব্যবহারক্ষেত্র গাইডে কোডিং, এজেন্ট, গবেষণা এবং লেখার বিষয়গুলো রয়েছে। আপনি যে ধরনের অ্যাপ্লিকেশন তৈরি করছেন, তার সঙ্গে মডেল পরিবার ও প্রোটোকল মিলিয়ে নিতে এই উদাহরণগুলো ব্যবহার করুন।
পরিচালনাসংক্রান্ত প্রশ্নের জন্য সমস্যা সমাধান নির্দেশিকাটি দেখুন। এতে প্রমাণীকরণ, মডেল আইডি এবং প্রোটোকল নিয়ে বিশেষভাবে আলোচনা করা হয়েছে। সাধারণ জিজ্ঞাসা বিভাগে বিস্তারিত উত্তর রয়েছে, আর শব্দকোষ-এ ডকুমেন্টেশনজুড়ে ব্যবহৃত পরিভাষাগুলো ব্যাখ্যা করা হয়েছে।
উন্নত পরামর্শ
- সঠিক আইডি ব্যবহার করুন: নামের পার্থক্যজনিত ব্যর্থতা এড়াতে ক্যাটালগ থেকে মডেল শনাক্তকারী কপি করুন।
- শুরুতেই প্রোটোকল যাচাই করুন: অ্যাপ্লিকেশনের কোড ডিবাগ করার আগে প্রোটোকলের সামঞ্জস্যতা যাচাই করুন।
- কনফিগারেশন ও কোড আলাদা রাখুন: API key, base URL এবং model ID কনফিগারযোগ্য রাখুন, যাতে মাইগ্রেশন ও পরীক্ষা সহজ হয়।
- আগে খরচের হিসাব করুন: বড় কাজ চালানোর আগে প্রতি-টোকেন মূল্যের উদাহরণগুলো ব্যবহার করুন।
- ডকুমেন্টেশনের পথ ব্যবহার করুন: প্রতিটি ইন্টিগ্রেশন সমস্যাকে সাধারণ API সমস্যা হিসেবে বিবেচনা না করে মাইগ্রেশন, কুইকস্টার্ট, মূল্য নির্ধারণ বা সমস্যা সমাধানের নির্দেশিকা বেছে নিন।
- নিরাপত্তা পর্যালোচনা করুন: সেন্সরবিহীন বা অ্যালিব্রেটেড ভ্যারিয়েন্ট মূল্যায়নের সময় নিরাপত্তা নির্দেশিকা পড়ুন এবং ব্যবহার আইনসম্মত উদ্দেশ্যে সীমাবদ্ধ রাখুন।
উপসংহার
RouterHub রিপোজিটরি OpenRouter-এর বিকল্প মূল্যায়ন এবং এর API-এর সঙ্গে ইন্টিগ্রেশনের জন্য একটি সুসংগঠিত সূচনা বিন্দু। প্রথমে একটি API key সংগ্রহ করুন, ক্যাটালগ থেকে সঠিক model ID নির্বাচন করুন, প্রোটোকল যাচাই করুন এবং API কুইকস্টার্ট অনুসরণ করুন। বিদ্যমান অ্যাপ্লিকেশন মাইগ্রেট করলে নির্দিষ্ট মাইগ্রেশন নির্দেশিকা ব্যবহার করুন। এরপর ডিপ্লয়মেন্টের আগে মূল্য, ভ্যারিয়েন্ট, নিরাপত্তা এবং সমস্যা সমাধানসংক্রান্ত বিষয়গুলো যাচাই করুন।