المتطلبات الأساسية وURL الأساسي
لبدء استخدام واجهة برمجة NSFW Wan، تحتاج إلى مفتاح API. سجّل عبر Google أو البريد الإلكتروني في صفحة الحصول على مفتاح API لتلقي مفتاحك على الفور. لا يلزم رقم الهاتف. تُستضاف واجهة برمجة التطبيقات على https://api.nsfwwan.cc/v1. يعمل هذا العنوان الأساسي مع أي واجهة برمجة تطبيقات قياسية لـ OpenAI أو عميل HTTP عن طريق تحديث تكوين base_url.
- معرف النموذج: أرسل الطلبات إلى النموذج المسمى
uncensored. - التوافق: تتبع الواجهة بنية نقطة النهاية القياسية
/v1/chat/completions. - المتطلبات: تحتاج فقط إلى عنوان بريد إلكتروني للحساب؛ لا تُستخدم الموجّهات للتدريب.
المصادقة باستخدام مفتاح API
أدرج مفتاح API الخاص بك في رأس Authorization لكل طلب. الصيغة هي Bearer YOUR_API_KEY. إذا كان المفتاح غير صالح، تُعيد واجهة برمجة التطبيقات خطأ 401. على عكس بعض الخدمات، لا ينتهي رصيد مسبق الدفع لدينا، لذا سيظل المفتاح النشط الذي يحتوي على رصيد كافٍ ساري المفعول إلى الأبد حتى تختار إلغاء صلاحيته.
يتيح حسابك مفتاحًا نشطًا واحدًا في كل مرة؛ يؤدي إنشاء مفتاح جديد إلى استبدال المفتاح القديم. تأكد من تخزين مفتاحك بأمان، حيث يوفر وصولاً مباشرًا إلى رصيد مسبق الدفع الخاص بك.
طلب إكمال الدردشة الأساسي
أرسل طلب إكمال دردشة قياسي لتوليد النص. تقبل واجهة برمجة التطبيقات المعلمات القياسية مثل temperature، top_p، وstop. النموذج غير خاضع للرقابة، مما يعني أنه سيجيب على المواضيع القانونية للبالغين، أو الخيالية، أو المثيرة للجدل دون رفض، باستثناء المحتوى الذي يتضمن قاصرين والذي يتم حظره دائمًا.
يوضح أدناه مثالًا أساسيًا باستخدام cURL لتوليد مقتطف نصي لخط أنابيب فيديو NSFW Wan.
curl https://api.nsfwwan.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 يحتوي على النص المُولّد. الأخطاء والرفض مجانيان، ولكن قد لا يتم احتساب أخطاء الشبكة أثناء النقل دائمًا اعتمادًا على وضع الفشل المحدد.
استجابات البث المتدفق (SSE)
للحصول على مخرجات في الوقت الفعلي، استخدم أحداث الإرسال من الخادم (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)استخدم هذه الطريقة عند بناء مولدات الموجّهات الديناميكية أو مستخرجي البيانات الوصفية في الوقت الفعلي لخطوط أنابيب NSFW Wan الخاصة بك.
استدعاء الدوال ووضع JSON
الإخراج الهيكلي أمر حاسم لأتمتة خطوط الأنابيب. استخدم response_format: {"type": "json_object"} لإجبار النموذج على إرجاع JSON صالح. هذا مثالي لاستخراج البيانات الوصفية، أو توليد نصوص هيكلية، أو تمرير البيانات بين مراحل الوسائط.
يمكنك أيضًا استخدام استدعاء الدوال (الأدوات) للسماح للنموذج بقرار أي دالة يجب استدعاؤها بناءً على الإدخال. هذا مفيد لاتخاذ القرارات المعقدة في سير عمل NSFW Wan الخاص بك، مثل تحديد نمط التسمية التوضيحية المناسب أو طول النص بناءً على وصف الفيديو الذي تقدمه.
حدّ المعدل والمعاملات
يتم تحديد كل مفتاح API بحد أقصى 300 طلب في الدقيقة و8 طلبات متزامنة. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. نافذة السياق هي 100,000 رمز، بدون حد منفصل للمخرجات (إذا لم يتم تعيين max_tokens، يمكن أن يمتد الرد إلى نهاية النافذة).
رموز الأخطاء:
401: مفتاح API غير صالح.402: رصيد غير كافٍ.429: تم تجاوز حدّ المعدل.
إذا واجهت شحنًا مزدوجًا بسبب خطأ، اتصل بالدعم. يتم إصلاح الأخطاء عبر صفحة الدعم؛ لا يتم استرداد الرصيد تلقائيًا ولكن يتم تعديله يدويًا.
Python
from openai import OpenAI
client = OpenAI(base_url="https://api.nsfwwan.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.nsfwwan.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);