Mistral: Codestral Embed 2505
يمثّل Codestral Embed 2505 الشيفرة والاستعلامات بلغة طبيعية كمتجهات للبحث في المستودعات واسترجاع سياق لمساعدي البرمجة. توثّق الجهة المصنّعة سياقًا من 8,192 رمزًا وأبعادًا قابلة للضبط حتى 3,072 وتنسيقات مخرجات عائمة أو صحيحة أو محزومة بالبتات.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Codestral Embed 2505 هو نموذج Mistral AI للتضمين المتخصص في استرجاع الشيفرة. يستقبل نصًا يحتوي على شيفرة مصدرية أو استعلامًا بلغة طبيعية عن الشيفرة ويعيد متجهات عددية. تقدّمه الجهة المصنّعة للبحث في المستودعات واسترجاع السياق لمساعدي البرمجة وتحليل التشابه والتكرار وتجميع الشيفرة حسب وظائفها أو بنيتها. معرّف إصداره الثابت codestral-embed-2505.
المدخل والتمثيل
يمكن لمدخل الشيفرة أن يكون دالة أو مقطعًا مصدريًا مترابطًا أو وحدة أخرى ذات معنى من مستودع. ويمكن لاستعلام بلغة طبيعية وصف السلوك المراد العثور عليه بدلًا من تسمية الرمز البرمجي الدقيق. يمثّل التضمين ذلك المدخل للمقارنة؛ ولا يولّد النموذج تنفيذًا جديدًا أو ينفّذ الشيفرة التي يتلقاها.
يوثّق الإصدار الرسمي سياق مدخل كاملًا من 8,192 رمزًا. وللاسترجاع، توصي الجهة المصنّعة بأجزاء من نحو 3,000 محرف مع تداخل من 1,000 محرف، مشيرةً إلى أن الأجزاء الأكبر قد تضر بالاسترجاع. هذه توصيات لإعداد الاسترجاع، وليست حدًا للرموز من 3,000 محرف. احتفظ بالملف والرمز البرمجي وموضع المصدر مرتبطين بكل عنصر مُعدّ حتى يستطيع التطبيق إعادة الشيفرة ذات الصلة بعد البحث.
دقة المخرجات وأبعادها
يوثّق دليل تضمين الشيفرة أنواع المخرجات float وint8 وuint8 وbinary وubinary. يستخدم float قيمًا من 32 بت بدقة أحادية. ويستخدم int8 أعدادًا صحيحة ذات إشارة من 8 بت تتراوح من -128 إلى 127، بينما يستخدم uint8 قيمًا بلا إشارة من 8 بت تتراوح من 0 إلى 255. يخزّن binary وubinary قيمًا مكمّمة من بت واحد داخل عناصر محزومة من 8 بت، باستخدام حاويات ذات إشارة وبلا إشارة على التوالي.
يغيّر التمثيل المحزوم بالبتات طول القائمة المُعادة: يصف الدليل عنصرًا محزومًا واحدًا لكل ثمانية أبعاد تضمين منطقية. لذلك تختلف المقارنة الواعية بالتنسيق عن التعامل مع البايتات المحزومة كإحداثيات عائمة عادية. احتفظ بالنوع المختار مع المتجه واستخدم التمثيل نفسه للشيفرة المفهرسة واستعلامها.
تذكر وثائق المعلمات بُعدًا افتراضيًا من 1,536 وحدًا أقصى من 3,072. الأبعاد مرتبة حسب الصلة، وتصف الجهة المصنّعة الاحتفاظ بالعدد المختار من الأبعاد الأولى بوصفه طريقة لاختيار حجم التمثيل. اختر البُعد بصورة متسقة للمجموعة المخزّنة والاستعلامات الجديدة. يغيّر التمثيل الأقصر أو المكمّم سلوك التخزين والمقارنة؛ ولا يزيد سياق المدخل أو يحوّل النموذج إلى مولّد شيفرة.
البرمجة المعزّزة بالاسترجاع
أول حالة استخدام في الإصدار استرجاع سياق لإكمال الشيفرة أو تعديلها أو تفسيرها. جهّز وحدات شيفرة ذات معنى واحتفظ بإصدار المستودع ومعرّفات المصدر. يمكن لسؤال عن كيفية معالجة خطأ محدد استرجاع دوال مترابطة، يقدّمها التطبيق بعد ذلك لنموذج برمجة مع طلب التغيير الفعلي.
من النتائج العملية مجموعة مرتبة من مقاطع مصدرية مع مسارات الملفات والرموز البرمجية والمحتوى اللازم لفهم سلوكها. يستطيع مطوّر فتح المقاطع المسترجعة أو تمريرها إلى مساعد. ينفّذ Codestral Embed خطوة التمثيل؛ ويختار مكوّن منفصل النتائج، ويكتب نموذج توليد التفسير أو الشيفرة المقترحة.
البحث الدلالي والتشابه
تصف الجهة المصنّعة البحث في الشيفرة باستعلامات بلغة طبيعية أو بالشيفرة. يستطيع مطوّر طلب تنفيذ سلوك حتى عندما يختلف اسم الدالة عن صياغة الطلب. أدرج السلوك والشروط التي تميّز التنفيذ المقصود؛ فقد يسترجع استعلام عام عن نظام فرعي كامل مادة مترابطة دون حسم السؤال المحدد.
يصف الإصدار أيضًا العثور على شيفرة شبه مكررة أو متشابهة وظيفيًا رغم الاختلافات المعجمية. قد تساعد هذه النتائج في تحديد تنفيذ قابل لإعادة الاستخدام أو شيفرة تحتاج إلى مراجعة إضافية. التشابه في فضاء التضمين إشارة لفحص المصدر؛ ولا يثبت أن مقطعين يملكان السلوك نفسه لكل مدخل.
التجميع العنقودي والتحليلات والمقارنة
يمكن استخدام تضمينات الشيفرة لتجميعها حسب الوظيفة أو البنية وفحص تكوين مستودع. احتفظ بالمقاطع الأصلية ومعرّفاتها متاحة حتى يستطيع شخص أو خطوة لاحقة في التطبيق تفسير المجموعة. العنقود تجميع قائم على التمثيل، وليس وصفًا معماريًا جرى التحقق منه تلقائيًا.
تستخدم أمثلة المتجهات العائمة لدى الجهة المصنّعة تضمينات مطبّعة إلى طول الوحدة، تعطي لها مقارنة جيب التمام والناتج النقطي والمسافة الإقليدية ترتيبات متسقة. ينبغي للمخرجات المكمّمة والمحزومة بالبتات الاحتفاظ بمعالجة تنسيقها الخاصة بدلًا من وراثة افتراض عن الإحداثيات العائمة الخام. وتحتفظ النقطة النهائية المنشورة أيضًا بفهارس المدخلات، ما يساعد في الحفاظ على الصلة بين كل متجه وعنصره المصدري.
الإصدار والحدود العملية
تدرج صفحة النموذج المحدد مسارات عمل التضمين والدفعات مع وسم سياق 8k، بينما يقدّم الإصدار قيمة 8,192 رمزًا. حافظ على إصدار 2505 المسمى والبُعد والنوع المختارين للمخرج عبر سير عمل المجموعة والاستعلام. هذا مخرج متجهات موجّه للشيفرة، يختلف عن إكمال النص في Codestral وعن نموذج Mistral Embed النصي ذي الأبعاد الثابتة.
جهّز وحدات شيفرة تحمل السلوك ذا الصلة، واحتفظ بمواضعها المصدرية وحدّد السؤال المراد البحث عنه. الناتج المفيد تمثيل قابل للاسترجاع مرتبط بشيفرة فعلية، يدعم خطوة التفسير أو التعديل أو مراجعة المطوّر التالية دون تنفيذ تلك الخطوة بنفسه.
Ailoot Ultra · التضمينات POST /v1/embeddings mistralai/codestral-embed-2505
mistralai/codestral-embed-2505
mistralai/codestral-embed-2505البداية
يمثّل Codestral Embed 2505 الشيفرة والاستعلامات بلغة طبيعية كمتجهات للبحث في المستودعات واسترجاع سياق لمساعدي البرمجة. توثّق الجهة المصنّعة سياقًا من 8,192 رمزًا وأبعادًا قابلة للضبط حتى 3,072 وتنسيقات مخرجات عائمة أو صحيحة أو محزومة بالبتات.
- المدخلات المقبولة
- النص · token_ids
- النتائج
- embedding
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · التضمينات POST /v1/embeddings
- الإدخال
text,token_ids- الإخراج
embedding- السياق
- 8,192 tokens
- صيغة الإخراج
- json
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود mistralai/codestral-embed-2505 | القيمة الافتراضية— |
الحقلinput | النوعstring|string[]|integer[]|integer[][] | المتطلبمطلوب | القيم والحدود الحد الأدنى للعناصر: 1 الشروط: دفعة متجانسة غير فارغة. معرّفات التوكنات أعداد صحيحة غير سالبة. سعة الإدخال: الحد الأقصى: 8,192 · وحدة النص: بايتات 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 | المواصفات8192 |
المعلمةmultimodal_objects | المواصفاتfalse |
المعلمةmaterial_types | المواصفاتtext, token_ids |
دورة الحياة: synchronous_json
احتفظ بفهرس كل متجه وبُعده.
اسم النموذج متعدد الوسائط لا يتيح استخدام كائنات الصور على هذا المسار المحدد.
الباقات
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- التعرفة القياسية عند اختيار الوضع السريع
- الوضع المرن
- التعرفة القياسية عند اختيار وضع flex
- أقصى جهد للاستدلال
- التعرفة القياسية عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات Ailoot
الأسعار حسب الإعدادات
| الإعدادات | جدول التعرفة | الرسوم |
|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الرسوم الإدخال · رموز الإدخال $0.0003 / 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": "mistralai/codestral-embed-2505", "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='mistralai/codestral-embed-2505',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 mistralai/codestral-embed-2505
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Mistral: Codestral Embed 2505
- ما المدخلات والنتائج المتاحة؟
POST /v1/embeddings·mistralai/codestral-embed-2505:text,token_ids→embedding- ما الحقول التي يستخدمها الطلب؟
POST /v1/embeddings·mistralai/codestral-embed-2505:model,input,encoding_format,provider- ما الحدود المطبقة؟
POST /v1/embeddings·mistralai/codestral-embed-2505:ctx:8192;input.budget.maximum:8192(بايتات UTF8);input.min_items:1