ShareAI Platform Docs

టెక్స్ట్ ఎంబెడింగ్స్ సృష్టించండి

సెమాంటిక్ సెర్చ్, రిట్రీవల్ మరియు సిమిలారిటీ కోసం ShareAIతో టెక్స్ట్ ఎంబెడింగ్స్‌ను రూపొందించండి, మద్దతు ఉన్న ఇన్‌పుట్ ఫార్మాట్లు మరియు మోడల్ అవసరాలతో.

Markdown గా వీక్షించండి
ఈ పేజీలో
POST 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"
}'

అభ్యర్థన ఫీల్డ్స్#

ఫీల్డ్విలువ
modelప్రారంభించబడిన ఎంబెడింగ్ మోడల్ ID.
inputఖాళీ కాని స్ట్రింగ్ లేదా 128 ఖాళీ కాని స్ట్రింగ్‌ల వరకు ఉన్న అర్రే.
encoding_formatfloat లేదా 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-small1,5361–1,536
openai/text-embedding-3-large3,0721–3,072
openai/text-embedding-ada-0021,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. అందుబాటులో లేని అమలు మార్గం ఎప్పుడూ ఖాళీ విజయవంతమైన ఫలితాన్ని తిరిగి ఇవ్వకుండా లోప స్థితిని తిరిగి ఇస్తుంది.

సంయుక్త పాఠ్య మరియు చిత్ర ఎంబెడ్డింగ్స్#

ప్రారంభించబడిన మల్టీమోడల్ ఎంబెడ్డింగ్ మోడల్ పాఠ్యం మరియు image_url భాగాలను కలిగి ఉన్న కంటెంట్ ఆబ్జెక్ట్‌ను స్వీకరించవచ్చు. ఒక కంటెంట్ ఆబ్జెక్ట్ ఒక ఎంబెడ్డింగ్‌ను ఉత్పత్తి చేస్తుంది; కంటెంట్ ఆబ్జెక్టుల శ్రేణి ఒక బ్యాచ్. మీ మోడల్ చిత్ర ఇన్‌పుట్‌ను మరియు సమీక్షించిన మీడియా కాంటెక్స్ట్ బడ్జెట్‌ను ప్రకటించాలి. పాఠ్య-మాత్రం మోడల్స్ మీడియాను తిరస్కరిస్తాయి. HTTPS చిత్రం URLలు మరియు మద్దతు ఉన్న base64 చిత్రం డేటా URLలు స్వీకరించబడతాయి; టోకెన్-ID శ్రేణులు, ఆడియో/వీడియో/ఫైల్ ఎంబెడ్డింగ్ భాగాలు ప్రస్తుతం మద్దతు ఇవ్వబడలేదు.

JSON

{
  "input": {
    "content": [
      {
        "type": "text",
        "text": "A forest path."
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/forest.png"
        }
      }
    ]
  }
}

ఐచ్ఛిక input_type అనేది search_query లేదా search_document వంటి మోడల్-నిర్దిష్ట స్ట్రింగ్. వెక్టర్ డైమెన్షన్స్ అవుట్‌పుట్ టోకెన్లు కావు. ఎంబెడ్డింగ్ ధరలు మరియు ప్రొవైడర్ ఓవర్‌రైడ్లు ఇన్‌పుట్ టారిఫ్‌లను మాత్రమే కలిగి ఉంటాయి; అవుట్‌పుట్ మరియు క్యాష్ టారిఫ్‌లు తిరస్కరించబడతాయి, జీరో-విలువ గల ఎంట్రీలను కూడా కలుపుకుని.

మద్దతు ఉన్న ఎంబెడ్డింగ్ అభ్యర్థన ఫీల్డ్స్#

ఫీల్డ్రకంఅర్థం మరియు పరిమితులు
model అవసరంస్ట్రింగ్ఖచ్చితంగా ఎనేబుల్ చేయబడిన పబ్లిక్ మోడల్ ఐడెంటిఫైయర్. ఈ ఆపరేషన్‌ను ప్రకటించాలి మరియు మీ క్రెడెన్షియల్ ద్వారా అనుమతించబడాలి.
input అవసరంstring | array | objectఖాళీ కాని పాఠ్యం లేదా గరిష్టంగా 128 ఖాళీ కాని పాఠ్యాలు; కలిపిన పాఠ్యం గరిష్టంగా 256 KiB. సమీక్షించిన సంయుక్త పాఠ్య/చిత్ర కంటెంట్ ఆబ్జెక్టులు స్పష్టమైన చిత్రం మద్దతు మరియు కాంటెక్స్ట్ బడ్జెట్‌ను అవసరం చేస్తాయి. పూర్తి సంఖ్య టోకెన్ శ్రేణులు, ఆడియో, వీడియో మరియు ఫైళ్లు మద్దతు ఇవ్వబడలేదు.
input_typeస్ట్రింగ్ఐచ్ఛిక మోడల్-నిర్దిష్ట ఎంబెడ్డింగ్ ప్రయోజనం, ఉదాహరణకు search_query లేదా search_document; ఖాళీ కాని మరియు గరిష్టంగా 100 అక్షరాలు.
encoding_formatస్ట్రింగ్ఎంబెడ్డింగ్ ఎన్‌కోడింగ్: float (డిఫాల్ట్) లేదా base64. ఎన్‌కోడింగ్ అవుట్‌పుట్-టోకెన్ ఛార్జ్‌ను సృష్టించదు.
dimensionsపూర్ణాంకంఐచ్ఛిక ఎంబెడ్డింగ్ వెక్టర్ పరిమాణం, 1–65536 మరియు ఎంపిక చేసిన మోడల్ ద్వారా మద్దతు ఇవ్వబడుతుంది. స్థిర పరిమాణం ఉన్న మోడల్స్ కోసం వదలండి.
providerఆబ్జెక్ట్ఐచ్ఛిక ప్రొవైడర్ రూటింగ్ ప్రాధాన్యతలు. మోడల్ IDలో ప్రిఫిక్స్‌గా కాకుండా, ప్రొవైడర్.ఒన్లీని ఆమోదించబడిన ప్రొవైడర్ ట్యాగ్‌ల కోసం ఉపయోగించండి. ఖాతా మరియు క్రెడెన్షియల్ పరిమితులు ఇంకా వర్తిస్తాయి.

చివరిసారి నవీకరించబడింది నవంబర్ 3, 2026

ShareAI ప్లాట్‌ఫారమ్ డాక్స్
అన్ని డాక్యుమెంటేషన్

శీర్షిక లేదా కంటెంట్ ద్వారా శోధించండి.

ఈ పేజీ గురించి అడగండి

ఈ పేజీని అన్వేషించడానికి సహాయకుడిని ఎంచుకోండి. మీరు పేజీని కాపీ చేసి మీ సంభాషణలో పేస్ట్ చేయవచ్చు.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI