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

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

ابدأ بإنشاء مفتاح API الخاص بك على لوحة التحكم. عنوان URL الأساسي هو https://api.qwenaiapi.com/v1 وتمرير مفتاحك في Authorization الرأس. يعمل هذا التكوين مع أي عميل SDK قياسي لـ OpenAI دون تغييرات في الكود. تتلقى مفتاحًا نشطًا واحدًا لكل حساب؛ يؤدي توليد مفتاح جديد إلى إبطال المفتاح السابق على الفور. لا يتطلب التسجيل رقم هاتف.

الطلب الأول

أرسل طلب POST إلى /v1/chat/completions مع المفتاح الخاص بك ومع معرف النموذج. مُعرّف النموذج هو uncensored ويستجيب لرسائل الدردشة القياسية. يمكنك اختبار الاتصال باستخدام موجه نظام بسيط للتحقق من زمن الاستجابة وتنسيق الإجابة. الأخطاء مثل 401 تشير إلى مفتاح غير صالح، بينما 402 تعني أن رصيدك المدفوع مسبقاً قد استنفد.

Copycurl https://api.qwenaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this pull request diff"}]
  }'

تكامل واجهة برمجة تطبيقات Python

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.qwenaiapi.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 بعنوان URL الأساسي والمفتاح. تدعم الحزمة طلبات إكمال المحادثة القياسية. يمكنك تكوين معرف النموذج للتأكد من أنك تصل إلى نقطة النهاية غير الخاضعة للرقابة. هذا التكامل مثالي لتطبيقات الخادم التي تحتاج إلى وصول برمجي. تدير مكتبة SDK ربط الاتصالات بكفاءة للطلبات عالية الحجم.

Copyimport OpenAI from "openai";

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

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

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

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)

حدود نافذة السياق

يدعم النموذج نافذة سياق بحجم 100,000 رمز مدمج للسياق (prompt) والإكمال (completion). يمكنك إرسال ما يصل إلى 16,000 رمز للإخراج لكل طلب. تسمح حدود معدل الاستخدام بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. يتم تقييد أحجام طلبات الجسم بـ 8 ميجابايت. يساعد فهم هذه الحدود على تجميع الطلبات بفعالية دون تجاوز حدود معدل الاستخدام (أخطاء 429). لا تستهلك الأخطاء رصيدك المدفوع مسبقاً.