Endpoints
रीरैंक
POST /rerank से दस्तावेज़ों को क्वेरी की प्रासंगिकता के अनुसार क्रम में लगाएँ। पैरामीटर, उदाहरण, प्रतिक्रिया, कीमत और त्रुटियाँ यहाँ देखें।
playground में आज़माएंदस्तावेज़ों की सूची को क्वेरी की प्रासंगिकता के अनुसार क्रम में लगाएँ। रीरैंकर सर्च पाइपलाइन का दूसरा चरण हैं: एम्बेडिंग या कीवर्ड सर्च से 50-200 उम्मीदवार निकालें, फिर रीरैंक करें और अपने प्रॉम्प्ट के लिए शीर्ष कुछ रखें।
POST https://api14.com/api/v1/rerank
आधिकारिक OpenAI SDK में rerank मेथड नहीं है, इसलिए इसे सादे HTTP से कॉल करें (नीचे का हर भाषा उदाहरण यही करता है)।
अनुरोध
| पैरामीटर | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
model | string | हाँ | rerank मॉडल id, जैसे cohere/rerank-v3.5। |
query | string | हाँ | खोज क्वेरी। |
documents | string[] | हाँ | स्कोर किए जाने वाले उम्मीदवार टेक्स्ट। |
top_n | integer | नहीं | केवल सबसे अच्छे N नतीजे लौटाएँ। डिफ़ॉल्ट सभी। |
return_documents | boolean | नहीं | हर नतीजे में दस्तावेज़ का टेक्स्ट शामिल करें। |
उदाहरण
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api14.com/api/v1",
apiKey: process.env.API14_API_KEY,
});
const result = await client.post("/rerank", { body: {
"model": "cohere/rerank-v3.5",
"query": "What is the capital of France?",
"documents": [
"Paris is the capital of France.",
"Berlin is in Germany."
],
"top_n": 1
} });
console.log(result.results);
curl https://api14.com/api/v1/rerank \
-H "Authorization: Bearer sk-api14-..." \
-H "Content-Type: application/json" \
-d '{
"model": "cohere/rerank-v3.5",
"query": "How do I reset my password?",
"documents": [
"Billing happens on the first of each month.",
"To reset your password, open Settings and choose Security.",
"Our office is closed on public holidays."
],
"top_n": 2
}'
प्रतिक्रिया
{
"id": "gen-1791100000-rr1",
"model": "cohere/rerank-v3.5",
"results": [
{ "index": 1, "relevance_score": 0.94 },
{ "index": 0, "relevance_score": 0.08 }
],
"usage": { "search_units": 1, "cost": 0.002 }
}
index आपके documents ऐरे की स्थिति बताता है। नतीजे relevance_score के अनुसार क्रमबद्ध होते हैं, सबसे ऊँचा पहले।
कीमत
Rerank मॉडल का बिल प्रति सर्च, मॉडल की सूचीबद्ध कीमत पर बनता है, जो "$ / 1K searches" के रूप में दिखती है। लागत usage.cost में होती है और आपके USD बैलेंस से कटती है।
rerank मॉडल सूचीबद्ध करना
curl "https://api14.com/api/v1/models?category=rerank"
त्रुटियाँ
| स्टेटस | कोड | कब |
|---|---|---|
| 400 | model_required / invalid_json | model गायब या बॉडी गलत रूप में। |
| 402 | insufficient_balance | आपका USD बैलेंस $0 है। |
| 403 | model_not_allowed | कुंजी की allowlist में मॉडल शामिल नहीं। |
| 404 | model_not_found | अज्ञात या अक्षम मॉडल id। |
| 429 | rate_limited | प्रति मिनट अनुरोध सीमा पार हो गई। |
देखें त्रुटियाँ।