التضمينات (صيغة OpenAI)

الوثائق الرسمية

OpenAI Embeddings

📝 مقدّمة

احصل على تمثيل متجهي لنصٍ معيّن يمكن لنماذج تعلّم الآلة استهلاكه بسهولة — للبحث الدلالي، والتجميع، والتوصيات، والتصنيف، وتقنية RAG.

📮 نقطة الوصول

POST /v1/embeddings

المصادقة

Authorization: Bearer $WS_API_KEY

💡 أمثلة الطلبات

نص واحد ✅

curl http://baseurl/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WS_API_KEY" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "The food was delicious and the waiter was very friendly."
  }'

مثال على الاستجابة:

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023064255, -0.009327292, -0.0028842222, "..."]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 12,
    "total_tokens": 12
  }
}

إدخال دفعة نصوص ✅

curl http://baseurl/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WS_API_KEY" \
  -d '{
    "model": "text-embedding-3-large",
    "input": [
      "First document text",
      "Second document text",
      "Third document text"
    ],
    "dimensions": 1024
  }'

📋 معاملات جسم الطلب

المعامل	النوع	مطلوب	الوصف
model	string	نعم	‏text-embedding-3-large أو text-embedding-3-small أو text-embedding-ada-002
input	string / array	نعم	النص (أو مصفوفة نصوص) المراد تضمينه. بحد أقصى 8192 رمزًا لكل إدخال
dimensions	integer	لا	عدد أبعاد المخرجات (نماذج text-embedding-3-* فقط). يتيح تقصير المتجهات
encoding_format	string	لا	‏float (افتراضي) أو base64
user	string	لا	معرّف المستخدم النهائي

📥 حقول الاستجابة

الحقل	النوع	الوصف
object	string	دائمًا list
data	array	كائن تضمين واحد لكل إدخال، مع index وembedding (متجه أعداد عشرية)
model	string	النموذج المستخدم
usage	object	‏prompt_tokens وtotal_tokens

النماذج المتاحة

معرّف النموذج	الأبعاد القصوى
text-embedding-3-large	3072
text-embedding-3-small	1536
text-embedding-ada-002	1536 (ثابتة)