MiniMax api: Quickstart and SDK Guide

المصادقة وURL الأساسي

استخدم مفتاح API المقدم ووجه عميلك إلى عنوان URL الأساسي المخصص. نقطة النهاية لتوليد الاستجابات هي https://api.minimaxaiapi.com/v1/chat/completions. تمرر المفتاح في Authorization قيمة التوكن كـ bearer token. يعمل مع أي مكتبة SDK قياسية لـ OpenAI لأننا نتبع نفس البروتوكول.

• اسم الرأس: Authorization
• قيمة الرأس: Bearer YOUR_API_KEY
• URL الأساسي: https://api.minimaxaiapi.com/v1

لا حاجة لإعداد معقد. فقط قم بتحديث التكوين في مشروعك الحالي.

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

نقطة نهاية إكمال الدردشة

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

تتعامل هذه نقطة النهاية مع جميع توليد النصوص. لا تدعم التضمينات، أو الصوت، أو الفيديو. يمكنك تدفق الاستجابات أو انتظار الكتلة الكاملة. يتعامل النموذج مع سياق يصل إلى 100,000 رمز مخصص (token) إجماليًا.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minimaxaiapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

استخدام الرموز والبث

فعّل البث عن طريق تعيين stream: true في طلبك. يعيد الواجهة البرمجية أحداث الإرسال من الخادم (SSE) لكل رمز يتم توليده. هذا يسمح بالعرض الفوري للمخرجات. تتضمن إحصائيات استخدام الرموز في الشريحة الأخيرة من التدفق. يساعدك هذا على تتبع التكاليف بدقة دون تحليل كل رمز فردي.

يقلل التدفق من زمن الاستجابة المُدرَك للاستجابات الطويلة. إنه مثالي لواجهات الدردشة وتوليد المحتوى الديناميكي. يمكنك إيقاف التدفق مبكراً إذا مقاطعة المستخدم للتوليد.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.minimaxaiapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

استدعاء الوظائف ووضع JSON

استخدم ال tools معامل لتمكين استدعاء الوظائف. عرّف وظائفك في جسم الطلب واترك النموذج يختار ما يجب استدعاؤه. الـ tool_choice المعامل يسمح لك بإجبار وظيفة محددة أو الاختيار التلقائي. للإخراج JSON الصارم، اضبط response_format إلى {"type": "json_object"}. يضمن ذلك أن تكون الاستجابة بيانات JSON صالحة.

استدعاء الوظائف مفيد لاستخراج البيانات المنظمة أو تشغيل الإجراءات. وضع JSON مثالي لتكاملات واجهة برمجة التطبيقات التي تتطلب تنبؤات تنسيقية. اجمع بين الاثنين لمنطق تطبيق قوي.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

معلمات النموذج والقيود

اضبط سلوك التوليد باستخدام المعلمات القياسية مثل temperature, top_p، و stop. الحد الأقصى لنافذة السياق هو 100,000 رمز، بما في ذلك الطلب والاستجابة. الحد الأقصى للإخراج لكل طلب هو 16,000 رمز. إذا لم تقم بتعيين max_tokens, الحد الافتراضي هو 2,048 رمزًا.

استخدام seed لإنتاج نتائج قابلة لإعادة الإنتاج. اضبط presence_penalty و frequency_penalty للتحكم في التكرار. تمنحك هذه المعلمات تحكماً دقيقاً في إبداع النموذج واتساقه. اختبر دائماً مع حالة الاستخدام المحددة الخاصة بك للعثور على التوازن المناسب.

حدود المعدلات والأخطاء

تفرض الـ API حدًا قدره 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. إذا تجاوزت هذه الحدود، ستتلقى خطأ 429. يشير الخطأ 401 إلى مفتاح API غير صالح أو مفقود. يعني الخطأ 402 استنفاد رصيدك المدفوع مسبقاً.

لا تستهلك الأخطاء رصيدك. يمكنك إعادة محاولة الطلبات الفاشلة دون عقوبة. حجم جسم الطلب محدود بـ 8 ميجابايت. أدر التزامن الخاص بك بعناية لتجنب الحد من السرعة. راقب استخدامك عبر الجزء الأخير من استجابات البث.