دليل البدء السريع لـ Wu Xianzhi API

نقطة النهاية الأساسية للـ API والمصادقة

Wu Xianzhi API متوافق تماماً مع واجهة OpenAI القياسية. يتم إرسال جميع الطلبات إلى https://api.wuxianzhiapi.com/v1. تحتاج إلى مفتاح API للمصادقة، ضعه في رأس الطلب Authorization: Bearer YOUR_API_KEY. يتم إنشاء المفتاح فوراً بعد التسجيل، ويدعم إعادة التوليد لإلغاء صلاحية المفتاح القديم. نعتمد وضع الدفع المسبق، الرصيد لا ينتهي، الدفع حسب الاستخدام، بدون رسوم اشتراك.

إرسال الطلب الأول

باستخدام curl يمكنك التحقق من اتصال API مباشرة. أرسل طلب POST إلى /v1/chat/completions، وحدد معرف النموذج كـ uncensored. هذا النموذج مستقل مفتوح الأوزان، تم تحسينه لإزالة الرقابة عن المحتوى البالغ القانوني والمواضيع المثيرة، ولا يرفض توليد المحتوى.

تأكد من أن جسم الطلب يحتوي على مصفوفة messages. إذا فشلت المصادقة سيتم إرجاع 401، وإذا كان الرصيد غير كافٍ سيتم إرجاع 402.

复制curl https://api.wuxianzhiapi.com/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."}]
  }'

مثال استدعاء SDK Python

لمطوري Python، استخدم مكتبة openai الرسمية مباشرة. فقط عدل base_url ليشير إلى خادمنا، وأدخل مفتاح API الصحيح. معرف النموذج ثابت كـ uncensored. ملاحظة، ندعم توليد النصوص فقط، ولا نقدم قدرات التضمين أو متعددة الوسائط. هذا الأسلوب يناسب تكامل خدمات الخلفية، ويتعامل بسهولة مع تفاعلات البيانات الهيكلية.

复制from openai import OpenAI

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

تكامل SDK Node.js

يمكن لمطوري Node.js أيضاً استخدام حزمة npm openai للتكامل. بعد تكوين baseURL و apiKey، يكون منطق الاستدعاء مطابقاً لـ OpenAI. يدعم هذا LLM API استدعاء الدوال، يمكنك تعريف الدوال عبر معلمة tools، وسيعيد النموذج JSON هيكلياً للتنفيذ. هذا يجعله خلفية مثالية لتطبيقات AI غير المقيدة.

复制import OpenAI from "openai";

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

الاستجابة المتدفقة (SSE)

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

复制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)

القيود ومعالجة الأخطاء ونافذة السياق

يُحدّد كل مفتاح API بحدّ 300 طلب/دقيقة، مع حدّ أقصى لحجم الطلب 8 MB. نافذة السياق 100,000 رمز (تشمل الموجّه والرد). أكواد الأخطاء: 401 يعني المفتاح غير صالح، 402 يعني رصيد غير كافٍ، 429 يعني تجاوز حدّ المعدل. النموذج يطبق حجبًا صارمًا على المحتوى الجنسي للقاصرين، بينما يبقى المحتوى الجنسي البالغ الآخر غير خاضع للرقابة. احصل على قائمة النماذج عبر GET /v1/models.