AR ▾

إعداد واجهة MiniMax API: المفتاح، عنوان URL الأساسي والطلب الأول

هذا دليل إعداد خطوة بخطوة لواجهة API المتوافقة مع OpenAI على minimaxapikey.com: الحساب، المفتاح، عنوان URL الأساسي، الطلب الأول. إنها خدمة مستقلة وليست واجهة API الرسمية لأي بائع نماذج.

محدّث

ست خطوات مضيئة تؤدي من مفتاح إلى رف خوادم، تمثل مسار إعداد واجهة API

نقاط رئيسية

  • سجّل باستخدام Google أو البريد الإلكتروني، ثم احصل على رصيد تجريبي بقيمة $0.50 في صفحة المفتاح. لا يلزم بطاقة ائتمان.
  • عنوان URL الأساسي هو https://api.minimaxapikey.com/v1، ومعرف النموذج هو uncensored، والمصادقة تتم عبر مفتاح Bearer.
  • توجد طريقتان: POST /v1/chat/completions و GET /v1/models.
  • الرمز 401 يعني مفتاحًا غير صالح، والرمز 429 يعني تجاوز الحد، لذا تحقق من رمز الخطأ في نص الاستجابة.

ما تقوم بإعداده

يبحث الناس عن إعداد واجهة MiniMax API متوقعين أحد أمرين: منصة المطورين الرسمية لـ MiniMax، أو نقطة نهاية بديلة على غرار OpenAI. تغطي هذه الصفحة الخيار الثاني. الخدمة وراء minimaxapikey.com هي واجهة نصية متوافقة مع OpenAI تعمل بنموذج واحد مفتوح الأوزان، وتشغلها جهة مستقلة. ليست واجهة API الرسمية لـ MiniMax أو لأي بائع نماذج آخر، ولا تعيد توجيه الطلبات بين البائعين. إذا كنت بحاجة إلى منصة البائع الخاصة، استخدم موقعهم.

ما ستحصل عليه بسيط. أي مكتبة SDK أو عميل OpenAI يعمل بمجرد تغيير عنوان URL الأساسي والمفتاح. هناك طريقتان، POST /v1/chat/completions و GET /v1/models، ومعرف نموذج واحد، uncensored، ونافذة سياق بحجم 100,000 رمز مشتركة بين الموجّه والإكمال. يدعم النصوص فقط، لذا لا يوجد توليد صور أو صوت أو فيديو، ولا تضمينات ولا ضبط دقيق. البث المتدفق، استدعاء الدوال ووضع JSON مدعومان.

يستغرق الإعداد بأكمله بضع دقائق. الخطوات أدناه مرتبة بالتسلسل، وتنتهي كل منها بخطوة تحقق لتتأكد من نجاحها قبل الانتقال إلى الخطوة التالية.

الخطوة 1 و 2: إنشاء حساب والحصول على التجربة

  1. افتح صفحة المفتاح. انتقل إلى صفحة مفتاح API وقم بالتسجيل. يمكنك استخدام حساب Google، أو عنوان بريد إلكتروني وكلمة مرور.
  2. احصل على رصيد التجربة. بعد التسجيل، تحتوي صفحة المفتاح على زر للحصول على رصيد تجريبي مجاني بقيمة $0.50. يتطلب نقرة واحدة، ولا يحتاج إلى بطاقة، وهو صالح لمدة 7 أيام، ومحدود بنسخة واحدة لكل شخص.

التجربة صغيرة عن قصد. بسعر $0.15 لكل مليون رمز مدخل و $0.50 لكل مليون رمز مخرج، يغطي $0.50 عددًا جيدًا من طلبات الاختبار. تكلفة موجّه بحجم 1,000 رمز مع إجابة بحجم 500 رمز هي $0.00015 للإدخال و $0.00025 للإخراج، أي ما مجموعه $0.0004. بقسمة $0.50 على هذا المبلغ نحصل على 1,250 طلبًا من هذا النوع، مما يمنحك مساحة كافية للتجربة.

لاحظ حدود مفتاح التجربة: طلبين متزامنين و 60 طلبًا في الدقيقة. المفتاح الكامل، الذي تحصل عليه بعد شحن الرصيد، يسمح بـ 8 طلبات متزامنة و 300 طلب في الدقيقة. إذا كانت حلقة الاختبار الخاصة بك تعمل بشكل متوازٍ ولاحظت أخطاء 429، فهذا هو أول ما يجب التحقق منه.

الخطوة 3: إنشاء المفتاح وتخزينه بأمان

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

# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"

# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"

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

الخطوة 4: سرد النماذج لتأكيد صحة المفتاح

أرخص اختبار ممكن هو نقطة النهاية للنماذج. لا يولّد نصًا، لذا فهو فحص نظيف للمفتاح وURL وشبكتك.

curl -s https://api.minimaxapikey.com/v1/models \
  -H "Authorization: Bearer $UNCENSORED_KEY"

يجب أن تحصل على قائمة JSON تتضمن uncensored. إذا حصلت على خطأ 401، فالمفتاح غير صحيح أو يحتوي على مسافة أو علامة اقتباس زائدة حوله. إذا فشل الاتصال، تحقق من أن عنوان URL ينتهي بـ /v1 وأنك استخدمت https.

الخطوة 5: إرسال طلب الدردشة الأول

الآن، إكمال حقيقي. هيكل الجسم هو هيكل إكمال الدردشة القياسي.

curl -s https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what an API key is in two sentences."}
    ],
    "temperature": 0.7
  }'

يحتوي الرد على choices[0].message.content وكتلة usage التي تحتوي على عدد رموز الموجّه والإكمال. انظر أيضًا إلى رؤوس الاستجابة باستخدام curl -i. سترى X-Request-Id، الذي يمكن لفريق الدعم استخدامه للعثور على طلبك، و X-Balance-USD، رصيدك المتبقي، ورؤوس حدّ المعدل X-RateLimit-Limit-Requests و X-RateLimit-Limit-Concurrency.

تمرير المعلمات مثل temperature، top_p، stop، seed والعقوبات كما هي. max_tokens اختياري. إذا لم تحدده، يمكن أن يستخدم الإكمال أي جزء متبقي من نافذة السياق.

الخطوة 6: نفس الاستدعاء من SDK

بمجرد أن يعمل curl، انتقل إلى اللغة التي ستستخدمها فعليًا. يتغير وسيطان فقط من إعداد OpenAI الافتراضي.

from openai import OpenAI
import os

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

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";

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

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);

للبث المتدفق، أضف stream: true واقرأ أحداث SSE. تصل أرقام الاستخدام في نهاية البث. تغطي صفحة المستندات البث المتدفق، واستدعاء الدوال، ووضع JSON مع response_format: {"type":"json_object"}.

نقل مشروع OpenAI الحالي

في معظم الأوقات، المشروع الذي تريد الاتصال به يعمل بالفعل مع مكتبة عميل OpenAI. في هذه الحالة، نادرًا ما تحتاج إلى تعديل الكود. تقرأ واجهات برمجة التطبيقات (SDKs) الرسمية متغيرات البيئة OPENAI_API_KEY و OPENAI_BASE_URL عندما لا تمرر معلمات، لذا قد يكون تغيير النشر كافيًا.

export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"

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

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

الإعدادات التي تستحق الاختيار منذ اليوم الأول

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

  • موجّه النظام. ضع تعليماتك حول النبرة والتنسيق والدور في رسالة system. اجعلها قصيرة ومحددة، لأن كل طلب يكرر هذه التعليمات كرموز مدخل.
  • حد الرموز. يعتبر max_tokens اختياريًا، لكن الحد هو ضمان رخيص التكلفة. بدونه قد تستخدم إجابة واحدة الجزء المتبقي من نافذة 100,000 رمز.
  • البث المتدفق للاستخدام التفاعلي. اضبط stream: true إذا كان شخص ما ينتظر الرد. بالنسبة لالمهام الدفعية (batch)، الطلبات العادية أكثر بساطة.
  • قاعدة إعادة المحاولة لخطأ 429. تعامل مع الخطأ 429 على أنه إشارة للانتظار، وليس كفشل. عندما يتضمن الرد Retry-After: 5، فإن الانتظار لمدة زمنية مساوية ثم إعادة المحاولة هو الإجراء الصحيح.
  • حجم الطلب. حد الجسم هو 8 MB. هذا أكثر بكثير مما يحتاجه الموجّه العادي، لكن السجلات أو المستندات الملصقة قد تصل إلى هذا الحد.

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

شحن الرصيد بعد التجربة

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

يصلح أي مبلغ صحيح من $20 إلى $500. إضافة رصيد بمبلغ $50 تضيف مكافأة بنسبة 5%، و$100 تضيف 10%، و$200 تضيف 15%. كمثال سريع، إضافة رصيد بمبلغ $100 مع مكافأتها بنسبة 10% تعطي رصيدًا بقيمة $110. عند طلب بموجّه بحجم 1,000 رمز وإجابة بحجم 500 رمز من الخطوة الثانية، يكلف كل طلب $0.0004، لذا يغطي $110 ما مجموعه 275,000 طلب. الموجّهات الحقيقية أطول عادةً، لذا اضرب هذا الرقم في متوسطك الخاص.

تصحيح أخطاء الإعداد الشائعة

العرضالسبب المحتملالحل
خطأ 401 في كل استدعاءمفتاح مفقود أو مكتوب بشكل خاطئ أو ملغيأرسل Authorization: Bearer <key>، بدون علامات اقتباس إضافية
خطأ 404 أو استجابة HTMLمسار خاطئ، عادةً بسبب فقدان /v1استخدم عنوان URL الأساسي الكامل الذي ينتهي بـ /v1
النموذج غير موجوداسم نموذج تم نسخه من مزود آخراستخدم uncensored
429 مع rate_limitedتجاوز حد الطلبات في الدقيقةتباطأ، أو قم بشحن الرصيد للانتقال من حدود التجربة إلى الحدود الكاملة
429 مع concurrencyعدد كبير من الطلبات في آن واحدحدد الطلبات المتزامنة عند 8 (2 على مفتاح التجربة)
429 مع Retry-After: 5حمل زائد مؤقتانتظر 5 ثوانٍ وأعد المحاولة
خطأ 413 أو رفض الجسمطلب يتجاوز 8 MBاختصر الموجّه أو قسم المهمة

عندما تكون جاهزًا للحصول على أكثر من التجربة، يعرض صفحة التسعير خيارات شحن الرصيد: أي مبلغ صحيح من $20 إلى $500، بالدفع بالعملات المشفرة فقط (USDT على TRC20، USDC على Base)، مع مكافأة بنسبة 5% من $50، و10% من $100، و15% من $200. الطلبات الفاشلة أو المرفوضة لا تُفرض عليها رسوم، ولا تُستخدم الموجّهات في التدريب.

أسئلة وأجوبة

هل هذا هو MiniMax API الرسمي؟

لا. إنها واجهة برمجة تطبيقات (API) مستضافة ومستقلة ومتوافقة مع OpenAI، تخدم نموذجًا واحدًا مفتوح الأوزان، ومُضبطًا للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين. ليست واجهة برمجة التطبيقات الرسمية لأي بائع نماذج، وليست وسيطًا (router) بين عدة بائعين.

هل أحتاج إلى بطاقة ائتمان لتجربته؟

لا. بعد تسجيل الدخول، يمكنك الحصول على رصيد تجريبي بقيمة $0.50 بنقرة واحدة في صفحة مفتاح API. الرصيد صالح لمدة 7 أيام ومحدود بنسخة واحدة لكل شخص.

ما هو اسم النموذج الذي يجب استخدامه في الطلبات؟

استخدم uncensored. تعرض الخدمة معرف النموذج (model ID) هذا فقط، وسيظهر في الطلب GET /v1/models.

كيف يمكنني إضافة رصيد لاحقًا؟

قم بشحن أي مبلغ صحيح يتراوح بين $20 و$500. تُطبق المكافآت من $50 (+5%)، و$100 (+10%)، و$200 (+15%)، ولا تنتهي صلاحية الرصيد.

هل يمكنني استخدام SDK الخاص بـ OpenAI؟

نعم. اضبط base_url إلى https://api.minimaxapikey.com/v1, واستخدم مفتاحك، وأرسل النموذج باسم uncensored. لا يتغير أي شيء آخر في الكود الخاص بك.

مفتاحك على بُعد نموذج تسجيل واحد

أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذا هو الإعداد بالكامل.

احصل على مفتاح API