النص
إنشاء تضمينات متعددة الوسائط
ينشئ متجهات تضمين باستخدام نموذج تضمين متعدد الوسائط
نظرة عامة
استخدم نقطة النهاية هذه مع النماذج التي تسرد تفاصيلها عملية multimodal-embedding. اقرأ supported_operations في GET /v1/models/{model} قبل إرسال الطلب. تستخدم نماذج التضمين النصية فقط إنشاء تضمين، وتُرجع نقطة النهاية هذه 400 unsupported_endpoint لها.
المدخلات النصية فقط هي النشطة. أي طلب يتضمن image_url أو image_base64 يُرجع 400 image_input_deferred.
نص الطلب
معرّف نموذج يسرد multimodal-embedding، مثل qwen3-vl-embedding.
عنصر إدخال واحد، أو مصفوفة من العناصر. يحتاج كل عنصر إلى حقل واحد على الأقل من الحقول أدناه، وتتضمن الاستجابة مدخلاً واحداً لكل عنصر.
text(string): النص المراد تضمينه.image_url(string): رابط URL عام للصورة. غير نشط حالياً.image_base64(string) وimage_mime_type(string): بيانات الصورة بتنسيق Base64 ونوع MIME الخاص بها. غير نشط حالياً.
عدد أبعاد كل متجه مُرجع، وهو عدد صحيح موجب. يعتمد الحد الأقصى على النموذج.
الاستجابة
دائماً list.
مدخل واحد لكل عنصر إدخال.
يحتوي كل مدخل على:
object(string):embeddingindex(integer): فهرس عنصر الإدخالtext_embedding(array): متجه العنصر النصي. يحمل كل مدخل حقل متجه واحداً مسمى بحسب وسيطه:text_embedding، أوimage_embedding، أوvideo_embedding، أوaudio_embedding.
النموذج المستخدم.
استخدام الـ 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"}
]
}'تم اختصار المتجه في المثال لتسهيل القراءة.
الاستجابة
{
"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 }
}الأخطاء
| الحالة | الكود | السبب |
|---|---|---|
400 | invalid_request | حقل input مفقود أو فارغ، أو لا يحتوي العنصر على أي من text أو image_url أو image_base64 |
400 | unsupported_endpoint | النموذج لا يسرد multimodal-embedding |
400 | image_input_deferred | يحتوي أحد العناصر على صورة |
تعامل مع الحالات الأخرى كما هو موضح في التعامل مع أخطاء API.
التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
الترويسات
سياسة التسليم لكل طلب. تتجاوز إعدادات 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