توثيق واجهة برمجة التطبيقات

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

احصل على مفتاح API الخاص بك فوراً بعد التسجيل. تستخدم المنصة مفتاحاً نشطاً واحداً لكل حساب، يتم إصداره عبر تسجيل الدخول بـ Google أو البريد الإلكتروني بدون التحقق من رقم الهاتف. مرر هذا المفتاح في Authorization رأس الصفحة كرمز حامل (Bearer token). يتحقق كل طلب من بيانات الاعتماد قبل معالجة الرموز. المفاتيح المفقودة تولد بديلاً يلغي المفتاح السابق على الفور.

Copycurl https://api.mostunhingedai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send my invoice for 50k tokens"}]
  }'

احفظ مفتاحك بأمان. يتبع تنسيق الرأس الممارسات القياسية المستخدمة في المكتبات (SDKs) الرئيسية. لا توجد بادئات أو صلاحيات خاصة مطلوبة لإكمال النص الأساسي.

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

أرسل الرسائل إلى POST /v1/chat/completions للاستدلال. عنوان URL الأساسي هو https://api.mostunhingedai.com/v1. تقبل الطلبات مصفوفات الرسائل القياسية مع role و content الحقول. معرّف النموذج هو uncensored. تتلقى استجابات نصية بدون رفضات محتوى للمواد القانونية للبالغين. الأخطاء مثل المفاتيح المفقودة تعيد أكواد حالة 401.

Copyfrom openai import OpenAI

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

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

Models endpoint

استعلم عن النماذج المتاحة عبر GET /v1/models. تعيد نقطة النهاية هذه بيانات تعريفية حول النموذج المستضاف الوحيد. تؤكد المعرف uncensored وقدراته. لا توجد نماذج أخرى في هذه النسخة. استخدم نقطة النهاية هذه للتحقق من الاتصال قبل إرسال حمولات ثقيلة.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mostunhingedai.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 القياسي. يمكنك تحليل معرف النموذج برمجيًا لضمان التوافق مع منطق التوجيه الخاص بك. تتطلب هذه النقطة المصادقة ولكنها تُرجع البيانات على الفور.

المعاملات والإعدادات

تحكّم في سلوك التوليد باستخدام المعاملات القياسية. استخدم temperature للعشوائية و top_p للعينة النواة. اضبط seed لإنتاج مخرجات قابلة لإعادة الإنتاج أثناء تصحيح الأخطاء. الـ stop المعامل يوقف التوليد عند سلاسل محددة. اضبط presence_penalty و frequency_penalty لتقليل التكرار.

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

استجابات البث

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

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)

يقلل التدفق من زمن الاستجابة المُدرَك للاستجابات الطويلة. قم بتخزين الأجزاء في تطبيق العميل الخاص بك. يضمن تنسيق أحداث الإرسال (SSE) التسليم الموثوق حتى عبر الاتصالات غير المستقرة. تعكس تحديثات استخدام الرموب الاستهلاك الفعلي بدقة.

حدود، أخطاء، والسياق

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

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