URL الأساسي والمصادقة
يعمل API على https://api.nsfwchatbot.cc/v1. يستخدم مصادقة رمز Bearer القياسية. تحصل على مفتاح API واحد عبر صفحة Get API key، التي تدعم تسجيل الدخول عبر Google أو البريد الإلكتروني. يجب إرسال المفتاح في رأس Authorization. مفتاح واحد فقط نشط لكل حساب؛ إنشاء مفتاح جديد يلغي سريان المفتاح السابق. لا توجد اشتراكات شهرية—الرصيد مسبق الدفع ولا ينتهي صلاحيته.
تأكد من أن مكتبة العميل تشير إلى URL الأساسي المذكور أعلاه. معرف النموذج هو دائماً uncensored. هذا نموذج مفتوح الأوزان مضبوط لرفض المحتوى بأقل قدر، وهو مميز عن GPT أو Claude. يقدم استجابات نصية خام بدون حواجز عامة للمحتوى البالغ القانوني.
الطلب الأول
يحاكي الطلب الأساسي نقطة النهاية الخاصة بـ chat-completions في OpenAI. تحدد النموذج، والرسائل، والمعلمات الاختيارية. تُرجع واجهة برمجة التطبيقات استجابة نصية. إذا لم تحدد max_tokens، فإن حد الإخراج الافتراضي هو 2,048 رمزًا. تدعم نافذة السياق ما مجموعه 100,000 رمز للموجّه والإكمال معًا.
يوضح المثال التالي طلب إكمال نصي قياسي باستخدام curl.
curl https://api.nsfwchatbot.cc/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."}]
}'هذا يعيد كائن JSON يحتوي على النص المولد. تعيد الأخطاء رموز حالة HTTP القياسية مع كائن خطأ في الجسم.
مكتبة Python SDK
استخدم مكتبة Python الرسمية لـ OpenAI، وقم بإعدادها للإشارة إلى URL الأساسي الخاص بنا. هذا يتيح لك الاستفادة من كود العميل الموجود مع تغييرات قليلة. مرر مفتاح API الخاص بك كـ api_key واضبط base_url على نقطة النهاية الخاصة بنا. يبقى اسم النموذج uncensored.
مثال على التهيئة واستدعاء الإكمال:
from openai import OpenAI
client = OpenAI(base_url="https://api.nsfwchatbot.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)هذا النهج يعمل لتوليد النصوص البسيطة أو بناء السلاسل. تذكر أن النموذج ليس GPT-4؛ عدّل هندسة الموجّه الخاصة بك وفقاً لذلك. البث المتدفق مدعوم عبر المعامل stream=True، والمفصل في القسم التالي.
مكتبة Node SDK
تتبع مكتبة Node.js OpenAI نفس نمط التهيئة. استورد المكتبة، اضبط URL الأساسي ومفتاح API، واستدعِ نقطة النهاية للإكمال. هذا مثالي لتكاملات جانب الخادم أو تطبيقات الدردشة القائمة على Node.
مثال على التهيئة:
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.nsfwchatbot.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);يحتوي كائن الاستجابة على المحتوى المولد في response.choices[0].message.content. تأكد من معالجة الأخطاء بشكل مناسب، حيث ستؤدي مشكلات الشبكة أو المفاتيح غير الصالحة إلى طرح استثناءات. يستجيب النموذج بدون رقابة للموجهات النظامية القياسية، مما يتيح لك تحديد النبرة والسلوك عبر سجل الرسائل.
الاستجابات المتدفقة
فعّل البث المتدفق عن طريق تعيين stream: true في طلبك. يعيد API دفق أحداث المخدم المرسلة (SSE). يحتوي كل قطعة على نص جزئي. تتضمن القطعة الأخيرة إحصائيات استخدام الرموز (token). يقلل البث المتدفق من زمن الاستجابة المدرك للمستخدمين في تطبيقات روبوت الدردشة NSFW.
مثال على طلب البث المتدفق:
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)عالج الدفق بإضافة محتوى كل قطعة إلى المخزن المؤقت الخاص بك. راقب القطعة الأخيرة لبيانات الاستخدام لتتبع التكاليف. تسعير الرموز (token) هو $0.25 لكل مليون رمز (token) مدخل و$1.00 لكل مليون رمز (token) مخرج. الأخطاء والرفضات لا تتكبد تكاليف.
الحدود، الأخطاء ونافذة السياق
يتيح كل مفتاح API 300 طلب في الدقيقة و8 طلبات متزامنة. يجب أن يكون جسم الطلب أقل من 8 MB. إذا كان المفتاح غير صالح، تتلقى خطأ 401. يشير خطأ 402 إلى عدم كفاية الرصيد. يشير خطأ 429 إلى تجاوز حدّ المعدل. نافذة السياق هي 100,000 رمز (token) إجمالاً. الحد الأقصى للإخراج هو 32,000 رمز (token) إذا تم تحديده. المحتوى الذي يتضمن قاصرين يتم رفضه دائماً. الرصيد مسبق الدفع عبر العملات المشفرة ولا ينتهي صلاحيته. استخدم هذه الحدود لتصميم منطق إعادة المحاكمة وإدارة الطوابير لتكامل API للذكاء الاصطناعي بدون رقابة الخاص بك.
