بدء استخدام MiniMax M3 API مع Novita AI

يتوفر MiniMax M3 عبر Novita AI باستخدام معرف النموذج minimax/minimax-m3، وعنوان URL أساسي متوافق مع OpenAI، ونافذة سياق تبلغ 1,000,000 رمز، وأسعار متدرجة للاستفسارات الطويلة. هذا الدليل السريع يبقي الإعداد عمليًا: انسخ معرف النموذج، واضبط مفتاح API الخاص بك، وشغّل طلبًا صغيرًا واحدًا، ثم انتقل إلى الاستفسارات الأطول بمجرد عمل الأساسيات.

متى تستخدم هذا الدليل السريع

استخدم هذا الدليل السريع عندما تريد اختبار MiniMax M3 عبر مسار API بدون خادم بدلاً من بناء حل حول استضافة النموذج الخام. إنه مخصص للمطورين الذين لديهم بالفعل استفسار أو عبء عمل في أذهانهم ويحتاجون إلى نقطة النهاية، ومعرف النموذج، وحدود الرموز، وتفاصيل الأسعار قبل كتابة إثبات مفهوم صغير.

MiniMax M3 مناسب جدًا عندما يتطلب طلبك ميزانية سياق كبيرة، أو إخراجًا منظمًا، أو مهامًا موجهة نحو الأدوات، أو مساعدة برمجية عبر مدخلات طويلة. في Novita AI، تسرد صفحة النموذج الحالية text وimage وvideo كأنماط إدخال مقبولة، وtext كنمط إخراج، ودعم الوصول بدون خادم، واستدعاء الدوال، والإخراج المنظم، والتفكير، والتوافق مع Anthropic API.

هذا ليس تحليلاً عميقًا للمقاييس أو إعلان إطلاق. الهدف أبسط: قم بطلب نظيف واحد، ثم قرر ما إذا كان MiniMax M3 مناسبًا لتطبيقك.

الخطوة 1: احصل على مفتاح Novita API الخاص بك

أنشئ أو اختر حساب Novita AI، وافتح إعدادات مفتاح API، وأنشئ مفتاحًا للاستخدام من جانب الخادم. احتفظ بالمفتاح خارج كود جانب العميل، وحزم الواجهة الأمامية، والمستودعات العامة، ودفاتر الملاحظات التي قد تتم مشاركتها خارج فريقك.

اضبط المفتاح كمتغير بيئي قبل تشغيل الأمثلة:

export NOVITA_API_KEY="your_api_key_here"

إذا كنت تختبر في بيئة فريقية، استخدم مفتاح مشروع بنطاق محدد أو مفتاح مؤقت إذا كان إعداد حسابك يدعم ذلك. قم بتدوير المفتاح بعد العروض التوضيحية العامة أو التجارب المشتركة أو أي تعرض عرضي.

الخطوة 2: تأكيد معرف النموذج ونقطة النهاية

قبل كتابة الكود، احتفظ بتفاصيل اتصال MiniMax M3 في مكان واحد:

الحقل	القيمة
معرف النموذج	minimax/minimax-m3
عنوان URL الأساسي	https://api.novita.ai/openai
عنوان URL لإكمال الدردشة	https://api.novita.ai/openai/v1/chat/completions
نافذة السياق	1,000,000 رمز
أقصى إخراج	131,072 رمزًا
المدخلات	نص، صورة، فيديو
الإخراج	نص
دعم بدون خادم	مدعوم
استدعاء الدوال	مدعوم
الإخراج المنظم	مدعوم
التفكير	مدعوم
التوافق مع Anthropic API	مدعوم

تحقق من وثائق نموذج MiniMax M3 قبل الإطلاق، حيث أن التوفر والأسعار والحدود قد تتغير.

الخطوة 3: أرسل طلبك الأول

ابدأ بطلب دردشة نصية قصير. من الأسهل بكثير تصحيح المصادقة والتوجيه وتحليل الاستجابة قبل إضافة استفسار كبير.

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

اجعل max_tokens متواضعًا للطلب الأول. يدعم MiniMax M3 إخراجًا أطول، لكن المهمة الأولى هي تأكيد أن التكامل يعمل.

الخطوة 4: اقرأ الاستجابة

عادةً ما تُرجع استجابة إكمال الدردشة المتوافقة مع OpenAI إجابة المساعد في choices[0].message.content.

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

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

الخطوة 5: تحقق من الأسعار والحدود والأخطاء الشائعة

يستخدم MiniMax M3 أسعارًا متدرجة على Novita AI. يتغير السعر بمجرد دخول الاستفسار إلى نطاق السياق الطويل:

نطاق حجم الاستفسار	الإدخال	الإخراج	قراءة ذاكرة التخزين المؤقت
أقل من 524,288 رمزًا	0.30 دولار لكل مليون رمز	1.20 دولار لكل مليون رمز	0.06 دولار لكل مليون رمز
من 524,288 إلى 1,000,000 رمز	1.20 دولار لكل مليون رمز	4.80 دولار لكل مليون رمز	0.24 دولار لكل مليون رمز

هذا التقسيم مهم. اختبار بحجم 50,000 رمز وطلب يقترب من مليون رمز ليس لهما نفس السعر. عند تقدير التكلفة، قم بتضمين طول الاستفسار وطول الإخراج المتوقع وسلوك ذاكرة التخزين المؤقت وإعادة المحاولة وعدد المرات التي قد يرسل فيها المستخدمون طلبات كبيرة جدًا.

يحتوي MiniMax M3 حاليًا على نافذة سياق تبلغ 1,000,000 رمز وأقصى إخراج يبلغ 131,072 رمزًا. قبل الإطلاق، أعد التحقق من وثائق نموذج MiniMax M3 للحصول على أحدث جدول أسعار وأي إرشادات حول حد المعدل المرتبطة بحسابك.

تشمل أخطاء الإعداد الشائعة:

• رأس Authorization مفقود أو غير صحيح.
• استخدام معرف نموذج خاطئ، مثل اسم العرض بدلاً من minimax/minimax-m3.
• إرسال الطلبات إلى عنوان URL أساسي خاطئ.
• تعيين max_tokens أعلى مما يمكن لتطبيقك استهلاكه بأمان.
• اختبار استفسارات السياق الطويل دون مراعاة نطاق السعر الأعلى.
• تمرير محتوى متعدد الوسائط بشكل لا تدعمه مكتبة العميل الخاصة بك.

مثال بلغة Python

يستخدم هذا مثال مكتبة OpenAI Python SDK مع عنوان URL الأساسي المتوافق مع OpenAI لـ Novita AI.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/openai/v1",
)

response = client.chat.completions.create(
    model="minimax/minimax-m3",
    messages=[
        {
            "role": "system",
            "content": "أنت مساعد API موجز لفرق البرمجيات.",
        },
        {
            "role": "user",
            "content": "لخص المخاطر الرئيسية للتنفيذ في عملية مراجعة الكود ذات السياق الطويل.",
        },
    ],
    temperature=0.2,
    max_tokens=600,
)

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

أرسل الطلب باستخدام cURL

إذا كنت تفضل cURL، احتفظ بجسم JSON في متغير payload. هذا يجعل الطلب أسهل للقراءة ويتجنب حشر جسم JSON الكامل في أمر واحد.

payload='{
  "model": "minimax/minimax-m3",
  "messages": [
    {
      "role": "system",
      "content": "أنت مساعد API موجز لفرق البرمجيات."
    },
    {
      "role": "user",
      "content": "لخص المخاطر الرئيسية للتنفيذ في عملية مراجعة الكود ذات السياق الطويل."
    }
  ],
  "temperature": 0.2,
  "max_tokens": 600
}'

curl --request POST "https://api.novita.ai/openai/v1/chat/completions" \
  --header "Authorization: Bearer $NOVITA_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$payload"

المعلمات الرئيسية

المعامل	ما يتحكم فيه	ابدأ بـ
model	أي نموذج مستضاف يجيب على الطلب	minimax/minimax-m3
messages	تعليمات النظام والمستخدم	استفسار نصي قصير
temperature	تغير المخرجات	0.2 للاختبارات القابلة للتكرار
max_tokens	أقصى إخراج يتم إنشاؤه	سقف صغير، ثم ارفعه لاحقًا
stream	ما إذا كانت الرموز تتدفق تدريجيًا	فعل بعد عمل المكالمة الأساسية
tools	تعريفات الدوال/الأدوات	أضف أداة واحدة في كل مرة
response_format	شكل الاستجابة المنظمة	تحقق من الإخراج قبل استخدامه

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

استكشاف الأخطاء وإصلاحها

فشل المصادقة

تحقق من تعيين NOVITA_API_KEY في نفس الصدفة أو بيئة التشغيل حيث تقوم بتشغيل الطلب. يجب أن يستخدم رأس التخويل تنسيق رمز الحامل (bearer token).

لا يمكن لـ API العثور على النموذج

تأكد من أن الطلب يستخدم minimax/minimax-m3، وليس MiniMax M3 أو minimax-m3 أو عنوان مدونة. أسماء عرض النماذج ومعرفات النماذج غير قابلة للتبديل.

يعمل الطلب للاستفسارات القصيرة لكنه يفشل للاستفسارات الطويلة

قم بقياس الإدخال المتسلسل، وليس فقط عدد الكلمات المرئي. مخططات الأدوات والمستندات المستردة ومراجع الصور وسجل المحادثة كلها تُحتسب. إذا كنت تقترب من 1,000,000 رمز، جرب استفسارًا أصغر وأضف منطق الاقتطاع أو الاسترجاع قبل إعادة المحاولة.

الفاتورة أعلى من المتوقع

تحقق مما إذا كان الاستفسار قد دخل نطاق تسعير 524,288 إلى 1,000,000 رمز. يحتوي MiniMax M3 على أسعار أعلى للإدخال والإخراج وقراءة ذاكرة التخزين المؤقت في هذه الطبقة ذات السياق الطويل.

الإخراج المنظم غير متسق

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

استدعاءات الدوال لا تتطابق مع مخطط الدالة الخاص بك

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

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

هل MiniMax M3 متاح عبر Novita AI API؟

نعم. تسرد صفحة نموذج Novita AI الحالية MiniMax M3 كمتاح عبر الوصول إلى API بدون خادم بمعرف النموذج minimax/minimax-m3.

ما هو معرف النموذج لـ MiniMax M3؟

استخدم minimax/minimax-m3.

ما عنوان URL الأساسي الذي يجب أن أستخدمه؟

استخدم https://api.novita.ai/openai كعنوان URL أساسي متوافق مع OpenAI. في OpenAISDKs، اضبط عنوان URL الأساسي لـ SDK على https://api.novita.ai/openai/v1.

كم تكلفة MiniMax M3 على Novita AI؟

أسعار MiniMax M3 متدرجة. للاستفسارات الأقل من 524,288 رمزًا، الإدخال 0.30 دولار لكل مليون رمز، والإخراج 1.20 دولار لكل مليون رمز، وقراءة ذاكرة التخزين المؤقت 0.06 دولار لكل مليون رمز. للاستفسارات من 524,288 إلى 1,000,000 رمز، الإدخال 1.20 دولار لكل مليون رمز، والإخراج 4.80 دولار لكل مليون رمز، وقراءة ذاكرة التخزين المؤقت 0.24 دولار لكل مليون رمز.

هل يدعم MiniMax M3 البث أو الإدخال متعدد الوسائط؟

تسرد صفحة النموذج الحالية مدخلات النص والصورة والفيديو مع إخراج نصي. يجب اختبار سلوك البث عبر مسار إكمال الدردشة المتوافق مع OpenAI قبل الاستخدام في الإنتاج.

ما هو الحد الأقصى لنافذة السياق؟

يحتوي MiniMax M3 حاليًا على نافذة سياق تبلغ 1,000,000 رمز وأقصى إخراج يبلغ 131,072 رمزًا.