البدء السريع لمستخدمي Qwen

المصادقة وعنوان URL الأساسي

تستخدم واجهة API لدينا مصادقة الرمز المميز Bearer القياسية. تتلقى مفتاحك فوراً بعد إنشاء الحساب عبر Google أو البريد الإلكتروني. احفظ هذا المفتاح بأمان؛ فهو يمنحك الوصول إلى رصيدك المسبق الدفع. عنوان URL الأساسي لجميع الطلبات هو https://api.qwenapi.cc/v1. حدّث تكوين عميلك ليشير إلى نقطة النهاية هذه بدلاً من عنوان URL الافتراضي لـ OpenAI.

تتم معالجة المصادقة عن طريق تمرير رأس Authorization مع كل طلب. بدون مفتاح API، لا يمكن للنموذج التحقق من رصيد حسابك، مما يؤدي إلى خطأ 401. لا توجد رؤوس مخفية أو مخططات مصادقة مخصصة مطلوبة.

الطلب الأول

أرسل طلب إكمال دردشة قياسي لاختبار الاتصال. استبدل YOUR_API_KEY بمفتاحك الفعلي. تقبل نقطة النهاية حمولات JSON القياسية مع حقول model، وmessages، وcontent.

• معرف النموذج: uncensored
• نقطة النهاية: POST /v1/chat/completions
• التنسيق: JSON

سيستهلك هذا الطلب رموز الإدخال من رصيدك. تأكد من أن عميلك يتعامل مع استجابة JSON بشكل صحيح للتحقق من أن الاتصال يعمل.

تكامل SDK لـ Python

استخدم مكتبة Python الرسمية لـ OpenAI. يتطلب تكوينًا بسيطًا لتوجيه حركة المرور إلى نقطة النهاية الخاصة بنا. قم بتهيئة العميل بمفتاحك وعنوان URL الأساسي الصحيح. يستفيد هذا النهج من قواعد الشفرة الموجودة دون إعادة كتابة منطق الطلب.

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

تكامل SDK لـ Node.js

لبيئات JavaScript أو TypeScript، استخدم @anthropic-ai/sdk أو حزمة Node القياسية من OpenAI. قم بتكوين عنوان URL الأساسي للإشارة إلى واجهة API لدينا. يتيح لك ذلك دمج خدمتنا في تطبيقات Node القائمة دون إعادة هيكلة كبيرة.

تأكد من استخدام إصدار حديث من SDK يدعم عناوين URL الأساسية المخصصة. مرر معرف النموذج uncensored لتحديد النموذج بدون الرقابة. يعمل هذا الإعداد بسلاسة مع مسارات Express أو الوظائف الخالية من الخوادم.

استجابات البث المتدفق

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

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

الحدود والأخطاء والسياق

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

تُرجع أخطاء المصادقة خطأ 401، مما يشير إلى مفتاح غير صالح أو مفقود. تُرجع أخطاء الرصيد خطأ 402، مما يعني استنفاد رصيدك المسبق الدفع. تدعم نافذة السياق 100,000 رمز إجمالاً، مع حد أقصى للإخراج يبلغ 32,000 رمز لكل طلب. لا تستهلك الأخطاء والرفض رصيدك.

cURL

Copycurl https://api.qwenapi.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."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

البث المتدفق

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)