توثيق واجهة برمجة التطبيقات Qwen nsfw

الإعداد والتثبيت

ابدأ بتثبيت حزمة SDK المفضلة لديك وتعيين متغيرين للبيئة. تحتاج إلى مفتاح API من لوحة التحكم وعنوان URL الأساسي للخدمة.

• URL الأساسي: https://api.nsfwqwen.com/v1
• معرف النموذج: uncensored

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

المصادقة

مرر مفتاح API الخاص بك في الـ Authorization رأس باستخدام Bearer scheme. يجب أن يتضمن كل طلب هذا الرأس للمصادقة مع الخادم.

• اسم الرأس: Authorization
• قيمة الرأس: Bearer YOUR_API_KEY

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

نقطة نهاية إكمال الدردشة

أرسل تلميحك إلى /v1/chat/completions نقطة النهاية باستخدام طلب POST. يُرجع النموذج نصاً بناءً على مدخلاتك دون تصفية المحتوى القانوني للبالغين.

Copycurl https://api.nsfwqwen.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current version number?"}]
  }'

يحتوي الرد على النص المُولّد في choices مصفوفة. يمكنك ضبط نافذة السياق حتى 100,000 رمز مميز للمجموع المشترك بين التلميح والإكمال. يسمح هذا بالمحادثات الطويلة أو معالجة المستندات الكبيرة دون فقدان السياق الفوري.

استجابات البث

فعّل البث عن طريق تعيين stream: true في طلبك. يرسل الخادم الرموز مع توليدها عبر أحداث خادم المراسلة (SSE). هذا مثالي لواجهات المستخدم في الوقت الفعلي.

Copyfrom openai import OpenAI

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

يحتوي كل جزء على نص جزئي. يمكنك تراكم هذه الأجزاء لعرض الاستجابة الكاملة للمستخدم. يتضمن الجزء الأخير أيضًا إجمالي استخدام الرموز لأغراض الفوترة.

المعاملات والإعدادات

تحكم في سلوك النموذج باستخدام المعاملات القياسية مثل temperature, top_p، و stop. استخدم response_format مع json_object للمخرجات المُهيّأة.

Copyimport OpenAI from "openai";

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

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

معالجة الأخطاء

عالج الأخطاء بسلاسة من خلال التحقق من رمز حالة HTTP. يعني خطأ 401 أن مفتاح API الخاص بك غير صالح. يشير خطأ 402 إلى عدم كفاية الرصيد في حسابك.

Copystream = 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)

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