واجهة برمجة التطبيقات Qwen: أول طلب في خمس دقائق

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

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

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

إرسال أول طلب

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

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

إذا نجح الطلب، ستتلقى استجابة JSON تحتوي على النص المُولّد. إذا تلقيت خطأ 401، فتأكد من صحة مفتاحك. يشير خطأ 402 إلى استنفاد رصيدك المسبق الدفع.

تكامل حزمة SDK لـ Python

بالنسبة لمطوّري Python، يعمل SDK الرسمي لـ OpenAI مباشرة مع نقطة النهاية الخاصة بنا. ثبّت المكتبة باستخدام pip، ثم قم بإعداد العميل للإشارة إلى عنوان URL الأساسي الخاص بنا. يتيح لك ذلك استخدام الأساليب المألوفة مثل chat.completions.create() دون تغيير منطق التطبيق الخاص بك بشكل كبير. يتولى SDK التعامل مع تسلسل JSON ومنطق إعادة المحاولة لك.

Copyfrom openai import OpenAI

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

تذكر ضبط api_key و base_url بشكل صحيح. يبقى اسم النموذج uncensored. يضمن هذا النهج التوافق مع الأكواد المكتوبة لمزودين آخرين، مما يسهل التبديل أو اختبار نقاط النهاية المختلفة.

استخدام حزمة SDK لـ Node.js

يمكن لمطوّري Node.js استخدام @anthropic-ai/sdk أو حزمة npm الرسمية openai. قم بإعداد العميل بعنوان URL الأساسي الخاص بنا ومفتاح API الخاص بك. هيكل الطلب مطابق لخدمات متوافقة مع OpenAI الأخرى. يتيح لك ذلك دمج Qwen بدون رقابة في تطبيقات Node.js الحالية مع الحد الأدنى من تغييرات الكود.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.qwenapis.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 على true في طلبك. سيوفر لك 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)

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

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

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