టెక్స్ట్ ఎంబెడింగ్స్ సృష్టించండి
సెమాంటిక్ సెర్చ్, రిట్రీవల్ మరియు సిమిలారిటీ కోసం ShareAIతో టెక్స్ట్ ఎంబెడింగ్స్ను రూపొందించండి, మద్దతు ఉన్న ఇన్పుట్ ఫార్మాట్లు మరియు మోడల్ అవసరాలతో.
ఈ పేజీలో
https://api.shareai.now/api/v1/embeddingsఒకటి లేదా అంతకంటే ఎక్కువ టెక్స్ట్లను ఎంబెడింగ్ వెక్టర్లుగా మార్చండి.
- బేస్ URL
https://api.shareai.now- authentication
- Bearer API కీ లేదా ఆమోదించిన OAuth యాక్సెస్ టోకెన్
ShareAIలో ప్రారంభించబడిన మరియు మీ క్రెడెన్షియల్ ద్వారా అనుమతించబడిన ఎంబెడింగ్ మోడల్ను ఎంచుకోండి. చాట్ మోడల్లను ఎంబెడింగ్ మోడల్లకు ప్రత్యామ్నాయంగా ఉపయోగించలేరు. మోడల్ లభ్యత మరియు మద్దతు ఉన్న ఎంపికలు కాన్ఫిగర్ చేసిన ప్రొవైడర్పై ఆధారపడి ఉంటాయి.
అభ్యర్థనను పంపండి#
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/embeddings" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"provider": {
"sort": {
"by": "price",
"direction": "asc"
}
},
"model": "YOUR_EMBEDDING_MODEL",
"input": [
"How do I connect a device?",
"Where can I read my usage?"
],
"encoding_format": "float"
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'provider': {'sort': {'by': 'price', 'direction': 'asc'}}, 'model': 'YOUR_EMBEDDING_MODEL', 'input': ['How do I connect a device?', 'Where can I read my usage?'], 'encoding_format': 'float'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/embeddings', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/embeddings";
const headers: Record<string, string> = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"provider": {
"sort": {
"by": "price",
"direction": "asc"
}
},
"model": "YOUR_EMBEDDING_MODEL",
"input": [
"How do I connect a device?",
"Where can I read my usage?"
],
"encoding_format": "float"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
అభ్యర్థన ఫీల్డ్స్#
| ఫీల్డ్ | విలువ |
|---|---|
model | ప్రారంభించబడిన ఎంబెడింగ్ మోడల్ ID. |
input | ఖాళీ కాని స్ట్రింగ్ లేదా 128 ఖాళీ కాని స్ట్రింగ్ల వరకు ఉన్న అర్రే. |
encoding_format | float లేదా base64. |
dimensions | ఎంపికైన మోడల్ మద్దతు ఇచ్చే కొలతలలో స్పష్టంగా ప్రచురించబడిన 1 నుండి 65536 వరకు ఐచ్ఛిక పూర్తి సంఖ్య. మోడల్ డిఫాల్ట్ను ఉపయోగించడానికి దీన్ని వదిలివేయండి. |
వెక్టర్లను చదవండి#
చదవండి data అర్రే మరియు ప్రతి ఫలితాన్ని ఉపయోగించండి index దాని ఎంబెడింగ్ను ఇన్పుట్తో సరిపోల్చడానికి. మీ డాక్యుమెంట్లు మరియు శోధన ప్రశ్నలను ఎంబెడ్ చేయేటప్పుడు అదే మోడల్ మరియు డైమెన్షన్లను ఉంచండి. ఫలితంలో ప్రొవైడర్-రిపోర్ట్ చేసిన usage.
పరిమితులలో బ్యాచ్#
కలిపిన ఇన్పుట్ టెక్స్ట్ పరిమితి 256 KiB. ఒక మోడల్ చిన్న బ్యాచ్, ప్రతి ఇన్పుట్ బైట్ మరియు కలిపిన బైట్ పరిమితులను ప్రచురించవచ్చు, లేదా మద్దతు ఉన్న ఎన్కోడింగ్స్ను పరిమితం చేయవచ్చు. మద్దతు లేని కొలతలు లేదా ఎన్కోడింగ్స్ అమలు చేయడానికి ముందు తిరస్కరించబడతాయి. ప్రతిస్పందనలు సమకాలీనంగా ఉంటాయి మరియు 2 MiB వరకు పరిమితం చేయబడతాయి, కాబట్టి పెద్ద వెక్టర్లు లేదా బ్యాచ్లు ప్రతిస్పందన పరిమితిని మించవచ్చు. బ్యాచ్ పరిమాణాన్ని తగ్గించండి లేదా మద్దతు ఉన్న చిన్న కొలతలను ఉపయోగించండి. టోకెన్-ID అర్రేలను ఆమోదించరు.
ధృవీకరణ మరియు లభ్యత#
inferenceను నెట్వర్క్ ఖర్చుతో AI కోసం ఉపయోగించండి, లేదా monetization_gatewayను ఆమోదించబడిన Builder మార్కప్ మరియు ఆమోదిత బిల్లింగ్ నిబంధనలతో AI కోసం ఉపయోగించండి. ఉత్పత్తి లేదా సబ్స్క్రిప్షన్ చెకౌట్ కోసం paymentsను ప్రత్యేకంగా అభ్యర్థించండి. ఐడెంటిటీ-మాత్రమే యాక్సెస్ ఏ రకమైన ఖర్చును కూడా అనుమతించదు. మోడల్, ప్రొవైడర్ మరియు ఖాతా పరిమితులు ఇంకా వర్తిస్తాయి. చూడండి స్కోపులు మరియు అనుమతులు.
వినియోగం#
ఎంబెడింగ్లు ఇన్పుట్ టోకెన్లను వినియోగిస్తాయి. పెద్ద బ్యాచ్ను అమలు చేయడానికి ముందు మోడల్ ధరలను తనిఖీ చేయండి మరియు కన్సోల్ వినియోగం కార్యకలాపాన్ని సమీక్షించడానికి. తిరిగి ప్రయత్నించే ముందు ధృవీకరణ, అనుమతి మరియు లభ్యత లోపాలను నిర్వహించండి.
మోడల్ ఐడెంటిటీ మరియు అమలు ప్రొవైడర్లు#
క్రియేటర్ ఆధారిత మోడల్ ఐడెంటిఫైయర్ను కచ్చితంగా కాపీ చేయండి మోడల్స్. ఆప్షనల్తో మౌలిక సదుపాయాన్ని వేరుగా ఎంచుకోండి provider ఆబ్జెక్ట్. డిఫాల్ట్ అర్హమైన ప్రొవైడర్లను ధర ఆధారంగా ర్యాంక్ చేస్తుంది, తక్కువ ధర మొదట. ప్రొవైడర్లను ఎంచుకోండి లేదా సంప్రదించండి పూర్తి పాలసీ రిఫరెన్స్.
ప్రతిస్పందనను చదవండి#
క్రింది వెక్టర్లు సంక్షిప్త వివరణాత్మక ఉదాహరణలు. నిజమైన వెక్టర్లు ఎంపిక చేసిన మోడల్ మరియు అభ్యర్థించిన ఎంపికల ద్వారా మద్దతు ఇచ్చే కొలతల సంఖ్యను కలిగి ఉంటాయి. సూచికలు అసలు ఇన్పుట్లను గుర్తిస్తాయి. usage.prompt_tokens మొత్తం బ్యాచ్ కోసం ధృవీకరించబడిన ఇన్పుట్-టోకెన్ సంఖ్య; usage.total_tokens ఆ సంఖ్యకు సమానం. ఈ వినియోగాన్ని వెక్టర్ల సంఖ్యతో గుణించవద్దు. ఎంబెడింగ్స్కు బిల్లింగ్ చేయదగిన అవుట్పుట్ టోకెన్లు ఉండవు.
JSON
{
"object": "list",
"model": "YOUR_EMBEDDING_MODEL",
"data": [
{
"object": "embedding",
"index": 0,
"embedding": [
0.12,
-0.03,
0.44
]
},
{
"object": "embedding",
"index": 1,
"embedding": [
0.09,
0.21,
-0.17
]
}
],
"usage": {
"prompt_tokens": 5,
"total_tokens": 5
}
}
ShareAI క్యాటలాగ్లో OpenAI ఎంబెడింగ్ మోడల్స్#
ఈ ప్రత్యేక మోడల్స్ OpenAI ద్వారా సృష్టించబడ్డాయి. ShareAI అమలు ప్రొవైడర్, వాటి సృష్టికర్త కాదు. క్యాటలాగ్ ఎంట్రీలు మోడల్ వెయిట్లను పంపిణీ చేయవు. మీ అభ్యర్థనలో ఖచ్చితమైన ShareAI గుర్తింపును ఉపయోగించండి.
| ShareAI మోడల్ గుర్తింపు | డిఫాల్ట్ వెక్టర్ పరిమాణం | ఐచ్ఛిక కొలతలు |
|---|---|---|
openai/text-embedding-3-small | 1,536 | 1–1,536 |
openai/text-embedding-3-large | 3,072 | 1–3,072 |
openai/text-embedding-ada-002 | 1,536 | మద్దతు లేదు; వదిలివేయండి dimensions |
అన్ని మూడు టెక్స్ట్ను స్వీకరించి ఎంబెడింగ్ వెక్టర్లను తిరిగి ఇస్తాయి POST /api/v1/embeddings. అవి చాట్ ప్రతిస్పందనలు లేదా చిత్రాలను ఉత్పత్తి చేయవు. ప్రతి ఇన్పుట్ 8,192 మోడల్ టోకెన్లకు పరిమితం. ShareAI గరిష్టంగా 128 టెక్స్ట్ ఇన్పుట్లను మరియు ప్రతి అభ్యర్థనకు 256 KiB కలిపిన ఇన్పుట్ను అంగీకరిస్తుంది; టోకెన్-అర్ర ఇన్పుట్ను మద్దతు ఇవ్వదు. ఫ్లోట్ మరియు బేస్64 ప్రాతినిధ్యాలు అదే సంఖ్యా వెక్టర్లను వివరిస్తాయి.
ప్రొవైడర్లు తమ స్వంత ఇన్పుట్ టారిఫ్లను ప్రొవైడర్ ప్రోగ్రామ్ లేదా ఫాల్బ్యాక్ మెకానిజంలలో కాన్ఫిగర్ చేస్తారు. ఈ మోడల్ నిర్వచనాల ద్వారా ఏ ప్రొవైడర్ ధర స్థిరంగా ఉండదు. అమలు కూడా కాన్ఫిగర్ చేయబడిన ప్రొవైడర్, అనుకూలమైన మార్గం మరియు ఎనేబుల్ చేయబడిన మోడల్ అవసరం; కేటలాగ్ ఎంట్రీని జోడించడం మాత్రమే inferenceను సక్రియం చేయదు. మీరు ఎంబెడింగ్ మోడల్ లేదా వెక్టర్ పరిమాణాన్ని మార్చినట్లయితే, ప్రభావిత వెక్టర్ సూచికను మళ్లీ నిర్మించండి.
చూడండి OpenAI ఎంబెడింగ్ గైడ్ అప్స్ట్రీమ్ మోడల్ ప్రవర్తన కోసం. ShareAI ప్రవేశం, అనుమతి, పరిమితులు మరియు సెటిల్మెంట్ ఈ పేజీలోని ఒప్పందాన్ని అనుసరిస్తాయి.
ఎంబెడింగ్ వినియోగం ఎలా ఛార్జ్ చేయబడుతుంది#
ShareAI మొత్తం బ్యాచ్ కోసం ధృవీకరించబడిన ఇన్పుట్-టోకెన్ వినియోగాన్ని ఒకసారి ఛార్జ్ చేస్తుంది. ఎంబెడింగ్ వెక్టర్లకు బిల్లింగ్ అవుట్పుట్ టోకెన్లు ఉండవు. వెక్టర్ డైమెన్షన్లు, JSON పరిమాణం మరియు బేస్64 ఎన్కోడింగ్ అవుట్పుట్-టోకెన్ వినియోగం కాదు. ఇన్పుట్ టారిఫ్ అమలు ముందు స్థిరంగా ఉంటుంది; ఒక అంగీకరించిన అప్లికేషన్ surcharge వేరుగా జోడించబడుతుంది. కన్సోల్ యూజ్జ్ మీకు ఎంబెడింగ్ల ద్వారా ఫిల్టర్ చేయడానికి మరియు రికార్డ్ చేయబడిన ఛార్జ్లను పరిశీలించడానికి అనుమతిస్తుంది. ప్రొవైడర్ అసంపూర్ణ వెక్టర్లను లేదా అసంగత వినియోగాన్ని తిరిగి ఇస్తే, అభ్యర్థన ఛార్జ్ను సృష్టించకుండా విఫలమవుతుంది. ఈ సెటిల్మెంట్ ఒప్పందం అందుబాటులో ఉండటం ఇన్స్టాల్ చేయబడిన అమలు-సర్వీస్ వెర్షన్లపై ఆధారపడి ఉంటుంది.
పెద్ద రన్కు ముందు అందుబాటును ధృవీకరించండి#
కేటలాగ్ సామర్థ్యాలు మోడల్ను వివరిస్తాయి; ప్రత్యక్ష అందుబాటుకు కూడా క్రియాశీలమైన, అనుకూలమైన అమలు మార్గం అవసరం. API మోడల్ అలౌలిస్ట్ మాత్రమే అందుబాటును నిరూపించదు. ప్రొవైడర్లు మళ్లీ కనెక్ట్ అవుతున్నప్పుడు అభ్యర్థన విఫలమవుతుంది. నిర్ధారించబడిన ప్రీ-అమలు అందుబాటులో విఫలతలను పరిమిత బ్యాకాఫ్తో మళ్లీ ప్రయత్నించండి. అమలు తర్వాత టైమ్ఔట్ లేదా కనెక్షన్ కోల్పోవడం జరుగుతుంది; అదే పనిని మళ్లీ సమర్పించే ముందు కన్సోల్ యూజ్జ్ను సమీక్షించండి. ఉన్న వెక్టర్ సూచిక కోసం ఎంబెడింగ్ మోడల్లను ఆటోమేటిక్గా మార్చవద్దు.
టైమ్ఔట్లు మరియు రీట్రైలు#
ShareAI ఒక అభ్యర్థనను పంపిన తర్వాత విఫలమైన అప్స్ట్రీమ్ ఎంబెడింగ్ కాల్ను మరో అభ్యర్థికి ఆటోమేటిక్గా సమర్పించదు. కనెక్షన్ అంతరాయం కలిగే ముందు ఒక ప్రొవైడర్ దానిని ప్రాసెస్ చేసి ఉండవచ్చు. మిస్సింగ్ లేదా అసంగత వినియోగం ఆవిష్కృత డెబిట్ లేకుండా తిరస్కరించబడుతుంది. దాని ప్రతిస్పందన కోల్పోయినప్పటికీ విజయవంతమైన సెటిల్మెంట్ ఒకసారి మాత్రమే రికార్డ్ చేయబడుతుంది. ఈ ఎండ్పాయింట్ పబ్లిక్ అభ్యర్థన-స్థాయి ఐడెంపోటెన్సీని అందించదు; అనిశ్చితమైన అభ్యర్థనను పునరావృతం చేయడానికి ముందు కన్సోల్ యూజ్జ్ను సమీక్షించండి.
మీరు నిర్వహించగల తప్పులు#
- 400: చెల్లని ఇన్పుట్, మద్దతు లేని ఎంపికలు లేదా అవసరమైన సామర్థ్యం లేని మోడల్.
- 401 / 403: మళ్లీ ధృవీకరించండి లేదా క్రెడెన్షియల్ యొక్క మోడల్, ప్రొవైడర్ మరియు ఖాతా అనుమతులను తనిఖీ చేయండి.
- 402: అనుకూలమైన క్రెడిట్లు లేదా కస్టమర్ యొక్క అప్లికేషన్ ఖర్చు పరిమితి అభ్యర్థనను నిరోధిస్తుంది. తిరిగి ఇచ్చిన కస్టమర్ రికవరీ లింక్ను ఉపయోగించండి.
- 429: ఖాతా లేదా అమలు పరిమితులు; గౌరవించండి
Retry-After. - 502: ప్రొవైడర్ ఫలితం లేదా వినియోగాన్ని ధృవీకరించలేకపోయారు.
- 503 / 504: అమలు లేదా సెటిల్మెంట్ అందుబాటులో లేదు, లేదా అభ్యర్థన టైమ్ అవుట్ అయింది. అనిశ్చితమైన ఫలితానికి, మళ్లీ సమర్పించే ముందు Console Usage ను తనిఖీ చేయండి.
లోపాలు టాప్-లెవల్ error ఆబ్జెక్ట్తో ఉపయోగిస్తాయి type, code మరియు message. అందుబాటులో లేని అమలు మార్గం ఎప్పుడూ ఖాళీ విజయవంతమైన ఫలితాన్ని తిరిగి ఇవ్వకుండా లోప స్థితిని తిరిగి ఇస్తుంది.
చివరిసారి నవీకరించబడింది నవంబర్ 3, 2026