AR ▾
احصل على مفتاح API

البدء السريع لخطوط أنابيب NSFW Wan

دمج واجهة برمجة النص غير الخاضعة للرقابة في خطوط أنابيب الوسائط NSFW Wan باستخدام دليل البدء السريع هذا. استخدم نقاط النهاية المتوافقة مع OpenAI لتوليد الموجّهات، النصوص، أو البيانات الوصفية لعمليات الفيديو والصور الخاصة بك.

المتطلبات الأساسية و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);

مواصفات API

كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.

البندالقيمة
صيغة APIمتوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط
Base URLhttps://api.nsfwwan.cc/v1
نقاط النهايةPOST /v1/chat/completions · GET /v1/models
المصادقةAuthorization: Bearer YOUR_KEY
معرّف النموذجuncensored
استدعاء الدوالنعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool
نافذة السياق100,000 رمز (المدخلات والمخرجات معاً)
البث المتدفقنعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز
أقصى مخرجاتحتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل)
وضع JSONresponse_format: {"type": "json_object"}
المعاملاتtemperature, top_p, stop, seed, presence_penalty, frequency_penalty
الطلبات المتزامنةحتى 8 في الوقت نفسه لكل مفتاح
ترويسات الردX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
حجم الطلبحتى 8 MB
حدّ المعدل300 طلب في الدقيقة لكل مفتاح
السعر$0.15 لكل مليون رمز مدخلات · $0.50 لكل مليون رمز مخرجات
مكافأة+5% من $50، +10% من $100، +15% من $200
شحن الرصيدUSDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $20 إلى $500
الفوترةرصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية
رصيد تجريبي مجاني$0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن
الصلاحيةالرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك
المفاتيحمفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم
تسجيل الدخولGoogle أو البريد الإلكتروني وكلمة المرور
المحتوىمحتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين

رموز الأخطاء

تصل الأخطاء بصيغة JSON مع type ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.

الرمزالنوعالمعنى
400bad_requestJSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق
401missing_key · invalid_key · key_revokedلا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله
402no_creditالرصيد فارغ — اشحن وتستأنف الطلبات فوراً
403content_blockedمحتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب
404not_foundنقطة نهاية غير معروفة
413request_too_largeجسم الطلب أكبر من 8 MB
429rate_limited · concurrencyتجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة
503upstream_busyالنموذج مشغول — أعد المحاولة بعد ثوانٍ

أسئلة وأجوبة

هل تنتهي صلاحية مفتاح API؟

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

هل يتم احتساب الأخطاء في الفاتورة؟

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

ما هو الحد الأقصى لطول المخرجات؟

لا يوجد حد أقصى منفصل للمخرجات. إذا لم تقم بتعيين المعلمة max_tokens، يمكن أن يمتد الرد إلى نهاية نافذة السياق. إجمالي نافذة السياق (الإدخال + المخرجات) هو 100,000 رمز.

مفتاحك على بُعد نموذج واحد

أنشئ حسابًا، انسخ المفتاح، غيّر URL الأساسي. هذا هو الإعداد الكامل.

احصل على مفتاح API