توثيق واجهة برمجة التطبيقات غير الخاضعة للرقابة

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

مفتاح واجهة برمجة التطبيقات الخاص بك يصادق على كل طلب. استخدم عنوان URL الأساسي HTTPS://api.uncensores.cc/v1 مع أي مكتبة OpenAI قياسية. معرف النموذج هو "uncensored". مرر مفتاحك في رأس المصادقة كرمز Bearer. يمكنك إنشاء مفتاح عبر لوحة التحكم باستخدام Google أو البريد الإلكتروني. يحتفظ كل حساب بمفتاح نشط واحد يستبدل المفتاح السابق.

Copycurl https://api.uncensores.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top ten python libraries for data science"}]
  }'

يجب أن تتضمن حقل 'model' في كل طلب. يتوقع نقطة النهاية مصفوفة 'messages' تحتوي على سجل محادثاتك. إذا كان المفتاح مفقوداً أو غير صالح، ستعيد الـ API خطأ 401. يضمن هذا أن يستهلك المستخدمون المصرح لهم فقط رصيدك المدفوع مسبقاً.

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

أرسل طلبات POST إلى /v1/chat/completions لإنشاء النصوص. يتعامل هذا الطرف مع مطالبات المحادثة القياسية ويعيد استجابات نصية منظمة. لا يدعم التضميمات أو إنشاء الصور. تقدم رسائل النظام والمستخدم والمساعد لتوجيه النموذج. يستجيب النموذج بمحتوى نصي خام داخل مصفوفة الخيارات.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncensores.cc/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 الأساسي والمفتاح الخاص بك. عرّف قائمة الرسائل مع الدور والمحتوى المطلوبين. نفذ طريقة chat.completions.create. يحتوي كائن الاستجابة على النص المولد وإحصائيات الاستخدام. يلغي هذا النهج المباشر تعقيد التوجيه لمهام الكتابة الإباحية أو الإبداعية.

استجابات البث مع SSE

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

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)

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

استدعاء الوظائف ووضع JSON

تدعم واجهة برمجة التطبيقات استدعاء الوظائف عبر معلمة tools. عرّف مخطط الدالة في الطلب وحدد tool_choice إلى auto أو اسماً محدداً. يعيد النموذج استدعاءات الدالة في الاستجابة بدلاً من النص العادي. يمكنك أيضاً فرض إخراج JSON عن طريق تعيين response_format إلى json_object. يضمن ذلك تحليلًا متوقعاً لسير العمل الآلي.

Copyimport OpenAI from "openai";

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

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

المعلمات: درجة الحرارة وTop-P والبذلات

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

يمكنك أيضًا استخدام تسلسلات التوقف لإيقاف التوليد عند سلاسل محددة. تساعد presence_penalty و frequency_penalty في تقليل التكرار. درجة الحرارة الافتراضية هي 1.0. يساعد تعديل هذه الإعدادات في التحسين لألعاب الأدوار أو الكتابة التقنية. يدعم كل طلب هذه المعلمات القياسية المتوافقة مع OpenAI.

حدود الرموز ونافذة السياق

تدعم نافذة السياق إجمالي 100,000 رمز موزع بين النص المطلوب والإكمال. يمكنك إخراج ما يصل إلى 16,000 رمز لكل طلب. إذا حذفت max_tokens، فإن القيمة الافتراضية هي 2,048 رمز. ينطبق هذا الحد على المدخلات والمخرجات مجتمعة. سيفشل الطلبات التي تتجاوز حجم الجسم البالغ 8 ميجابايت. تفرض الـ API حداً لمعدل الطلبات يبلغ 300 طلب في الدقيقة. يتم تقييد الطلبات المتزامنة بـ 8 لكل مفتاح. توفر أخطاء مثل 402 (لا رصيد) أو 429 (حد المعدل) ملاحظات واضحة. لا ينتهي صلاحية الرصيد غير المستخدم، مما يضمن دفعك فقط مقابل الاستخدام الفعلي.