إنشاء تضمينات نصية
إنشاء تضمينات نصية باستخدام ShareAI للبحث الدلالي، الاسترجاع والتشابه، مع تنسيقات الإدخال المدعومة ومتطلبات النموذج.
في هذه الصفحة
https://api.shareai.now/api/v1/embeddingsتحويل نص واحد أو أكثر إلى متجهات تضمين.
- عنوان URL الأساسي
https://api.shareai.now- المصادقة
- مفتاح واجهة برمجة التطبيقات 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 KiB. الردود متزامنة ومحدودة بـ 2 MiB، لذا يمكن أن تتجاوز المتجهات الكبيرة أو الدُفعات حد الرد. قلل حجم الدُفعة أو استخدم أبعادًا أصغر مدعومة. لا يتم قبول مصفوفات معرف الرموز.
المصادقة والتوافر#
يمكن استبدال رمز الوصول OAuth المعتمد بمفتاح API. تتطلب الطلبات الممولة من الحساب surcharge وخطة مقبولة. لا تزال قيود النموذج والمزود سارية. إذا لم يتم تمكين النموذج للتضمينات، اختر نموذج تضمين متاح؛ لا يمكن تغيير بيانات الاعتماد لتمكين نموذج.
الاستخدام#
التضمينات تستهلك رموز الإدخال. تحقق من تسعير النموذج قبل تشغيل دفعة كبيرة واستخدم استخدام وحدة التحكم لمراجعة النشاط. تعامل مع أخطاء التحقق، التفويض والتوافر قبل إعادة المحاولة.
آخر تحديث سبتمبر 15, 2026