Intfloat: E5-Base-v2
يحوّل intfloat E5-Base-v2 النص الإنجليزي إلى تضمينات ذات 768 بُعدًا باستخدام مُرمِّز من 12 طبقة. تحدّد بادئات الاستعلام والمقطع ونافذة بطول 512 رمزًا إعداده للبحث ومقارنة إعادة الصياغة والتجميع والسمات النصية.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
E5-Base-v2 هو نموذج intfloat لتضمين النص الإنجليزي، ويتكون من اثنتي عشرة طبقة ويمثّل النص في 768 بُعدًا. يحوّل النص المُعدّ إلى متجه عددي واحد للاسترجاع أو المقارنة الدلالية أو استخدامه سماتٍ في مهمة أخرى. تختلف نقطة تحقق Base v2 عن إصدار Large v2 ذي الأربع والعشرين طبقة و1024 بُعدًا وعن نماذج E5 متعددة اللغات المدرّبة بصورة منفصلة.
استخدم بادئات الأدوار التي تدرّب عليها النموذج
يتوقع E5 دورًا في بداية المدخل. لاسترجاع المقاطع، يبدأ السؤال بـ“query:” ويبدأ المصدر الذي قد يحتوي على إجابته بـ“passage:”. توصي الجهة المصنّعة باستخدام “query:” على الجانبين في المهام المتماثلة مثل التشابه الدلالي واسترجاع إعادة الصياغة. وتوصي أيضًا بهذه البادئة عندما تكون المتجهات سماتٍ للتجميع العنقودي أو التصنيف.
على سبيل المثال، قد تحتوي مجموعة ملاحظات على عدة طلبات مختلفة الصياغة للتحسين نفسه. رمّز هذه السجلات بالإعداد المتماثل الموصى به، ثم قارن المتجهات الناتجة أو جمّعها عنقوديًا. احتفظ بالصياغة الأصلية ومعرّف السجل مع كل تمثيل حتى يمكن فحص العنقود بوصفه رسائل عملاء فعلية، بدلًا من مجموعة أرقام بلا تفسير.
لمجموعة بحث، جهّز الأسئلة والمقاطع المصدرية بأدوارها المقابلة. ومن أمثلة الاستعلام المفيد “query: Which setting changes the notification frequency?” يحتفظ مقطع المتن بالشرح والشروط ذات الصلة. البادئة جزء من إعداد النموذج الذي تدرّب عليه؛ وتشير الجهة المصنّعة إلى أن حذفها يقلّل الأداء.
جمّع التمثيل وقارنه
يحسب المثال الرسمي متوسط تمثيلات الرموز مع مراعاة قناع الانتباه لاستبعاد الحشو، ثم يطبّع المتجه الناتج. يوفّر الناتج النقطي بين التضمينات المطبّعة تشابه جيب التمام. تصف قيم المخرجات البالغ عددها 768 نصًا واحدًا؛ وليست إجابة أو تسمية فئة أو درجة معيد ترتيب لزوج نصوص.
في سير عمل التجميع العنقودي، تكوّن مرحلة أخرى مجموعات من تلك المتجهات. وفي سير عمل التصنيف، تستخدمها مرحلة أخرى سماتٍ للمدخلات. يجعل الاحتفاظ بهذا التمييز النتيجة أسهل تفسيرًا: فالتضمين يمثّل السجل، بينما تحدد المهمة اللاحقة مجموعة أو تسمية. استخدم نموذجًا واحدًا واصطلاح إعداد واحدًا بصورة متسقة للتمثيلات الجاري مقارنتها.
اعمل ضمن الإنجليزية و512 رمزًا
تذكر بطاقة النموذج أن هذا الإصدار يعمل للإنجليزية فقط ويقتطع النص الطويل إلى 512 رمزًا كحد أقصى. جهّز مقاطع مترابطة ضمن هذا الحيز، بما يشمل بادئة الدور المطلوبة. ينبغي تقسيم المراجعة أو التقرير أو الدليل الطويل وفق أقسام ذات معنى، بدلًا من تضمينه كمدخل أكبر من الحد تُفقَد نهايته.
احتفظ بالعنوان مع الجمل التي يقدمها، وحافظ على الشرط أو الاستثناء الذي يغيّر معنى قاعدة. وبالنسبة إلى السجلات القصيرة مثل الملاحظات، احتفظ بالرسالة كاملة عندما تتّسع. يتيح معرّف المصدر وإصداره المحفوظان بجوار المتجه لتحديث لاحق للمجموعة استبدال السجل الصحيح.
فسّر التشابه وفق المهمة
توضح الجهة المصنّعة أن الترتيب النسبي لدرجات تشابه جيب التمام أهم من القيمة المطلقة. ينبغي تقييم عتبة الترشيح على أمثلة المجموعة نفسها، وليس التشابه بين المتجهات احتمالًا معايرًا لتسمية مطابقة أو إجابة صحيحة. افحص السجلات القريبة وحالات عدم التطابق المعروفة عند تحديد كيفية استخدام المتجهات.
المُسلَّم المفيد فهرس بحث إنجليزي أو مجموعة مقارنة دلالية أو سمات نصية عددية مقترنة بسجلاتها المصدرية. يقدّم ملف Base v2 هذا أبعاده وتجميعه وإعداد أدواره الخاصة؛ ولا يثبت شكل متجه إصدار E5 آخر أو تغطيته اللغوية أن التمثيلين قابلان للاستبدال.
Ailoot Ultra · التضمينات POST /v1/embeddings intfloat/e5-base-v2
intfloat/e5-base-v2البداية
يحوّل intfloat E5-Base-v2 النص الإنجليزي إلى تضمينات ذات 768 بُعدًا باستخدام مُرمِّز من 12 طبقة. تحدّد بادئات الاستعلام والمقطع ونافذة بطول 512 رمزًا إعداده للبحث ومقارنة إعادة الصياغة والتجميع والسمات النصية.
- المدخلات المقبولة
- النص · token_ids
- النتائج
- embedding
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · التضمينات POST /v1/embeddings
- الإدخال
text,token_ids- الإخراج
embedding- صيغة الإخراج
- json
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود intfloat/e5-base-v2 | القيمة الافتراضية— |
الحقلinput | النوعstring|string[]|integer[]|integer[][] | المتطلبمطلوب | القيم والحدود الحد الأدنى للعناصر: 1 الشروط: دفعة متجانسة غير فارغة. معرّفات التوكنات أعداد صحيحة غير سالبة. سعة الإدخال: الحد الأقصى: 512 · وحدة النص: بايتات UTF8 · وحدة الرموز: عناصر مصفوفة الرموز | القيمة الافتراضية— |
الحقلencoding_format | النوعstring | المتطلباختياري | القيم والحدود float | القيمة الافتراضيةfloat |
الحقلdimensions | النوعinteger | المتطلبغير مدعوم | القيم والحدود الحد الأدنى: 1 | القيمة الافتراضية— |
الحقلuser | النوعjson_value | المتطلباختياري | القيم والحدود الشروط: يسمح المصدر بحقل البيانات الوصفية هذا بصيغة JSON؛ ويعتمد المعنى الدقيق لدى المزوّد الأصلي على النموذج. | القيمة الافتراضية— |
الحقلsession_id | النوعjson_value | المتطلباختياري | القيم والحدود الشروط: يسمح المصدر بحقل البيانات الوصفية هذا بصيغة JSON؛ ويعتمد المعنى الدقيق لدى المزوّد الأصلي على النموذج. | القيمة الافتراضية— |
الحقلtrace | النوعjson_value | المتطلباختياري | القيم والحدود الشروط: يسمح المصدر بحقل البيانات الوصفية هذا بصيغة JSON؛ ويعتمد المعنى الدقيق لدى المزوّد الأصلي على النموذج. | القيمة الافتراضية— |
الحقلprovider | النوعobject | المتطلباختياري | القيم والحدود الشروط: تم رفض provider.options | القيمة الافتراضية— |
تركيبات مواد الإدخال
text_to_embedding
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, input |
المعلمةinput_shapes | المواصفاتstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
المعلمةencoding_format | المواصفاتfloat |
المعلمةdimensions_override | المواصفاتfalse |
المعلمةmax_input_budget_units | المواصفات512 |
المعلمةmultimodal_objects | المواصفاتfalse |
المعلمةmaterial_types | المواصفاتtext, token_ids |
دورة الحياة: synchronous_json
احتفظ بفهرس كل متجه وبُعده.
اسم النموذج متعدد الوسائط لا يتيح استخدام كائنات الصور على هذا المسار المحدد.
الباقات
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات Ailoot
الأسعار حسب الإعدادات
| الإعدادات | جدول التعرفة | الرسوم |
|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الرسوم الإدخال · رموز الإدخال $0.00001 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · التضمينات
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "intfloat/e5-base-v2", "input": ["First document", "Second document"]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT
from openai import OpenAI
import os
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='intfloat/e5-base-v2',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)
استلام النتائج وحفظها
Ailoot Ultra · التضمينات
json
الاحتفاظ بكل النتائج المكتملة
احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.
احتفظ بكل متجه مع فهرسه. يجب أن يساوي عدد المتجهات عدد المدخلات، وأن تكون الأبعاد متسقة.
عند الحاجة إلى التحقق من الاستجابة الأصلية
لا تُستحدث نقطة نهاية لمهام التضمين.
حقول الاستجابة
| الحقل | النوع |
|---|---|
الحقلobject | النوعstring |
الحقلmodel | النوعstring |
الحقلdata[].index | النوعinteger |
الحقلdata[].embedding | النوعfinite float[] |
الحقلusage | النوعobject |
الأخطاء والخطوات التالية
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة | الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra intfloat/e5-base-v2
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Intfloat: E5-Base-v2
- ما المدخلات والنتائج المتاحة؟
POST /v1/embeddings·intfloat/e5-base-v2:text,token_ids→embedding- ما الحقول التي يستخدمها الطلب؟
POST /v1/embeddings·intfloat/e5-base-v2:model,input,encoding_format,provider- ما الحدود المطبقة؟
POST /v1/embeddings·intfloat/e5-base-v2:input.budget.maximum:512(بايتات UTF8);input.min_items:1