డాక్యుమెంట్లను రీ-ర్యాంక్ చేయండి
ఒక ప్రశ్నను మరియు 1–1000 డాక్యుమెంట్లను అందించండి.
ఈ పేజీలో
https://api.shareai.now/api/v1/rerankడాక్యుమెంట్లను రీ-ర్యాంక్ చేయండి
- బేస్ URL
https://api.shareai.now- authentication
- Bearer API కీ లేదా ఆమోదించిన OAuth యాక్సెస్ టోకెన్
- అవసరమైన scope
inferenceormonetization_gateway
ఒక ప్రశ్నను మరియు 1–1000 డాక్యుమెంట్లను అందించండి. ప్రతి డాక్యుమెంట్ టెక్స్ట్, ఒక {"text":"..."} ఆబ్జెక్ట్ లేదా మోడల్-మద్దతు {"image":"https://..."} ఆబ్జెక్ట్. top_n కనీసం 1 ఉండాలి మరియు డాక్యుమెంట్ సంఖ్య కంటే ఎక్కువ ఉండకూడదు. ఫలితాలను అసలు డాక్యుమెంట్ సూచికలకు సరిపోల్చండి.
మీరు ప్రారంభించడానికి ముందు#
మీ సర్వర్లో 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 అవసరం | అర్రే | 1–1000 ఖాళీ కాని టెక్స్ట్ స్ట్రింగ్స్ లేదా సింగిల్-కీ టెక్స్ట్/ఇమేజ్ ఆబ్జెక్ట్స్. ఇమేజ్ విలువలు HTTPS URLs లేదా మోడల్ ఇమేజ్-ఇన్పుట్ మద్దతుతో ఉన్న ఇమేజ్ డేటా URLs కావాలి. |
top_n | పూర్ణాంకం | డాక్యుమెంట్ల సంఖ్య వరకు ఐచ్ఛిక ఫలిత సంఖ్య. తిరిగి వచ్చిన సూచికలు అసలు డాక్యుమెంట్ అర్రేకు సంబంధించినవి. |
return_documents | బూలియన్ | ఫలితంలో అసలు డాక్యుమెంట్లను చేర్చడం ప్రొవైడర్ మద్దతుతో ఐచ్ఛికం. |
provider | ఆబ్జెక్ట్ | ఐచ్ఛిక ప్రొవైడర్ రూటింగ్ ప్రాధాన్యతలు. మోడల్ IDలో ప్రిఫిక్స్గా కాకుండా, ప్రొవైడర్.ఒన్లీని ఆమోదించబడిన ప్రొవైడర్ ట్యాగ్ల కోసం ఉపయోగించండి. ఖాతా మరియు క్రెడెన్షియల్ పరిమితులు ఇంకా వర్తిస్తాయి. |
ఫలితాన్ని చదవండి#
విజయవంతమైన ఫలితాలు HTTP 200 తో JSON ను తిరిగి ఇస్తాయి. ఒక ప్రశ్నను మరియు 1–1000 డాక్యుమెంట్లను అందించండి. ప్రతి డాక్యుమెంట్ టెక్స్ట్, ఒక {"text":"..."} ఆబ్జెక్ట్ లేదా మోడల్-మద్దతు {"image":"https://..."} ఆబ్జెక్ట్. top_n కనీసం 1 ఉండాలి మరియు డాక్యుమెంట్ సంఖ్య కంటే ఎక్కువ ఉండకూడదు. ఫలితాలను అసలు డాక్యుమెంట్ సూచికలకు సరిపోల్చండి.
బిల్లింగ్ యూనిట్లు#
రీర్యాంక్ రేట్లు ఇన్పుట్ టోకెన్లు, స్కోర్డ్ డాక్యుమెంట్లు, అభ్యర్థనలు లేదా ప్రొవైడర్-నివేదించిన శోధన పరిమాణాన్ని ఉపయోగించవచ్చు. టోకెన్-కన్వర్షన్ కోసం ఏకరీతి శోధనను అనుమానించరు. ధరకు సంబంధించిన కొలతను నివేదించలేని ప్రొవైడర్ ఆ టారిఫ్కు అందుబాటులో ఉండదు.
Console నుండి ఖచ్చితంగా ఎనేబుల్ చేయబడిన మోడల్ ఐడెంటిఫైయర్ను ఎంచుకోండి. దాని ప్రకటన చేసిన ఆపరేషన్ మరియు ఇన్పుట్/అవుట్పుట్ సామర్థ్యాలు ఈ ఎండ్పాయింట్కు సరిపోవాలి; ఒక ఆపరేషన్ కోసం టెక్స్ట్ చాట్ మోడల్ను మరొకదానితో మార్చలేరు. మీ క్రెడెన్షియల్, ప్రొవైడర్ మరియు ఖాతా పరిమితులు ఇంకా వర్తిస్తాయి.
ధరలు మరియు వినియోగం#
ఎంపిక చేసిన మోడల్, ప్రొవైడర్, యూనిట్లు మరియు వేరియంట్ల కోసం రేట్లు EUR AI క్రెడిట్లలో ప్రచురించబడతాయి. దాని క్రియాశీల టారిఫ్లో ఉన్న కొలతలకే ఛార్జ్ చేయబడుతుంది. అంచనా అమలు ముందు క్రెడిట్లను రిజర్వ్ చేస్తుంది; తుది ఛార్జీలు కొలిచిన వినియోగాన్ని ఉపయోగిస్తాయి. ధరలు రిజల్యూషన్, అవుట్పుట్ ఫార్మాట్ లేదా వినియోగ బ్యాండ్పై ఆధారపడి ఉండవచ్చు. తుది ShareAI డెబిట్ కోసం Console Usageని తనిఖీ చేయండి. అప్స్ట్రీమ్ ఖర్చు ఫీల్డ్స్ మరియు మీడియా బైట్లు ఆవిష్కృత టోకెన్ కౌంట్లుగా మార్చబడవు.
యాక్సెస్ మరియు లోపాలు#
ఉపయోగించండి inference ఆమోదించబడిన నెట్వర్క్-ఖర్చు ఇన్ఫరెన్స్ కోసం లేదా monetization_gateway ఆమోదించబడిన Builder మార్కప్ మరియు ఆమోదించబడిన బిల్లింగ్ నిబంధనల కోసం. ఐడెంటిటీ-మాత్రమే యాక్సెస్ ఖర్చు చేయడానికి అనుమతించదు. ధృవీకరణ, మోడల్ అనుమతి, తగినంత క్రెడిట్లు లేకపోవడం, రేట్ పరిమితులు మరియు అమలు వైఫల్యాలు నిర్మిత error. టైమ్ఔట్ లేదా అనిశ్చిత సమర్పణ తర్వాత, మరొక చెల్లించదగిన అభ్యర్థనను సృష్టించే ముందు Usage లేదా వీడియో పనిని తనిఖీ చేయండి.
చివరిసారి నవీకరించబడింది నవంబర్ 3, 2026