MiniMax M3.1 Flash

استخدم معرّف النموذج ⁦MiniMax-M3.1-Flash⁩ كما هو تمامًا. تتضمن صفحة النموذج ساحة ⁦Playground⁩ والأسعار المباشرة. تحدد مواصفة ⁦OpenAPI⁩ الحقول المتداخلة في الطلبات والاستجابات.

البدء السريع

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"MiniMax-M3.1-Flash",
    "messages":[{"role":"user","content":"What is 17 multiplied by 23?"}],
    "max_completion_tokens":2048,
    "reasoning_effort":"low"
  }'

يحدد هذا المثال حدًا للإخراج؛ وهو ليس القيمة الافتراضية للنموذج. احتفظ بالمفاتيح على خادمك. تستخدم ساحة ⁦Playground⁩ الحساب الذي سجلت الدخول إليه، ولا تتطلب لصق مفتاح ⁦API⁩.

الصيغ والمصادقة

أرسل ⁦Content-Type: application/json⁩ و⁦Authorization: Bearer $SEEDROUTER_API_KEY⁩. تقبل ⁦Messages⁩ أيضًا ⁦x-api-key⁩؛ ويمكن لعملاء ⁦SDK⁩ تضمين ⁦anthropic-version: 2023-06-01⁩. تحتفظ هذه الصيغ ببنية أجسام الطلبات والاستجابات الأصلية الخاصة بها.

المعاملات

جميع الحقول اختيارية باستثناء الحقول المطلوبة أعلاه. يختلف حذف الحقل عن تمرير ⁦null⁩ صراحةً: لا يقبل الحقل ⁦null⁩ إلا إذا نصت مواصفة ⁦OpenAPI⁩ على ذلك. تُحذف حقول المستوى الأعلى غير المدعومة؛ وتؤدي القيم غير الصالحة للحقول المدعومة إلى إرجاع خطأ.

⁦Chat Completions⁩

⁦Messages⁩

⁦Responses⁩

تثبّت ساحة ⁦Playground⁩ قيمة ⁦model⁩ وتتيح جميع الحقول المتبقية: ⁦12⁩ عنصر تحكم لـ⁦Chat⁩، و⁦11⁩ لـ⁦Messages⁩، و⁦12⁩ لـ⁦Responses⁩. تُدخل الكائنات المتداخلة وسجلات المحادثات الكاملة عبر حقول ⁦JSON⁩. تمنع القيم غير الصالحة في الحقول المدعومة إرسال الطلب في المتصفح.

الاستدلال والحدود

تبلغ نافذة السياق الموثقة ⁦1,000,000⁩ رمز. ويبلغ حد الإخراج ⁦524,288⁩ رمزًا، بما يشمل الاستدلال. توصي ⁦MiniMax⁩ بتخصيص ⁦131,072⁩ رمز إخراج للمهام المعقدة، لكنها لا تحدد هذه القيمة كقيمة افتراضية.

التفكير مفعّل دائمًا. لا يدعم هذا النموذج ⁦disabled⁩ أو ⁦none⁩ أو ⁦minimal⁩ كإعدادات للتفكير. وقد تنفد ميزانية الإخراج المحدودة قبل ظهور نص الإجابة. لا يدعم عقد ⁦API⁩ هذا ⁦service_tier⁩ أو الإدخال الصوتي أو إخراج ⁦JSON⁩ المنظّم.

يجب ألا يتجاوز إجمالي جسم الطلب ⁦64 MB⁩. تتحقق خدمة النموذج من الاستخدام الدقيق للسياق ومحتوى الوسائط البعيدة.

الصور والفيديو

تستخدم ⁦Chat⁩ كتل المحتوى ⁦image_url: {"url":"..."}⁩ و⁦video_url: {"url":"..."}⁩. وتستخدم ⁦Messages⁩ كتل صور/فيديو تحتوي على كائن ⁦source⁩: ⁦{"type":"url","url":"..."}⁩ أو ⁦{"type":"base64","media_type":"...","data":"..."}⁩. وتستخدم ⁦Responses⁩ النوع ⁦input_image⁩ أو ⁦input_video⁩، ويمكن أن تكون قيمة ⁦URL⁩ فيهما سلسلة نصية أو كائن خيارات مدعومًا.

يقبل ⁦detail⁩ القيم ⁦low⁩ و⁦default⁩ و⁦high⁩، والقيمة الافتراضية هي ⁦default⁩. يتراوح ⁦fps⁩ للفيديو بين ⁦0.2⁩ و⁦5⁩، وقيمته الافتراضية ⁦1⁩. يجب أن يكون الحقل الاختياري ⁦max_long_side_pixel⁩ عددًا صحيحًا موجبًا حيثما توفره البنية المتداخلة.

{
  "model": "MiniMax-M3.1-Flash",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "Describe the main change in this clip."},
      {"type": "video_url", "video_url": {
        "url": "https://example.com/clip.mp4",
        "fps": 1,
        "detail": "default"
      }}
    ]
  }],
  "max_completion_tokens": 2048
}

استبدل عنوان ⁦URL⁩ في المثال بعنوان ملف خاص بك يمكن الوصول إليه. تستخدم المدخلات المضمّنة نوع ⁦MIME⁩ المناسب لـ⁦base64⁩؛ ويستخدم ⁦MOV⁩ النوع ⁦video/mov⁩. تُمرر مراجع الفيديو الحالية من نوع ⁦mm_file://⁩ كما هي، لكن هذه الخدمة لا توفر ⁦API⁩ لرفع الملفات عبر ⁦Files⁩. ويجب أن يظل المرجع متاحًا للحساب الذي يعالج الطلب.

الأدوات وسجل المحادثة

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

عند متابعة المحادثة عبر ⁦Chat⁩، احتفظ برسالة ⁦assistant⁩ كاملةً، بما فيها ⁦reasoning_content⁩ و⁦tool_calls⁩؛ وتتطلب رسائل الأدوات ⁦tool_call_id⁩. وعند المتابعة عبر ⁦Messages⁩، احتفظ بكتل التفكير والتواقيع وكتل ⁦tool_use⁩ و⁦tool_result⁩. وعبر ⁦Responses⁩، أضف جميع عناصر الإخراج المُعادة قبل إدخال المستخدم التالي.

لا تختزل هذه السجلات إلى نص الإجابة فقط. تُحفظ مخططات معاملات الدوال مهما كان شكلها وحقول الاستدلال التي تُعاد إلى الطلب. لا يحدد المرجع الرسمي لـ⁦Chat⁩ معامل ⁦tool_choice⁩ لهذا النموذج.

البث المباشر وحقول الاستجابة

اضبط ⁦stream: true⁩ لتلقي الأحداث المرسلة من الخادم. ترسل ⁦Chat⁩ الحقل ⁦choices[].delta⁩ وتنتهي بـ⁦[DONE]⁩؛ واطلب ⁦stream_options: {"include_usage":true}⁩ لتلقي بيانات الاستخدام. ترسل ⁦Messages⁩ أحداثًا مسماة مثل ⁦message_start⁩ وتحديثات كتل المحتوى و⁦message_stop⁩. وترسل ⁦Responses⁩ أحداثًا مثل ⁦response.output_text.delta⁩ و⁦response.completed⁩.

تعيد ⁦Chat⁩ دون بث مباشر ⁦choices[].message⁩ و⁦finish_reason⁩ و⁦usage⁩. وتعيد ⁦Messages⁩ كتل المحتوى و⁦stop_reason⁩ وبيانات الاستخدام. وتعيد ⁦Responses⁩ عناصر ⁦output⁩ والحالة وبيانات الاستخدام. احتفظ بالاستجابة كاملةً عندما يحتاج تطبيقك إلى معلومات تتجاوز الإجابة المعروضة.

الاستخدام والأسعار الحالية

يعرض جدول الأسعار المباشرة شريحتي الإدخال. يُطبّق السعر الأول عندما لا يتجاوز إجمالي الإدخال ⁦512,000⁩ رمز؛ وتُطبّق الشريحة الثانية عند تجاوز ⁦512,000⁩. تحدد الشريحة المختارة سعر الطلب بأكمله، بما يشمل الإخراج والتخزين المؤقت.

لا تُحتسب رموز قراءة الذاكرة المؤقتة والكتابة إليها مرة ثانية كإدخال عادي. يفحص التخزين المؤقت التلقائي البادئات المتكررة المؤهلة التي لا تقل عن ⁦512⁩ رمزًا؛ ولا يُضمن العثور عليها في الذاكرة المؤقتة. لا حاجة إلى علامة صريحة للتخزين المؤقت.

تعرض الاستجابات أعداد الرموز، لا التكاليف المالية. وتعرض سجلات استخدام الحساب الرسوم النهائية. لا تُفرض رسوم على الطلبات الفاشلة.

الأخطاء

عند حدوث خطأ، تحقق من الحقل غير الصالح والمرجع العام للأخطاء. يدعم معرّف النموذج نفسه نقاط نهاية النص الثلاث أعلاه؛ ولا يُستخدم مع نقطة نهاية للتضمينات أو ⁦Gemini⁩.

المراجع الرسمية

• استدعاء نماذج ⁦MiniMax⁩
• مرجع ⁦Chat Completions⁩
• مرجع ⁦Messages⁩
• مرجع ⁦Responses⁩
• المتابعة بعد استدعاء الدوال
• التخزين المؤقت التلقائي للمطالبات