وثائق واجهة برمجة تطبيقات Qwen: دليل البدء السريع

ثبّت OpenAI SDK القياسي

ابدأ بتثبيت حزمة OpenAI الرسمية للغة المفضلة لديك. يضمن ذلك التوافق مع نقطة النهاية الخاصة بنا المتوافقة مع OpenAI دون الحاجة إلى أغطية مخصصة. يمكنك استخدام pip لـ Python أو npm لـ Node.js لإضافة المكتبات اللازمة إلى بيئة مشروعك.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

تكوين عنوان URL الأساسي والمفتاح

وجّه عميل SDK الخاص بك إلى عنوان URL الأساسي المحدد وقدم مفتاح API الخاص بك. يوجه هذا جميع الطلبات إلى نموذجنا غير الخاضع للرقابة بدلاً من خوادم OpenAI الافتراضية. عنوان URL الأساسي هو HTTPS://api.qwenapidocs.com/v1 ويمكنك الحصول على مفتاحك من لوحة التحكم.

Copycurl https://api.qwenapidocs.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the current pricing tiers for the qwen endpoint"}]
  }'

أرسل طلبك الأول غير الخاضع للرقابة

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

Copyfrom openai import OpenAI

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

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

تمكين التدفق لتلقي الرموز أثناء توليدها، مما يقلل من زمن الاستجابة المُدرَك للمخرجات الطويلة. تعيد مكتبة SDK كتلًا من النص عندما تصبح متاحة، مما يسمح بالعرض الفوري في تطبيقك. تحتوي الكتلة الأخيرة على إجمالي استخدام الرمز للفوترة.

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)

تمكين استدعاء الأدوات ووضع JSON

استخدم تنسيق استدعاء الوظائف القياسي أو فرض إخراج JSON لاستخراج البيانات المهيكلة. تدعم واجهة برمجة التطبيقات الخاصة بنا تعريفات الأدوات ومعامل response_format تماماً مثل معيار OpenAI. هذا يسمح لك بدمج النموذج غير الخاضع للرقابة في سير عمل الوكلاء المعقدة دون الحاجة إلى منطق تحليل مخصص.

مراقبة استخدام الرموز والحدود

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