Sentence Transformers: all-MiniLM-L12-v2
يرمّز Sentence Transformers all-MiniLM-L12-v2 الجمل والفقرات القصيرة إلى متجهات ذات 384 بُعدًا للبحث والتشابه والتجميع العنقودي. تستخدم وصفته المرجعية التجميع بالمتوسط والتطبيع، مع اقتطاع افتراضي عند 256 جزء كلمة.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
all-MiniLM-L12-v2 مُرمِّز من Sentence Transformers للجمل والفقرات القصيرة. ينتج متجهًا كثيفًا واحدًا ذا 384 بُعدًا لكل نص للبحث الدلالي واسترجاع المعلومات والتجميع العنقودي وتشابه الجمل. يستخدم النموذج البنية الأساسية MiniLM-L12-H384-uncased وخضع للضبط الدقيق بالتعلم التقابلي على مجموعة من مليار زوج من الجمل.
رمّز الوحدة التي تريد استرجاعها
استخدم جملة أو فقرة قصيرة تعبّر عن فكرة مفيدة واحدة. بالنسبة إلى مجموعة أوصاف منتجات، احتفظ بالميزة والشرط اللذين يميّزان العنصر: «يصل المحوِّل سماعة رأس سلكية بمنفذ USB-C» أغنى بالمعلومات من «ملحق صوتي». خزّن معرّف السجل والوصف الأصلي بجوار متجهه.
يمكن بعد ذلك مقارنة استعلام بحث بالأوصاف المرمّزة. افحص المرشحين المُعادين وفق المتطلبات الدقيقة، مثل نوع الموصّل أو توافق الجهاز، قبل عرض اختيار نهائي. يمثّل المتجه معنى النص؛ ويسترجع تطبيق البحث المحيط السجلات المقابلة.
التجميع بالمتوسط والمتجهات المطبّعة
يحسب مثال الترميز المنشور متوسط تمثيلات الرموز باستخدام قناع الانتباه، بحيث لا تسهم مواضع الحشو في المتوسط. ثم يطبّق تطبيع L2. هاتان الخطوتان جزء من الوصفة المرجعية للحصول على متجه الجملة، وليستا تعليمة لأخذ رمز اعتباطي من المحوّل الأساسي.
حافظ على اتساق إعداد النموذج والتجميع والتطبيع بين النصوص المفهرسة والاستعلامات الجديدة. يمكن مقارنة التمثيلات الناتجة ذات 384 مكوّنًا باستخدام تشابه جيب التمام. احتفظ بسجل لهذا الإعداد مع المجموعة؛ فلا يصبح مُرمِّز آخر ذو 384 بُعدًا متوافقًا لمجرد أن متجهاته بالطول نفسه.
طول المدخل الافتراضي ونطاق التدريب
تحدد الجهة المصنّعة اقتطاعًا افتراضيًا لما يتجاوز 256 جزء كلمة. هذا حد لمُجزِّئ الرموز، وليس عددًا للكلمات العادية أو المحارف. بالنسبة إلى سجل أطول، اختر أقسامًا قصيرة مترابطة واحتفظ بالعنوان أو التفصيل التعريفي اللازم لتفسير كل منها.
استخدم إجراء تدريب النموذج تسلسلات تصل إلى 128 رمزًا. يختلف إعداد التدريب هذا عن الإعداد الافتراضي المنشور من 256 جزء كلمة عند الترميز. قد يختلف مقطع يتّسع ضمن الإعداد الافتراضي اختلافًا كبيرًا عن مادة الجمل القصيرة المستخدمة أثناء التدريب، لذا قيّم الأوصاف الطويلة أو المتخصصة بأمثلة تمثيلية.
مسارات عمل التشابه والتجميع العنقودي
بالنسبة إلى مجموعة رسائل دعم، يمكن للتضمينات توفير مدخلات عددية لمرحلة تجميع. راجع عدة رسائل من كل مجموعة مقترحة والرسائل القريبة من حدودها قبل إسناد تسمية مقروءة للبشر. ولمراجعة المحتوى المكرر، استرجع سجلات متشابهة وقارن صياغتها الفعلية؛ فقد تناقش فقرتان الموضوع نفسه مع تقديم تعليمات مختلفة.
إصدار L12-v2 المحدد هذا ملف لتضمين الجمل الإنجليزية. وهو منفصل عن all-MiniLM-L6-v2 ونقاط تحقق paraphrase-MiniLM. لا تنقل أسماء العائلات المشتركة إعداد التسلسل أو وصفة التجميع بينها. استخدم متجهاته الكثيفة المدمجة مع السجلات المصدرية والتقييم الخاص بالمهمة، بدلًا من التعامل مع قيمة التشابه بوصفها إجابة جرى التحقق منها أو قرارًا تحريريًا نهائيًا.
Ailoot Ultra · التضمينات POST /v1/embeddings sentence-transformers/all-minilm-l12-v2
sentence-transformers/all-minilm-l12-v2
sentence-transformers/all-minilm-l12-v2البداية
يرمّز Sentence Transformers all-MiniLM-L12-v2 الجمل والفقرات القصيرة إلى متجهات ذات 384 بُعدًا للبحث والتشابه والتجميع العنقودي. تستخدم وصفته المرجعية التجميع بالمتوسط والتطبيع، مع اقتطاع افتراضي عند 256 جزء كلمة.
- المدخلات المقبولة
- النص · token_ids
- النتائج
- embedding
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · التضمينات POST /v1/embeddings
- الإدخال
text,token_ids- الإخراج
embedding- صيغة الإخراج
- json
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود sentence-transformers/all-minilm-l12-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": "sentence-transformers/all-minilm-l12-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='sentence-transformers/all-minilm-l12-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 sentence-transformers/all-minilm-l12-v2
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Sentence Transformers: all-MiniLM-L12-v2
- ما المدخلات والنتائج المتاحة؟
POST /v1/embeddings·sentence-transformers/all-minilm-l12-v2:text,token_ids→embedding- ما الحقول التي يستخدمها الطلب؟
POST /v1/embeddings·sentence-transformers/all-minilm-l12-v2:model,input,encoding_format,provider- ما الحدود المطبقة؟
POST /v1/embeddings·sentence-transformers/all-minilm-l12-v2:input.budget.maximum:512(بايتات UTF8);input.min_items:1