Panga upya nyaraka
Toa swali na hati 1–1000.
Kwenye ukurasa huu
https://api.shareai.now/api/v1/rerankPanga upya nyaraka
- URL ya Msingi
https://api.shareai.now- Uthibitishaji
- Funguo ya API ya Bearer au tokeni ya ufikiaji ya OAuth iliyokubaliwa
- Upeo unaohitajika
inferenceormonetization_gateway
Toa swali na hati 1–1000. Kila hati ni maandishi, {"text":"..."} kitu au kitu kinachoungwa mkono na modeli. {"image":"https://..."} kitu. top_n lazima iwe angalau 1 na isizidi idadi ya hati. Linganisha matokeo na faharasa asili za hati.
Kabla ya kuanza#
Weka SHAREAI_API_KEY kwenye seva yako na badilisha nafasi ya mfano na mfano uliowezeshwa kwa sasa. Kamwe usifunue API key kwenye msimbo wa kivinjari. Mfano, akaunti, kitambulisho na mtoa huduma lazima vyote viruhusu operesheni hii. Mipangilio ya hiari hapa chini inahitaji msaada wa mfano; mipaka ya usalama ya API si ahadi kwamba kila mfano unasaidia kila thamani.
Tuma ombi#
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);Sehemu za ombi#
| Sehemu | Aina | Maana na mipaka |
|---|---|---|
model inahitajika | kamba | Kitambulisho halisi cha mfano wa umma uliowezeshwa. Lazima kitangaze operesheni hii na kuruhusiwa na kitambulisho chako. |
query inahitajika | kamba | Swali lenye umuhimu lisilo tupu. |
documents inahitajika | safu | Mistari ya maandishi 1–1000 isiyo tupu au vitu vya maandishi/picha vyenye ufunguo mmoja. Thamani za picha lazima ziwe URL za HTTPS au URL za data za picha zinazoungwa mkono, na msaada wa pembejeo za picha za modeli. |
top_n | nambari kamili | Idadi ya matokeo ya hiari kutoka 1 hadi idadi ya hati. Faharasa zilizorejeshwa zinahusu safu asili ya hati. |
return_documents | boolean | Ujumuishaji wa hiari wa hati asili zinazoungwa mkono na mtoa huduma katika matokeo. |
provider | kitu | Mapendeleo ya hiari ya uelekezaji wa mtoa huduma. Tumia provider.only kwa vitambulisho vya mtoa huduma vilivyokubaliwa, si kiambishi awali kwenye ID ya mfano. Vizuizi vya akaunti na kitambulisho bado vinatumika. |
Soma matokeo#
Mafanikio yanarudisha HTTP 200 na JSON. Toa swali na hati 1–1000. Kila hati ni maandishi, {"text":"..."} kitu au kitu kinachoungwa mkono na modeli. {"image":"https://..."} kitu. top_n lazima iwe angalau 1 na isizidi idadi ya hati. Linganisha matokeo na faharasa asili za hati.
Vitengo vya malipo#
Viwango vya kupanga upya vinaweza kutumia tokeni za pembejeo, hati zilizopangwa, maombi au idadi ya utafutaji iliyoripotiwa na mtoa huduma. Hakuna ubadilishaji wa utafutaji hadi tokeni wa ulimwengu wote unaodhaniwa. Mtoa huduma ambaye hawezi kuripoti kipimo kilichopangwa bei hatapatikana kwa kiwango hicho.
Chagua kitambulisho halisi cha mfano uliowezeshwa kutoka Console. Operesheni yake iliyotangazwa na uwezo wa pembejeo/pato lazima vilingane na endpoint hii; mfano wa mazungumzo ya maandishi hauwezi kubadilishwa kwa operesheni nyingine. Vizuizi vya kitambulisho, mtoa huduma na akaunti yako bado vinatumika.
Bei na matumizi#
Viwango vinachapishwa kwa EUR AI credits kwa mfano ulioteuliwa, mtoa huduma, vitengo na tofauti. Vipimo tu katika ada yake inayotumika vinatozwa. Makadirio yanahifadhi credits kabla ya utekelezaji; malipo ya mwisho hutumia matumizi yaliyopimwa. Bei zinaweza kutegemea azimio, muundo wa pato au kiwango cha matumizi. Angalia Console Usage kwa deni la mwisho la ShareAI. Sehemu za gharama za juu na baiti za vyombo vya habari hazibadilishwi kuwa hesabu za tokeni zilizobuniwa.
Ufikiaji na makosa#
Tumia inference kwa inference ya gharama ya mtandao iliyokubaliwa au monetization_gateway kwa markup ya Builder iliyokubaliwa na masharti ya malipo yaliyokubaliwa. Ufikiaji wa kitambulisho pekee hauidhinishi matumizi. Uthibitishaji, idhini ya mfano, credits zisizotosha, mipaka ya kiwango na kushindwa kwa utekelezaji hurudisha error. Baada ya muda wa kusubiri au uwasilishaji usio na uhakika, kagua Usage au kazi ya video kabla ya kuunda ombi lingine linaloweza kulipwa.
Ilisasishwa mwisho Novemba 3, 2026