VoyageAI by MongoDB: voyage-4-lite
Voyage AI voyage-4-lite هو إصدار تضمين النصوص الموجّه لتقليل زمن الاستجابة ضمن عائلة Voyage 4. يدعم مدخلات من 32,000 رمز وأربعة خيارات لأبعاد المتجهات وتمثيلات مكمّمة، مع فضاء تضمين مشترك متوافق مع نماذج النصوص الأخرى في Voyage 4.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
voyage-4-lite هو نموذج تضمين النصوص الموجّه لتقليل زمن الاستجابة ضمن عائلة Voyage 4 من Voyage AI. ويمثّل الاستعلامات والمستندات كمتجهات رقمية للاسترجاع العام. وتتمثّل ميزته المميزة على مستوى العائلة في فضاء تضمين مشترك مع voyage-4 وvoyage-4-large وvoyage-4-nano، ما يتيح اختيار نموذجَي الاستعلام والمستند بصورة مستقلة.
ابدأ بأدوار الاسترجاع
جهّز حاجة المستخدم إلى المعلومات بوصفها استعلامًا، والمادة القابلة للبحث بوصفها مستندات. توصي Voyage بنوعَي المدخلات query/document للاسترجاع؛ وتضيف طريقتها المنشورة تعليمات الاسترجاع المقابلة عند تحويل النص إلى متجهات.
في مجموعة أدلة الموظفين، ينبغي مقارنة استعلام عن ترحيل الإجازة غير المستخدمة إلى الفترة التالية بأقسام السياسة المحددة. احتفظ بالقاعدة وشروطها وأي استثناء ذي صلة في المقطع المفهرس. واحتفظ بالمستند الأصلي ومعرّف القسم بجانب المتجه، حتى يتمكن التطبيق من إرجاع نص السياسة الفعلي.
يمثّل نوع المدخل غير المحدد النص مباشرةً، بينما يكيّفه دورا query/document للاسترجاع. وتذكر الشركة المصنّعة أن التضمينات الناتجة باستخدام إعدادات الأدوار ومن دونها متوافقة، لكن الحفاظ على سياسة تجهيز متسقة يجعل تقييم المجموعة أسهل.
الفضاء المشترك بين نماذج النصوص في Voyage 4
توثّق Voyage صراحةً سير عمل غير متناظر للاسترجاع: يمكن ترميز المستندات باستخدام voyage-4-large والبحث فيها باستخدام متجهات استعلام من voyage-4-lite. وهذا تصريح توافق على مستوى العائلة، وليس استنتاجًا مبنيًا على أن نموذجين يعيدان متجهات بالطول نفسه.
حافظ على توافق بُعد المتجه والتمثيل المختارين بين المجموعة وجانب الاستعلام. ويتيح الفضاء المشترك أيضًا تغيير نموذج الاستعلام ضمن عائلة نصوص Voyage 4 المحددة بالاسم، من دون إعادة تحويل المستندات الحالية إلى متجهات. قيّم الترتيب الناتج بأسئلة ممثّلة عند اختيار إصدار الاستعلام.
يتمثّل دور إصدار Lite في كونه خيارًا أصغر لتضمين الاستعلامات والنصوص يركّز على زمن الاستجابة. وتنسب الشركة المصنّعة بنية مزيج الخبراء إلى voyage-4-large تحديدًا؛ ولا يثبت اسم العائلة وحده أن Lite يستخدم تلك البنية.
السياق والأبعاد وتنسيق النتائج
طول السياق المنشور هو 32,000 رمز لكل نص. ويحتوي المتجه الافتراضي على 1024 بُعدًا، مع إتاحة 256 و512 و2048 أيضًا من خلال تعلّم Matryoshka. ويوثّق مسار تضمين النصوص لدى الشركة المصنّعة تمثيلات بالفاصلة العائمة، وأعدادًا صحيحة من 8 بت مع إشارة ومن دونها، وتمثيلات ثنائية محزّمة على مستوى البتات لـ voyage-4-lite.
بالنسبة إلى متجهات الفاصلة العائمة القياسية، تصف إرشادات التشابه لدى Voyage تضمينات ذات طول معياري واحد، ما يجعل تشابه جيب التمام وتشابه الضرب النقطي متكافئين. وتحتاج الأشكال المكمّمة إلى معالجة التمثيل المناسبة لها. فمثلًا، تخزّن القائمة الثنائية المحزّمة على مستوى البتات ثمانية بتات تضمين في كل بايت؛ ويختلف طول قائمتها عن بُعد المتجه الدلالي.
في طريقة الدفعات الموثّقة لدى Voyage، تضم القائمة 1000 نص كحد أقصى ومليون رمز إجمالًا لهذا الإصدار Lite تحديدًا. ويقتطع السلوك الافتراضي عند تجاوز الطول كل نص منفرد عند حد السياق؛ ويرفض الإعداد البديل المدخلات الأطول من الحد. وحدود الدفعة وحدود كل نص منفصلة.
جهّز نتائج الاسترجاع وافحصها
قسّم المادة المصدرية الطويلة إلى أقسام مترابطة يمكن إرجاعها أدلةً. ويتيح سياق من 32,000 رمز مدخلًا طويلًا، لكن ينبغي لوحدة الاسترجاع المفيدة أن تقود إلى قسم المصدر ذي الصلة. أدرج العنوان أو التفصيل التعريفي اللازم لفهم القاعدة.
في RAG، استرجع أقسامًا مرشّحة ومرّر نصها الأصلي إلى مرحلة كتابة الإجابة مع روابطها بالمصادر. وينتج نموذج التضمين متجهات ولا يولّد إجابة عن السياسة. يرتّب التشابه المرشّحين وفق النموذج وإعداد المقارنة المختارين؛ وراجع المقطع الفعلي للتحقق من الشرط الدقيق الذي يسأل عنه المستخدم.
تجمع الخصائص المفيدة الخاصة بإصدار voyage-4-lite بين نموذج نصي يركّز على زمن الاستجابة، وتمثيلات مرنة، وسياق من 32,000 رمز، وتوافق موثّق ضمن عائلة نصوص Voyage 4. واحتفظ بهذه الخصائص مع المجموعة المفهرسة، واستخدم نتائج استرجاع تستند إلى المصادر لدعم التطبيق المحيط.
Ailoot Ultra · التضمينات POST /v1/embeddings voyageai/voyage-4-lite
voyageai/voyage-4-liteالبداية
Voyage AI voyage-4-lite هو إصدار تضمين النصوص الموجّه لتقليل زمن الاستجابة ضمن عائلة Voyage 4. يدعم مدخلات من 32,000 رمز وأربعة خيارات لأبعاد المتجهات وتمثيلات مكمّمة، مع فضاء تضمين مشترك متوافق مع نماذج النصوص الأخرى في Voyage 4.
- المدخلات المقبولة
- النص · token_ids
- النتائج
- embedding
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · التضمينات POST /v1/embeddings
- الإدخال
text,token_ids- الإخراج
embedding- السياق
- 32,000 tokens
- صيغة الإخراج
- json
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود voyageai/voyage-4-lite | القيمة الافتراضية— |
الحقلinput | النوعstring|string[]|integer[]|integer[][] | المتطلبمطلوب | القيم والحدود الحد الأدنى للعناصر: 1 الشروط: دفعة متجانسة غير فارغة. معرّفات التوكنات أعداد صحيحة غير سالبة. سعة الإدخال: الحد الأقصى: 32,000 · وحدة النص: بايتات 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 | المواصفات32000 |
المعلمةmultimodal_objects | المواصفاتfalse |
المعلمةmaterial_types | المواصفاتtext, token_ids |
دورة الحياة: synchronous_json
احتفظ بفهرس كل متجه وبُعده.
اسم النموذج متعدد الوسائط لا يتيح استخدام كائنات الصور على هذا المسار المحدد.
الباقات
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- التعرفة القياسية عند اختيار الوضع السريع
- الوضع المرن
- التعرفة القياسية عند اختيار وضع flex
- أقصى جهد للاستدلال
- التعرفة القياسية عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات Ailoot
الأسعار حسب الإعدادات
| الإعدادات | جدول التعرفة | الرسوم |
|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الرسوم الإدخال · رموز الإدخال $0.00004 / 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": "voyageai/voyage-4-lite", "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='voyageai/voyage-4-lite',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 voyageai/voyage-4-lite
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · VoyageAI by MongoDB: voyage-4-lite
- ما المدخلات والنتائج المتاحة؟
POST /v1/embeddings·voyageai/voyage-4-lite:text,token_ids→embedding- ما الحقول التي يستخدمها الطلب؟
POST /v1/embeddings·voyageai/voyage-4-lite:model,input,encoding_format,provider- ما الحدود المطبقة؟
POST /v1/embeddings·voyageai/voyage-4-lite:ctx:32000;input.budget.maximum:32000(بايتات UTF8);input.min_items:1