ডকুমেন্ট পুনরায় র্যাঙ্ক করুন
একটি প্রশ্ন এবং ১–১০০০ ডকুমেন্ট প্রদান করুন।.
এই পৃষ্ঠায়
https://api.shareai.now/api/v1/rerankডকুমেন্ট পুনরায় র্যাঙ্ক করুন
- বেস URL
https://api.shareai.now- অথেন্টিকেশন
- Bearer API কী বা অনুমোদিত OAuth অ্যাক্সেস টোকেন
- প্রয়োজনীয় স্কোপ
inferenceormonetization_gateway
একটি প্রশ্ন এবং ১–১০০০ ডকুমেন্ট প্রদান করুন। প্রতিটি ডকুমেন্ট টেক্সট, একটি {"text":"..."} অবজেক্ট বা একটি মডেল-সমর্থিত {"image":"https://..."} অবজেক্ট হতে পারে।. top_n কমপক্ষে ১ হতে হবে এবং ডকুমেন্ট সংখ্যার চেয়ে বেশি হতে পারবে না। মূল ডকুমেন্ট সূচকের সাথে ফলাফল মেলান।.
শুরু করার আগে#
আপনার সার্ভারে SHAREAI_API_KEY সেট করুন এবং মডেল প্লেসহোল্ডারটি বর্তমানে সক্রিয় মডেলের সাথে প্রতিস্থাপন করুন। ব্রাউজার কোডে API কী কখনো প্রকাশ করবেন না। মডেল, অ্যাকাউন্ট, ক্রেডেনশিয়াল এবং প্রোভাইডার অবশ্যই এই অপারেশন অনুমোদন করতে হবে। নিচের ঐচ্ছিক সেটিংস মডেল সমর্থনের প্রয়োজন; API নিরাপত্তা সীমা প্রতিশ্রুতি নয় যে প্রতিটি মডেল প্রতিটি মান সমর্থন করবে।.
একটি অনুরোধ পাঠান#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/rerank" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_RERANK_MODEL",
"query": "A cat",
"documents": [
{
"text": "A cat on a windowsill."
},
{
"text": "A map of Berlin."
}
],
"top_n": 1
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_RERANK_MODEL',
'query': 'A cat',
'documents': [{'text': 'A cat on a windowsill.'},
{'text': 'A map of Berlin.'}],
'top_n': 1}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/rerank', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/rerank", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_RERANK_MODEL",
"query": "A cat",
"documents": [
{
"text": "A cat on a windowsill."
},
{
"text": "A map of Berlin."
}
],
"top_n": 1
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);অনুরোধ ক্ষেত্র#
| ক্ষেত্র | প্রকার | অর্থ এবং সীমাবদ্ধতা |
|---|---|---|
model প্রয়োজনীয় | স্ট্রিং | সঠিক সক্রিয় পাবলিক মডেল শনাক্তকারী। এই অপারেশন ঘোষণা করতে হবে এবং আপনার ক্রেডেনশিয়াল দ্বারা অনুমোদিত হতে হবে।. |
query প্রয়োজনীয় | স্ট্রিং | খালি নয় এমন প্রাসঙ্গিক প্রশ্ন।. |
documents প্রয়োজনীয় | অ্যারে | ১–১০০০ খালি নয় এমন টেক্সট স্ট্রিং বা একক-কী টেক্সট/ইমেজ অবজেক্ট। ইমেজ মান HTTPS URL বা মডেল ইমেজ-ইনপুট সমর্থন সহ ডেটা URL হতে হবে।. |
top_n | পূর্ণসংখ্যা | ১ থেকে ডকুমেন্ট সংখ্যার মধ্যে ঐচ্ছিক ফলাফলের সংখ্যা। ফেরত দেওয়া সূচকগুলি মূল ডকুমেন্ট অ্যারের সাথে সম্পর্কিত।. |
return_documents | বুলিয়ান | মূল ডকুমেন্টগুলিকে ফলাফলে অন্তর্ভুক্ত করার জন্য প্রোভাইডার-সমর্থিত ঐচ্ছিকতা।. |
provider | অবজেক্ট | ঐচ্ছিক প্রদানকারী রাউটিং পছন্দ। গ্রহণযোগ্য প্রদানকারী ট্যাগের জন্য provider.only ব্যবহার করুন, মডেল ID-তে প্রিফিক্স নয়। অ্যাকাউন্ট এবং ক্রেডেনশিয়াল সীমাবদ্ধতা এখনও প্রযোজ্য।. |
ফলাফল পড়ুন#
সফল হলে HTTP 200 সহ JSON ফেরত দেয়। একটি প্রশ্ন এবং ১–১০০০ ডকুমেন্ট প্রদান করুন। প্রতিটি ডকুমেন্ট টেক্সট, একটি {"text":"..."} অবজেক্ট বা একটি মডেল-সমর্থিত {"image":"https://..."} অবজেক্ট হতে পারে।. top_n কমপক্ষে ১ হতে হবে এবং ডকুমেন্ট সংখ্যার চেয়ে বেশি হতে পারবে না। মূল ডকুমেন্ট সূচকের সাথে ফলাফল মেলান।.
বিলিং ইউনিট#
রির্যাঙ্ক রেট ইনপুট টোকেন, স্কোরকৃত ডকুমেন্ট, অনুরোধ বা প্রোভাইডার-প্রতিবেদনকৃত অনুসন্ধানের পরিমাণ ব্যবহার করতে পারে। টোকেনের সাথে সার্বজনীন অনুসন্ধান রূপান্তর অনুমান করা হয় না। যে প্রোভাইডার একটি মূল্য নির্ধারিত মাত্রা রিপোর্ট করতে পারে না, সেই ট্যারিফের জন্য অনুপলব্ধ।.
Console থেকে সঠিক সক্রিয় মডেল আইডেন্টিফায়ার নির্বাচন করুন। এর ঘোষিত অপারেশন এবং ইনপুট/আউটপুট সক্ষমতা এই এন্ডপয়েন্টের সাথে মিলতে হবে; একটি টেক্সট চ্যাট মডেল অন্য অপারেশনের জন্য প্রতিস্থাপন করা যাবে না। আপনার ক্রেডেনশিয়াল, প্রোভাইডার এবং অ্যাকাউন্ট সীমাবদ্ধতা এখনও প্রযোজ্য।.
মূল্য নির্ধারণ এবং ব্যবহার#
নির্বাচিত মডেল, প্রোভাইডার, ইউনিট এবং ভেরিয়েন্টের জন্য EUR AI ক্রেডিটে রেট প্রকাশিত হয়। শুধুমাত্র এর সক্রিয় ট্যারিফের মাত্রাগুলি চার্জ করা হয়। একটি অনুমান কার্যকর করার আগে ক্রেডিট সংরক্ষণ করে; চূড়ান্ত চার্জ পরিমাপ করা ব্যবহারের উপর ভিত্তি করে। মূল্য রেজোলিউশন, আউটপুট ফরম্যাট বা একটি ব্যবহার ব্যান্ডের উপর নির্ভর করতে পারে। চূড়ান্ত ShareAI ডেবিটের জন্য Console Usage চেক করুন। আপস্ট্রিম খরচ ক্ষেত্র এবং মিডিয়া বাইটগুলি উদ্ভাবিত টোকেন গণনায় রূপান্তরিত হয় না।.
অ্যাক্সেস এবং ত্রুটি#
ব্যবহার inference অনুমোদিত নেটওয়ার্ক-খরচ ইনফারেন্সের জন্য বা monetization_gateway অনুমোদিত Builder মার্কআপ এবং গৃহীত বিলিং শর্তের জন্য। শুধুমাত্র পরিচয়-ভিত্তিক অ্যাক্সেস ব্যয় অনুমোদন করে না। যাচাই, মডেল অনুমোদন, অপর্যাপ্ত ক্রেডিট, রেট সীমা এবং কার্যকরী ব্যর্থতা একটি গঠিত error. টাইমআউট বা অনিশ্চিত জমা দেওয়ার পরে, Usage বা ভিডিও কাজটি পরিদর্শন করুন অন্য একটি সম্ভাব্য অর্থপ্রদত্ত অনুরোধ তৈরি করার আগে।.
সর্বশেষ আপডেট নভেম্বর 3, 2026