أول طلب خلال خمس دقائق

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

ابدأ بتوجيه عميلك المتوافق مع OpenAI إلى عنوان URL الأساسي لواجهة برمجة تطبيقات Mimo. ستتلقى مفتاح API فورًا بعد تسجيل الدخول باستخدام Google أو البريد الإلكتروني. مرر هذا المفتاح في رأس Authorization القياسي. معرف النموذج هو uncensored، وهو يعمل بنموذج مفتوح الأوزان مضبوط لتقليل حالات الرفض في المحتوى البالغ القانوني.

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

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

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

نسخcurl https://api.mimoapi.top/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."}]
  }'

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

تكامل حزمة SDK الخاصة بـ Python

استخدم مكتبة Python الرسمية الخاصة بـ OpenAI للتفاعل مع الواجهة. قم بتجاوز عنوان URL الأساسي ليشير إلى نقطة نهاية واجهة برمجة تطبيقات Mimo. يتيح لك ذلك استخدام نفس طرق SDK التي تستخدمها مع GPT-4 أو النماذج الأخرى. اضبط مفتاح API والنموذج المستهدف في تكوين العميل الخاص بك.

نسخfrom openai import OpenAI

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

يضمن هذا النهج بقاء الكود الخاص بك قابلاً للنقل. إذا قمت بتغيير المزود، فإنك تغير عنوان URL الأساسي والمفتاح فقط. تتعامل حزمة SDK الخاصة بـ Python مع التسلسل وإعادة المحاولة تلقائيًا. يمكنك أيضًا ضبط معاملات مثل seed للحصول على إخراجيات حتمية.

تكامل حزمة SDK الخاصة بـ Node.js

قم بتثبيت حزمة OpenAI Node.js وقم بتكوين عنوان URL الأساسي. مرر مفتاح API الخاص بك في كائن التكوين. سيوجه العميل الطلبات إلى نقطة نهاية النموذج بدون رقابة. يعمل هذا مع استيرادات CommonJS ووحدة ES.

نسخimport OpenAI from "openai";

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

يمكن لمطوري Node.js استخدام نفس الأنماط غير المتزامنة التي يستخدمونها مع خدمات أخرى متوافقة مع OpenAI. تتعامل حزمة SDK مع تحليل التدفق وترميز JSON. يمكنك ضبط max_tokens للتحكم في طول الإخراج، مع افتراض القيمة 2,048 إذا لم يتم تحديدها.

استجابات البث المتدفق (SSE)

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

نسخstream = 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)

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

حدّ المعدل، الأخطاء، ووضع JSON

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

للحصول على إخراج منظم، استخدم وضع JSON عن طريق تعيين response_format إلى json_object. يجبر ذلك النموذج على إرجاع JSON صالح. هذا مفيد لاستدعاء الدوال أو استخراج البيانات. تدعم نافذة السياق ما يصل إلى 32,000 رمز من الإخراج لكل طلب.