MiniMax API: أول طلب في خمس دقائق

تثبيت OpenAI SDK

ابدأ بتثبيت OpenAI SDK الرسمي للغتك المفضلة. تتعامل المكتبة مع تنسيق الطلبات والبث المتدفق تلقائياً. تأكد من تثبيت Python 3.8+ أو Node.js 18+. قم بتشغيل pip install openai لـ Python أو npm install openai لـ Node. يبسط SDK التفاعل مع نقطة النهاية /v1/chat/completions. يدير الرؤوس، إعادة المحاولة، وتحليل SSE بحيث يمكنك التركيز على الموجّه. هذا يعمل لأن API الخاص بنا يتبع معيار إكمال محادثات OpenAI. لا تحتاج إلى مكتبة عميل مخصصة. طرق SDK القياسية تتطابق مباشرة مع نقاط النهاية الخاصة بنا. هذا يقلل من وقت التكامل ويستفيد من معرفة المطورين الموجودة.

تكوين عنوان URL الأساسي والمفتاح

اضبط مفتاح API وعنوان URL الأساسي في متغيرات البيئة. عنوان URL الأساسي لدينا هو https://api.minimaxapikey.com/v1. يتيح لك ذلك استخدام عملاء OpenAI القياسية دون تعديل. أنشئ حسابًا لتوليد مفتاحك. يظهر المفتاح فورًا بعد التسجيل. لا حاجة لبطاقة الائتمان للتجربة المجانية. احفظ المفتاح بأمان. مرره كعنوان أو متغير بيئة. يستخدم الـ SDK OPENAI_API_KEY افتراضيًا. يمكنك تجاوز عنوان URL الأساسي للإشارة إلى خوادمنا. يضمن ذلك توجيه جميع الطلبات إلى النموذج بدون رقابة. تحقق من عمل مفتاحك بنقرة بسيطة. تمنع هذه الخطوة أخطاء المصادقة لاحقًا.

إرسال إكمال محادثة أساسي

أرسل أول طلب لتوليد النص. استخدم طريقة POST على /v1/chat/completions. حدد النموذج كـ uncensored. مرر مصفوفة رسائل مع موجّه المستخدم. تُرجع API رمز الإكمال. هذه ميزة توليد النص الأساسية. تدعم نافذة السياق 100k. يمكنك إرسال موجّهات طويلة أو سجل المحادثات. يتضمن الرد النص المولد واستخدام الرموز. هذا مثالي للكتابة الإبداعية أو الحوار غير المقيد. تأكد من أن المحتوى قانوني. لا يرفض النموذج مواضيع البالغين. يحظر فقط المحتوى الجنسي الذي يتضمن قاصرين. ابدأ ببساطة للتحقق من الاتصال.

تمكين البث (SSE)

للحصول على مخرجات في الوقت الفعلي، فعّل البث المتدفق. اضبط المعلمة stream على true. تُعيد الـ API أحداثًا مُرسلة من الخادم (SSE). يحتوي كل جزء على جزء من الاستجابة. يقلل هذا من زمن الاستجابة المُدرَك. يرى المستخدمون النص يظهر أثناء توليده. يتعامل الـ SDK مع تحليل الأجزاء تلقائيًا. يمكنك عرض النص تدريجيًا في واجهة المستخدم. هذا أمر حاسم لواجهات الدردشة. يعمل البث المتدفق مع جميع استجابات النموذج. لا يؤثر على عد الرموز. يتضمن كل جزء بيانات الاستخدام في النهاية. استخدم ذلك لتحسين تجربة المستخدم. يبدو أكثر استجابة من الانتظار للحصول على الاستجابة الكاملة. قم بتكوين عميلك لتخزين الأجزاء بشكل صحيح.

استخدام استدعاء الدوال

ادعم المخرجات المهيكلة مع استدعاء الدوال. عرّف الأدوات في جسم الطلب. يمكن للنموذج استدعاء الدوال بناءً على الموجّه. هذا يتيح التكامل مع الأنظمة الخارجية. مرر تعريفات الأدوات ورسائل المستخدم. يتضمن الرد كائن استدعاء الأداة. نفذ الدالة وأعد النتائج. هذا يعمل مع مكتبات OpenAI SDK القياسية. يتيح سير العمل المعقد. يمكنك بناء وكلاء أو مساعدين. يحافظ النموذج على السياق عبر المكالمات. هذا قوي للأتمتة. تأكد من أن تعريفات أدواتك دقيقة. تتعامل API مع توجيه مخرجات الأدوات. يحافظ على تماسك المحادثة. استخدم هذا لتوليد المحتوى الديناميكي.

فحص النماذج المتاحة

تحقق من قائمة النماذج عبر GET /v1/models. تُعيد نقطة النهاية هذه النماذج المتاحة. تخدم الـ API نموذجًا واحدًا: uncensored. إنه نموذج مفتوح الأوزان. ليس GPT أو Claude أو Gemini. تؤكد الاستجابة معرف النموذج. استخدم ذلك لتصكوين عميلك. تأكد من أن كودك يستهدف النموذج الصحيح. نقطة النهاية سريعة وموثوقة. تُعيد بيانات JSON. يمكنك تحليل ذلك لعرضها في واجهة المستخدم. يؤكد ذلك أن مفتاح API الخاص بك صالح. استخدم ذلك لفحوصات الصحة الآلية. إنه جزء من مواصفات OpenAI القياسية. لا حاجة لإعداد إضافي. يضمن ذلك التوافق مع الأدوات الموجودة.

cURL

Copycurl https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minimaxapikey.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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.minimaxapikey.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);

البث المتدفق

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)