النص

إنشاء تضمينات متعددة الوسائط

ينشئ متجهات تضمين باستخدام نموذج تضمين متعدد الوسائط

POST
/v1/multimodal/embeddings

نظرة عامة

استخدم نقطة النهاية هذه مع النماذج التي تسرد تفاصيلها عملية multimodal-embedding. اقرأ supported_operations في GET /v1/models/{model} قبل إرسال الطلب. تستخدم نماذج التضمين النصية فقط إنشاء تضمين، وتُرجع نقطة النهاية هذه 400 unsupported_endpoint لها.

المدخلات النصية فقط هي النشطة. أي طلب يتضمن image_url أو image_base64 يُرجع 400 image_input_deferred.

نص الطلب

modelstringمطلوب

معرّف نموذج يسرد multimodal-embedding، مثل qwen3-vl-embedding.

inputobject | arrayمطلوب

عنصر إدخال واحد، أو مصفوفة من العناصر. يحتاج كل عنصر إلى حقل واحد على الأقل من الحقول أدناه، وتتضمن الاستجابة مدخلاً واحداً لكل عنصر.

  • text (string): النص المراد تضمينه.
  • image_url (string): رابط URL عام للصورة. غير نشط حالياً.
  • image_base64 (string) و image_mime_type (string): بيانات الصورة بتنسيق Base64 ونوع MIME الخاص بها. غير نشط حالياً.
dimensionsinteger

عدد أبعاد كل متجه مُرجع، وهو عدد صحيح موجب. يعتمد الحد الأقصى على النموذج.

الاستجابة

objectstring

دائماً list.

dataarray

مدخل واحد لكل عنصر إدخال.

يحتوي كل مدخل على:

  • object (string): embedding
  • index (integer): فهرس عنصر الإدخال
  • text_embedding (array): متجه العنصر النصي. يحمل كل مدخل حقل متجه واحداً مسمى بحسب وسيطه: text_embedding، أو image_embedding، أو video_embedding، أو audio_embedding.
modelstring

النموذج المستخدم.

usageobject

استخدام الـ token مع prompt_tokens و total_tokens، عندما يقدم النموذج تقريراً عنها.

الطلب

curl -X POST "https://api.tokenlab.sh/v1/multimodal/embeddings" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3-vl-embedding",
    "input": [
      {"text": "A red bicycle leaning against a brick wall"},
      {"text": "A city street at night"}
    ]
  }'

تم اختصار المتجه في المثال لتسهيل القراءة.

الاستجابة

Response
{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "text_embedding": [0.0123, -0.0456, 0.0789] },
    { "object": "embedding", "index": 1, "text_embedding": [0.0211, 0.0334, -0.0102] }
  ],
  "model": "qwen3-vl-embedding",
  "usage": { "prompt_tokens": 18, "total_tokens": 18 }
}

الأخطاء

الحالةالكودالسبب
400invalid_requestحقل input مفقود أو فارغ، أو لا يحتوي العنصر على أي من text أو image_url أو image_base64
400unsupported_endpointالنموذج لا يسرد multimodal-embedding
400image_input_deferredيحتوي أحد العناصر على صورة

تعامل مع الحالات الأخرى كما هو موضح في التعامل مع أخطاء API.

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

الترويسات

X-TokenLab-Delivery-Policy?string

سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.

القيم المتاحة

  • "auto"
  • "verified"
  • "official"

جسم الطلب

application/json

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json