دليل البدء السريع لـ Mukenetsu AI API

الإعداد الأساسي وBase URL

تم تصميم Mukenetsu AI كـ REST API متوافق مع OpenAI، مما يتيح استخدام عملاء وSDKs OpenAI الحاليين بتعديلات طفيفة. استخدم Base URL التالي للتواصل مع API.

https://api.mukenetsuapi.com/v1

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

يمكنك الحصول على مفتاح API فورًا عند التسجيل في صفحة Get API key باستخدام البريد الإلكتروني وكلمة المرور. لا حاجة للوحة التحكم. كما نولي الخصوصية أهمية قصوى، ولا تُستخدم بيانات الموجّه لتدريب النموذج.

المصادقة ومفتاح API

للوصول إلى API، يجب المصادقة باستخدام الرأس Authorization: Bearer <API_KEY>. استخدم مفتاح API الخاص بـ Mukenetsu AI الذي تم إنشاؤه عند إنشاء الحساب. يتم تخصيص مفتاح API واحد لكل حساب، ولكن يمكنك إعادة توليده في أي وقت عند الحاجة. يرجى ملاحظة أن مفتاح API السابق سيتم إلغاؤه بعد إعادة توليد المفتاح.

عند حدوث خطأ في المصادقة، يتم عادةً إرجاع استجابة 401 (غير مصرح) أو 402 (مطلوب الدفع). يشير 401 إلى أن المفتاح غير صحيح أو ملغى، بينما يشير 402 إلى أن رصيد الحساب غير كافٍ. الرصيد مسبق الدفع ويمكن شحنه بمبلغ 10 دولارات أمريكية أو أكثر باستخدام العملات المشفرة (USDT و USDC).

نقطة نهاية إكمال المحادثة

نقطة النهاية الرئيسية لتوليد النص هي POST /v1/chat/completions. أرسل طلبًا إلى هذه النقطة لتوليد النص بما في ذلك سجل المحادثة والموجّهات النظامية. حدد معرف النموذج uncensored. هذا نموذج مفتوح الأوزان خاص بنا، يختلف عن نماذج GPT أو البائعين الآخرين.

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

コピーcurl https://api.mukenetsuapi.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."}]
  }'

لا توفر هذه النقطة وظائف مثل التضمين (embeddings) أو توليد الصور أو تحويل الصوت. إنها متخصصة تمامًا في إكمال النص وتوليده.

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

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

إذا كنت تستخدم Python OpenAI SDK أو مكتبة عميل Node.js، يتم معالجة البث المتدفق تلقائيًا فقط بتحديد الخيار stream=True. يتلقى معالج الأحداث كتلًا لكل رمز (token).

コピーfrom openai import OpenAI

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

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

أدوات/استدعاء الدوال

يدعم Mukenetsu AI API استدعاء الدوال (الأدوات). هذا يسهل التكامل مع APIs وقواعد البيانات الخارجية. من خلال تضمين حقل tools ومعامل tool_choice في جسم الطلب، يمكنك جعل النموذج ينفذ دالة محددة.

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

コピーimport OpenAI from "openai";

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

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

حدّ المعدل والقيود

يوجد قيود على استخدام API: حد أقصى 300 طلب في الدقيقة، وحجم أقصى لجسم الطلب هو 8 MB. تجاوز هذه الحدود سيعيد خطأ 429 (Too Many Requests). نافذة السياق هي 100,000 رمز (إجمالي الموجّه + النص المُولد). يجب تقسيم المحادثات أو المستندات الطويلة التي تتجاوز هذا الحد وإرسالها بشكل مناسب.

عند استقبال استجابة البث المتدفق، اتبع تدفق الأحداث التالي.

コピー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)

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