البدء السريع لواجهة Wu Shencha API

التكوين الأساسي

توفر واجهة Wu Shencha API واجهة قياسية متوافقة مع OpenAI. تحتاج إلى ضبط عنوان URL الأساسي ومفتاح API في الكود الخاص بك. عنوان URL الأساسي ثابت وهو https://api.wushenchaapi.com/v1. معرف النموذج هو uncensored، وهو نموذج مفتوح الأوزان تم ضبطه خصيصًا لمواقف بدون رقابة ويدعم المحتوى البالغ القانوني.

يظهر المفتاح في صفحة "الحصول على مفتاح API" بعد التسجيل. نظرًا لأن واجهة API متوافقة مع OpenAI، يمكنك الاتصال مباشرة عن طريق تعديل معلمة base_url في مكتبات SDK الرسمية. لا توجد حاجة لإعادة توجيه إضافية أو إعدادات معقدة.

إكمال المحادثة

أرسل طلبات نصية باستخدام نقطة النهاية POST /v1/chat/completions. تقبل هذه الواجهة تنسيق الرسائل القياسي وتعيد النص المُولّد. إنها طريقة التفاعل الأساسية المناسبة لمعظم سيناريوهات توليد النصوص.

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

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

مكتبة Python SDK

لمطوري Python، يمكنك استخدام مكتبة SDK الرسمية openai. ما عليك سوى توجيه base_url إلى نقطة نهاية واجهة Wu Shencha API وإدخال مفتاح API الخاص بك. تحافظ هذه الطريقة على التوافق مع الكود الأصلي لـ OpenAI، مما يسهل الانتقال.

تأكد من تثبيت أحدث إصدار من المكتبة. يوضح مثال الكود كيفية تهيئة العميل وإرسال الرسائل. هذه الطريقة موجزة وفعالة ومناسبة لتطوير النماذج الأولية السريعة.

复制from openai import OpenAI

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

مكتبة Node SDK

يمكن لمطوّري Node.js أيضًا الاتصال باستخدام حزمة npm openai. يتم التكوين بطريقة مشابهة لـ Python، حيث يتم ضبط baseURL و apiKey. يضمن ذلك اتساقًا عبر اللغات ويقلل من تكلفة التعلم.

يدعم الطلبات غير المتزامنة ومعالجة الأخطاء. يمكنك دمجه بسهولة في تطبيقات Node.js الحالية. انتبه لمعالجة استدعاءات غير المتزامنة أو الوعود (Promises) لتجنب الحظر.

复制import OpenAI from "openai";

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

البث المتدفق

يدعم البث المتدفق عبر أحداث Server-Sent Events (SSE). عند ضبط المعلمة stream: true، سترسل الواجهة استجابةً على شكل كتل. هذا مفيد جدًا للتطبيقات في الوقت الفعلي أو توليد النصوص الطويلة، حيث يوفر تجربة زمنيّة منخفضة.

لا يغير الاستجابة المتدفقة سلوك النموذج، بل يغير فقط طريقة نقل البيانات. يمكنك اختيار وضع البث المتدفق أو الوضع غير المتدفق حسب الحاجة.

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

القيود والحصص

حدّ المعدل هو 300 طلب في الدقيقة. نافذة السياق هي 100,000 رمز (token) (بما في ذلك الموجّه والإكمال). إذا تجاوزت الحد، ستعيد واجهة API خطأ 429. تُعاد 401 عند عدم صلاحية المفتاح، و402 عند عدم كفاية الرصيد.

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