Source: https://ailoot.ai/models/ar/mistralai-codestral-embed-2505/
Canonical: https://ailoot.ai/models/ar/mistralai-codestral-embed-2505/
Language: ar

# Mistral: Codestral Embed 2505

[Markdown](https://ailoot.ai/models/ar/mistralai-codestral-embed-2505/index.md) · [JSON](https://ailoot.ai/models/ar/mistralai-codestral-embed-2505/facts.json)

## [Mistral: Codestral Embed 2505](https://ailoot.ai/models/ar/mistralai-codestral-embed-2505/)

يمثّل Codestral Embed 2505 الشيفرة والاستعلامات بلغة طبيعية كمتجهات للبحث في المستودعات واسترجاع سياق لمساعدي البرمجة. توثّق الجهة المصنّعة سياقًا من 8,192 رمزًا وأبعادًا قابلة للضبط حتى 3,072 وتنسيقات مخرجات عائمة أو صحيحة أو محزومة بالبتات.

- [**Ailoot Ultra · التضمينات** `POST /v1/embeddings` `mistralai/codestral-embed-2505`](https://ailoot.ai/models/ar/mistralai-codestral-embed-2505/#method-0)

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في 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`](https://ailoot.ai/models/ar/#m=mistralai%2Fcodestral-embed-2505&route=Ultra&caller=mistralai%2Fcodestral-embed-2505&fmt=embeddings)

Mistral /`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 مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. [كيفية عمل حجز المبلغ وتسوية الرسوم →](https://ailoot.ai/docs/ar/billing/reserve/)

### أمثلة للطلبات

#### Ailoot Ultra · التضمينات

curlPython SDK

```bash
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
```

```python
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`](https://ailoot.ai/models/ar/#m=mistralai%2Fcodestral-embed-2505&route=Ultra&caller=mistralai%2Fcodestral-embed-2505&fmt=embeddings)

#### الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

#### معرّفات النماذج ذات الصلة IDs

[`mistralai/codestral-embed-2505`](https://ailoot.ai/models/ar/#m=mistralai%2Fcodestral-embed-2505&route=Ultra&caller=mistralai%2Fcodestral-embed-2505&fmt=embeddings)

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`

اربط Ailoot بخدمة Claude Code أوOpenCode أوHermes أوتطبيقك.

## الشركة ومحفظة مشاريعها

الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.

## اشتر الرموز بخصم.

خصم اشتراك للعمل المنتظم. الرموز الترويجية حتى 50% على شراء الرموز.

الاشتراك

اختر خطة بخصم لطلباتك المنتظمة.

رمز خصم حتى 50%

أدخل الرمز عند الشراء. يعاد حساب السعر وفق العرض الساري.

المصروفات في السجل

يحفظ النموذج والرموز والمبلغ لكل طلب.

[اختر اشتراكا](https://ailoot.ai/docs/ar/billing/subscriptions/) · [اعرض أسعار النماذج](https://ailoot.ai/models/ar/)

## اربط API بالمنتج الذي تبيعه.

SaaS والتطبيقات والبوتات وفق العرض واتفاقية ترخيص Ailoot. لإعادة البيع، اطلب ترخيص موزع.

تطبيق تجاري

أضف توليد النص والصور والفيديو والصوت إلى ميزات خدمتك المدفوعة.

ترخيص إعادة البيع

أرسل وصف المشروع وطريقة توفير الوصول. اطلب شروط استخدام وإعادة بيع مكتوبة.

المستندات على الموقع

العرض واتفاقية الترخيص وسياسة معالجة البيانات متاحة قبل الربط.

[اطلب ترخيص إعادة بيع](mailto:support@ailoot.ai) · [العرض واتفاقية الترخيص](https://ailoot.ai/legal/offer?lang=ar)

## Ailoot · الشركة ومحفظة مشاريعها





تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.





الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.





توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.