Sake jera takardu
Samar da tambaya da takardu 1–1000.
A wannan shafin
https://api.shareai.now/api/v1/rerankSake jera takardu
- URL na Asali
https://api.shareai.now- Tantancewa
- Maɓallin API na Bearer ko takardar izinin shiga OAuth da aka amince da ita
- Dole ne a sami izini
inferenceormonetization_gateway
Bayar da tambaya da takardu 1–1000. Kowanne takardu rubutu ne, wani {"text":"..."} abu ko wani abu da samfurin ya tallafa masa {"image":"https://..."} abu. top_n dole ya zama akalla 1 kuma ba zai wuce adadin takardu ba. Daidaita sakamakon da alamun takardu na asali.
Kafin ka fara#
Saita SHAREAI_API_KEY akan uwar garken ku kuma maye gurbin wurin samfurin samfurin da samfurin da aka kunna a halin yanzu. Kada ku taɓa bayyana maɓallin API a cikin lambar burauza. Samfurin, asusu, takaddun shaida da mai bayarwa dole ne duk su ba da izinin wannan aikin. Saitunan zaɓi a ƙasa suna buƙatar tallafin samfurin; iyakokin aminci na API ba alkawari bane cewa kowane samfurin yana tallafawa kowane ƙima.
Aika buƙata#
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);Filayen buƙata#
| Filin | Nau'in | Ma'ana da iyakoki |
|---|---|---|
model wajibi | kirtani | Takamaiman mai gano samfurin jama'a da aka kunna. Dole ne a bayyana wannan aiki kuma takardun shaidarka su yarda da shi. |
query wajibi | kirtani | Tambaya mai dacewa da ba ta zama babu komai ba. |
documents wajibi | jerin abubuwa | Rubutun da ba su zama babu komai ba 1–1000 ko abubuwan rubutu/hoto masu maɓalli guda. Ƙimar hotuna dole ne su zama HTTPS URLs ko URLs na bayanan hoto da aka tallafa, tare da tallafin shigar hoton samfurin. |
top_n | lamba | Zaɓin adadin sakamako daga 1 zuwa adadin takardu. Alamun da aka dawo suna nufin jerin takardu na asali. |
return_documents | gaskiya/ƙarya | Zaɓin haɗa takardu na asali da mai bayarwa ya tallafa a cikin sakamakon. |
provider | abu | Zaɓin fifikon hanyar mai bayarwa. Yi amfani da provider.only don alamun mai bayarwa da aka karɓa, ba don farkon ID na samfur ba. Har yanzu ana amfani da iyakokin asusu da takardun shaida. |
Karanta sakamakon#
Nasara tana dawo da HTTP 200 tare da JSON. Bayar da tambaya da takardu 1–1000. Kowanne takardu rubutu ne, wani {"text":"..."} abu ko wani abu da samfurin ya tallafa masa {"image":"https://..."} abu. top_n dole ya zama akalla 1 kuma ba zai wuce adadin takardu ba. Daidaita sakamakon da alamun takardu na asali.
Rukunin biyan kuɗi#
Farashin sake jera zai iya amfani da alamun shigarwa, takardu da aka tantance, buƙatu ko adadin bincike da mai bayarwa ya bayar. Ba a ɗauka cewa akwai juyawar bincike-zuwa-alamu ta duniya ba. Mai bayarwa wanda ba zai iya bayar da ma'auni mai farashi ba ba ya samuwa don wannan farashin.
Zaɓi ainihin mai gano samfurin da aka kunna daga Console. Ayyukansa da damar shigarwa/fitarwa da aka bayyana dole ne su dace da wannan wurin; samfurin hira da rubutu ba za a iya maye gurbinsa da wani aiki ba. Takaddun shaida, mai bayarwa da iyakokin asusunku har yanzu suna aiki.
Farashi da amfani#
Farashin ana wallafa su a cikin EUR AI credits don samfurin da aka zaɓa, mai bayarwa, raka'o'i da bambance-bambance. Ana cajin kawai girman da ke cikin farashin aiki. Kimantawa yana adana credits kafin aiwatarwa; cajin ƙarshe yana amfani da amfani da aka auna. Farashin na iya dogara da ƙuduri, tsarin fitarwa ko rukuni na amfani. Duba Console Usage don ShareAI debit na ƙarshe. Filayen farashin sama da bytes na kafofin watsa labarai ba a canza su zuwa adadin tokon da aka ƙirƙira ba.
Samuwa da kurakurai#
Amfani inference don amincewa da farashin hanyar sadarwa ko monetization_gateway don amincewa da ƙarin Builder da sharuɗɗan biyan kuɗi da aka karɓa. Samun izini kawai ba ya ba da izinin kashe kuɗi. Tabbatarwa, izinin samfurin, ƙarancin credits, iyakokin farashi da gazawar aiwatarwa suna dawo da tsari error. Bayan lokaci ko gabatarwa mara tabbas, bincika Amfani ko aikin bidiyo kafin ƙirƙirar wata buƙata mai yiwuwa da aka biya.
An sabunta karshe Nuwamba 3, 2026