ایجاد جاسازیهای متنی
جاسازیهای متنی را با ShareAI برای جستجوی معنایی، بازیابی و شباهت، با فرمتهای ورودی پشتیبانیشده و الزامات مدل تولید کنید.
در این صفحه
https://api.shareai.now/api/v1/embeddingsتبدیل یک یا چند متن به بردارهای تعبیهشده.
- URL پایه
https://api.shareai.now- احراز هویت
- کلید API Bearer یا توکن دسترسی 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 '{
"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 = {'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 = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"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 | شناسه یک مدل تعبیهشده فعال. |
input | یک رشته غیرخالی یا آرایهای تا 128 رشته غیرخالی. |
encoding_format | float یا base64. |
dimensions | عدد صحیح اختیاری از 1 تا 65536؛ مدل انتخابشده باید از آن پشتیبانی کند. |
بردارها را بخوانید#
بخوانید data آرایه و استفاده از نتیجه هر index برای تطبیق تعبیه آن با ورودی. هنگام تعبیه اسناد و جستجوهای خود، از همان مدل و ابعاد استفاده کنید. نتیجه همچنین شامل گزارش ارائهدهنده است. usage.
دستهبندی در محدودهها#
متن ورودی ترکیبی به 256 کیلوبایت محدود شده است. پاسخها همزمان هستند و به 2 مگابایت محدود شدهاند، بنابراین بردارهای بزرگ یا دستههای بزرگ ممکن است از حد پاسخ فراتر روند. اندازه دسته را کاهش دهید یا از ابعاد کوچکتر پشتیبانیشده استفاده کنید. آرایههای شناسه توکن پذیرفته نمیشوند.
احراز هویت و دسترسی#
یک توکن دسترسی OAuth تأییدشده میتواند جایگزین کلید API شود. درخواستهای تأمینشده توسط حساب نیاز دارند surcharge و یک طرح پذیرفتهشده. محدودیتهای مدل و ارائهدهنده همچنان اعمال میشوند. اگر مدل برای تعبیه فعال نشده باشد، یک مدل تعبیهشده موجود را انتخاب کنید؛ تغییر اعتبارنامه نمیتواند یک مدل را فعال کند.
استفاده#
تعبیهها توکنهای ورودی مصرف میکنند. قبل از اجرای یک دسته بزرگ، قیمتگذاری مدل را بررسی کنید و از استفاده کنید. برای بررسی فعالیت. خطاهای اعتبارسنجی، احراز هویت و دسترسی را قبل از تلاش مجدد مدیریت کنید.
آخرین بهروزرسانی سپتامبر 15, 2026