دليل المطور الشامل لاستخدام واجهة برمجة تطبيقات MiMo-V2.5

الخلاصة

MiMo-V2.5 API في CometAPI تتيح الوصول إلى نموذج MiMo متفرق الخبراء من Xiaomi لأعمال البرمجة، وفهم الوسائط المتعددة، وحمولات الوكلاء. تُعد MiMo-V2.5 API الخيار العملي الافتراضي عندما يحتاج المشروع إلى نافذة سياق بسعة مليون رمز، ومدخلات متعددة الوسائط أصلية، وتكلفة رمزية منخفضة؛ أما MiMo-V2.5 Pro فهي أنسب عندما تكون البرمجة الصعبة، والاستدلال، أو استخدام الأدوات على مدى طويل أهم من السعر. يعرض هذا الدليل كيفية استدعاء الواجهة عبر CometAPI، وبث الاستجابات، وبنية الطلبات متعددة الوسائط، وتقدير التكلفة، وتقوية تكاملٍ جاهزٍ للإنتاج.

أهم النقاط

• يستخدم نموذج MiMo-V2.5 إجمالي 310B من المعاملات مع 15B من المعاملات النشطة لكل رمز، ويدعم نافذة سياق بسعة 1M رمز.
• استخدم مسار MiMo-V2.5 لأعمال الوسائط المتعددة، والتحليل واسع السياق، ووكلاء الحساسية للتكلفة؛ واختر MiMo-V2.5 Pro لأصعب مهام البرمجة والاستدلال.
• نقطة النهاية المتوافقة مع OpenAI تجعل الترحيل سلسًا، لكن الأنظمة الإنتاجية لا تزال تحتاج إلى مهلات، ومنطق إعادة المحاولة، وميزانيات الرموز، وفحوصات قدرات على جانب المزوّد.
• وفق الأسعار المذكورة في CometAPI، يكلف طلب يحوي 10,000 رمز إدخال و2,000 رمز إخراج نحو $0.001568 على مسار MiMo-V2.5.

نظرة عامة على نموذج MiMo-V2.5

قدّمت Xiaomi النموذج في 22 أبريل 2026. يوفّر MiMo-V2.5 API في CometAPI واجهة استكمالات دردشة متوافقة مع OpenAI، لذا غالبًا ما يمكن للعملاء الحاليين الترحيل عبر تغيير عنوان الأساس، ومفتاح API، ومعرّف النموذج.

وفقًا لـبطاقة النموذج الرسمية، يجمع النموذج بين عمود فقري لغوي قائم على مزيج خبراء متفرق مع مُرمّزات مخصصة للرؤية والصوت. يقبل إدخالات نصية وصورية وفيديو وصوت، ويُنتج مخرجات نصية. نافذة السياق الكبيرة مفيدة لمراجعة الأكواد على مستوى المستودعات، ومجموعات المستندات، والنُصوص الطويلة، ووكلاء متعدد الخطوات.

تعرض الصورة الرسمية لقياس الوسائط المتعددة أدناه نتائج عبر فهم الصور، ووكلاء الوسائط المتعددة، وفهم الفيديو.

مقارنة قياسية متعددة الوسائط رسمية لـ Xiaomi MiMo-V2.5

قد توفّر المسارات لدى المزوّد مجموعة أضيق من صيغ الوسائط مما يدعمه النموذج الأساسي. تحقّق من صيغ الصور والصوت والفيديو المقبولة بالضبط مقابل نقطة النهاية الفعالة قبل شحن ميزة متعددة الوسائط.

أداء MiMo-V2.5 في القياسات

تذكر Xiaomi نتائج قوية في البرمجة، واستخدام الطرفية، وتقييم وكلاء الوسائط المتعددة. هذه الأرقام مفيدة لوضع النموذج، لكنها ليست بدائل لاختبارات على مطالباتك وأدواتك وأهداف الكمون وحالات الفشل الخاصة بك.

تُظهر مقارنة البرمجة الرسمية 65.8 على Terminal-Bench 2.0 و56.1 على SWE-Bench Pro، كما تضع النموذج ضمن مقارنة أوسع لوكلاء البرمجة.

مقارنة قياسية رسمية لبرمجة Xiaomi MiMo-V2.5

ما تشير إليه النتائج: النموذج جذاب بشكل خاص للتطبيقات التي تجمع بين الأكواد، والأدوات، والوسائط المختلطة. لاتخاذ قرارات إنتاجية حتمية، نفّذ تقييمًا داخليًا يقيس نسبة نجاح المهام، واستخدام الرموز، والكمون من النهاية إلى النهاية، وتكرار إعادة المحاولة، ومعدل التصحيح البشري.

MiMo-V2.5 مقابل MiMo-V2.5 Pro: مقارنة متعددة الأبعاد

نتيجة المقارنة: ابدأ بمسار MiMo-V2.5 عندما تدفع التكلفة، أو الإنتاجية، أو تغطية الوسائط المتعددة قرارك. انقل الطلبات المحددة إلى MiMo-V2.5 Pro عندما تُظهر تقييماتك الداخلية مكسب دقة ذي معنى في حالات البرمجة، والاستدلال، أو استخدام الأدوات الصعبة. غالبًا ما يوفّر موجه متعدد الدرجات توازنًا أفضل بين التكلفة والجودة من إرسال كل الطلبات إلى MiMo-V2.5 Pro.

كيفية استدعاء واجهة MiMo-V2.5

تتبع الواجهة مخطط استكمالات الدردشة المألوف. احتفظ بالمفتاح على خادمك، وحمّله من متغير بيئة، ولا تضعه أبدًا في كود المتصفح أو الهاتف.

تعيين مفتاح API

export COMETAPI_KEY="your_api_key_here"

$env:COMETAPI_KEY = "your_api_key_here"

### إرسال طلب cURL

curl https://api.cometapi.com/v1/chat/completions
-H "Authorization: Bearer $COMETAPI_KEY"
-H "Content-Type: application/json"
-d '{
"model": "mimo-v2.5",
"messages": [
{"role": "system", "content": "You are a careful coding assistant."},
{"role": "user", "content": "Explain the bug and propose a minimal patch."}
],
"temperature": 0.2
}'

### استخدام Python مع حزمة OpenAI

import os
from openai import OpenAI

client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
model="mimo-v2.5",
messages=[
{"role": "system", "content": "You are a precise engineering assistant."},
{"role": "user", "content": "Review this migration plan for hidden risks."},
],
temperature=0.2,
)

print(response.choices[0].message.content)

> لا تقم بتسجيل مفاتيح API، أو رؤوس التفويض الكاملة، أو محتوى المطالبات الحسّاس. استخدم مدير أسرار في الإنتاج وقم بتدوير بيانات الاعتماد وفق جدول محدد.

## كيفية بث استجابات واجهة MiMo-V2.5

يقلّل البث من الكمون الملحوظ للإجابات الطويلة. تُعيد الخدمة أحداثًا تدريجية، وتعرِضها الحزمة كأجزاء.

stream = client.chat.completions.create(
model="mimo-v2.5",
messages=[{"role": "user", "content": "Draft a safe database migration checklist."}],
stream=True,
)

for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)

في خدمة ويب، مرّر الأجزاء عبر Server-Sent Events أو رسائل WebSocket، وتعامل مع قطع اتصال العميل، وأوقف التوليد في المنبع عند إلغاء المستخدم.

## واجهات متعددة الوسائط وبُنى مُهيكلة لواجهة MiMo-V2.5

لمهام تعتمد على الصور، أرسل تعليمات نصية بالإضافة إلى عنصر صورة ضمن نفس رسالة المستخدم. قد تختلف تمثيلات الوسائط المقبولة حسب مسار المزوّد، لذا تعامل معها كنمط حمولة وتحقق من دعم المسار الحالي.

{
"model": "mimo-v2.5",
"messages": [
{
"role": "user",
"content": [
{"type": "text", "text": "Extract the visible error and suggest the next diagnostic step."},
{"type": "image_url", "image_url": {"url": "https://example.com/error.png"}}
]
}
]
}

للحصول على مخرجات قابلة للقراءة آليًا، اطلب كائن JSON مضغوط وتحقق منه مقابل مخططك الخاص. لا تفترض أن JSON المولّد آمن لمجرد أنه يُحلّل.

import json

raw = response.choices[0].message.content
result = json.loads(raw)

required = {"summary", "risks", "next_action"}
missing = required - result.keys()
if missing:
raise ValueError(f"Missing fields: {sorted(missing)}")

## تسعير واجهة MiMo-V2.5 على CometAPI وضبط التكلفة

| المسار                         | الإدخال لكل 1M رمز | الإخراج لكل 1M رمز | مثال 100 طلب        |
| ----------------------------- | ------------------- | ------------------ | ------------------- |
| MiMo-V2.5                     | $0.112              | $0.224             | $0.1568             |
| MiMo-V2.5 Pro                 | $0.348              | $0.696             | $0.4872             |
| مرجع الدفع حسب الاستخدام من Xiaomi | $0.14               | $0.28              | $0.1960             |

يفترض المثال 100 طلب، كلٌ منها يحوي 10,000 رمز إدخال و2,000 رمز إخراج. وفق هذه الافتراضات، مسار MiMo-V2.5 أرخص بنحو 68% من MiMo-V2.5 Pro. توفّر [أسعار الدفع حسب الاستخدام المنشورة](https://platform.xiaomimimo.com/docs/zh-CN/integration/roocode) من Xiaomi نقطة مرجعية مفيدة، فيما يجب التحقق من الفواتير الفعلية مقابل السعر الفعّال لدى المزوّد قبل النشر.

MiMo-V2.5 input: 100 × 10,000 / 1,000,000 × $0.112 = $0.1120
MiMo-V2.5 output: 100 × 2,000 / 1,000,000 × $0.224 = $0.0448
MiMo-V2.5 total: $0.1568

Pro input: 100 × 10,000 / 1,000,000 × $0.348 = $0.3480
Pro output: 100 × 2,000 / 1,000,000 × $0.696 = $0.1392
Pro total: $0.4872

اضبط التكلفة باستخدام حدود أقصى للإخراج، وضغط المطالبات، وسياق مُخبّأ، وتصنيف الطلبات، وموجه يرفع فقط المهام الصعبة. تتبّع التكلفة لكل مهمة ناجحة بدلًا من التكلفة لكل طلب؛ فالطلب الأرخص الذي يفشل مرارًا قد يكون أكثر كلفة إجمالًا.

## كيفية تصميم طلبات طويلة السياق لواجهة MiMo-V2.5

تجعل نافذة السياق ذات مليون رمز إدخالات أكبر ممكنة، لكنها لا تزيل مفاضلات الاسترجاع والانتباه. ابنِ المطالبة بحيث يمكن للنموذج تحديد الأدلة ذات الصلة بسرعة.

* ضع المهمة، وعقد الإخراج، ومعايير القرار قرب البداية.
* افصل المستندات بمعرّفات ثابتة وفواصل واضحة.
* أدرج فقط الأدلة التي يمكن أن تؤثر في الإجابة.
* اطلب من النموذج الاستشهاد بمعرّفات المستندات أو مراجع الأسطر في نتيجته.
* قِس الدقة مع نمو السياق؛ لا تعتبر الحد الأقصى للسياق هو السياق المثالي.

> يزيد السياق الطويل من تكلفة الرموز واحتمال أن تشتت المادة غير ذات الصلة النموذج. يظل الاسترجاع، والتلخيص، والتحفيز الهرمي مهمًا حتى عندما تتسع النافذة لكامل المتن.

## الاعتمادية في الإنتاج

### أعد المحاولة فقط عند الإخفاقات المؤقتة

أعد محاولة حدود المعدّل وإخفاقات الخادم المؤقتة مع تراجع أُسّي وتذبذب. لا تعِد المحاولة تلقائيًا عند مصادقة غير صالحة، أو حمولات غير صحيحة، أو أخطاء سياسات.

import random
import time

def delay_for(attempt: int) -> float:
return min(30.0, (2 ** attempt) + random.random())

for attempt in range(5):
try:
result = call_model()
break
except TransientAPIError:
if attempt == 4:
raise
time.sleep(delay_for(attempt))

### عيّن حواجز تشغيلية

* استخدم مهلات اتصال ومهلات للطلب ككل.
* أرفق مفتاح عدم التكرار لسير عمل ذات آثار خارجية.
* سجّل معرّف النموذج، والكمون، ورموز الإدخال والإخراج، وعدد إعادة المحاولات، والحالة النهائية.
* احذف الأسرار والبيانات الشخصية قبل التسجيل.
* افرض قوائم سماحية للأدوات وطلبات تأكيد للأعمال المدمّرة.
* حافظ على نموذج احتياطي أو طابور لانقطاعات المزوّد.

## الأخطاء الشائعة في واجهة MiMo-V2.5 وحلولها

| العَرَض        | السبب المحتمل                               | الإجراء الموصى به                                          |
| -------------- | ------------------------------------------- | ----------------------------------------------------------- |
| 401 أو 403     | مفتاح API مفقود، غير صالح، أو غير مُخوّل    | تحقق من السر على الخادم وصلاحيات المشروع.                 |
| 400            | رسائل غير صحيحة أو كائن وسائط غير مدعوم     | تحقق من صحة JSON وتأكد من دعم الحمولة لمسارك الحالي.      |
| 413            | جسم الطلب كبير جدًا                         | قلل حجم الوسائط أو قسّم الإدخال.                           |
| 429            | حد المعدل أو الحصة                           | تراجع مع تذبذب وفرض حدود توازي على جهة العميل.            |
| 5xx            | إخفاق مزوّد مؤقت                            | أعد المحاولة ضمن ميزانية محدودة أو تحوّل لنموذج بديل.      |
| استجابة بطيئة  | سياق كبير، إخراج طويل، أو كمون أداة         | قم بالبث، حدّد رموز الإخراج، وحرّر ملفات الأداء لكل مرحلة. |
| JSON غير صالح  | انجراف في التوليد                           | تحقق، وأصلح مرة واحدة إن كان آمنًا، وارفض الإخفاقات المتكررة. |

## الخلاصة

يُعد نموذج MiMo-V2.5 أقوى نقطة انطلاق للفرق التي تحتاج إدخالًا متعدد الوسائط، وسياقًا كبيرًا، وضبطًا قويًا للتكلفة. يجب أن تكون Pro مسار تصعيد متعمد للمهام التي تبرر فيها مكاسب الجودة المقاسة السعر الأعلى. ابدأ بمجموعة تقييم صغيرة، وأدخِل القياس لكل طلب، وادفع التكامل إلى الإنتاج فقط بعد اختبار الحمولات الفعلية، وسلوك السياق الطويل، والتعامل مع إعادة المحاولة، واسترداد الإخفاق.

## الأسئلة الشائعة

### ما نقطة النهاية التي يجب استخدامها؟

استخدم ‎/api.cometapi.com/v1/chat/completions، أو عيّن ‎/api.cometapi.com/v1 كعنوان أساس في حزمة متوافقة مع OpenAI.

### ما معرّف النموذج الذي يجب إرساله؟

استخدم mimo-v2.5 لمسار MiMo-V2.5. أكد المعرّف الحالي قبل الإطلاق إذا كان حسابك يستخدم اسمًا مستعارًا خاصًا بالمزوّد.

### متى يجب اختيار MiMo-V2.5 Pro؟

اختر MiMo-V2.5 Pro عندما يُظهر تقييمك ميزة ملموسة في البرمجة الصعبة، أو الاستدلال، أو مهام الأدوات طويلة الأفق. أبقِ الحركة الروتينية أو متعددة الوسائط على مسار MiMo-V2.5 عندما تكون جودته كافية.

### هل تعني نافذة سياق بسعة 1M رمز أن عليّ إرسال كل شيء؟

لا. السياق الكبير هو حد سعة وليس هدف تصميم المطالبة. استرجع ونظّم الأدلة التي يمكن أن تؤثر في الإجابة، ثم قِس الجودة والتكلفة مع نمو الإدخال.

### هل يمكنني استدعاء الواجهة مباشرةً من المتصفح؟

لا تكشف مفتاح API السري في كود الواجهة الأمامية. استدعِ المزوّد من الواجهة الخلفية وطبّق المصادقة، وحدود المعدّل، والتسجيل، وضوابط البيانات هناك.

### كيف أتحقق من دعم الوسائط المتعددة؟

اختبر حمولة الوسائط الدقيقة مقابل مسار المزوّد الفعّال. لا تضمن وسائط النموذج الأصلية أن كل مسار يعرّض كل صيغة بالطريقة نفسها.