دليل Qwen API: التكامل مع Python & Node.js خارج الصين
ينافس نموذج Qwen3.8 من Alibaba نموذج GPT-5.6 Sol في مؤشر الذكاء الاصطناعي Artificial Analysis، ويدعم سياقاً يصل إلى 1 مليون رمز (token). يوضح هذا الدليل كيفية الوصول إلى Qwen API عالمياً عبر نقطة نهاية ChinaModelAPI المتوافقة مع OpenAI — مع أمثلة برمجية عملية بلغات Python و Node.js.
from openai import OpenAI
client = OpenAI(api_key="YOUR_KEY", base_url="https://api.chinamodelapi.com/v1")
print(client.chat.completions.create(
model="qwen-plus",
messages=[{"role":"user","content":"ping"}],
).choices[0].message.content)
ما هي Qwen API؟
تُعد Qwen API واجهة المطورين المقدمة من Alibaba Cloud لسلسلة نماذج اللغة الكبيرة Qwen (通义千问). وتتبع API تنسيق إكمال المحادثات الخاص بـ OpenAI، مما يجعلها بديلاً مباشراً للمطورين الذين يستخدمون نماذج GPT بالفعل.
أبرز حقائق Qwen API:
- • متوافقة مع OpenAI — نفس تنسيق الطلب/الاستجابة الخاص بـ GPT
- • نافذة سياق Qwen-Max — تصل إلى 1,000,000 رمز (tokens)
- • اللغات — متعددة اللغات (+100)، وتتفوق في الصينية-الإنجليزية
- • مؤشر الذكاء AA — الفئة الأولى للنماذج مفتوحة الأوزان، ومنافسة لـ GPT-5.6 Sol
- • يدعم — الدردشة، واستدعاء الدوال (function calling)، والبث المباشر (streaming)، والرؤية (Qwen-VL)
نماذج Qwen: أي منها يجب استخدامه؟
| معرف النموذج | الاستخدام الأنسب | السياق | السرعة | التكلفة |
|---|---|---|---|---|
| qwen-3 | المهام العامة، وأحدث أداء | 128K | سريع | $$ |
| qwen-max | المستندات الطويلة، والاستدلال المعقد | 1M | متوسطة | $$$ |
| qwen-plus | متوازن: السرعة + الجودة | 128K | سريع | $$ |
| qwen-2.5 | أحمال العمل الإنتاجية المستقرة | 128K | سريع | $ |
| qwen-2.5-coder | توليد الأكواد البرمجية & إكمالها | 128K | سريع | $ |
كيفية الوصول إلى Qwen API خارج الصين: 4 خطوات
-
1
Create a ChinaModelAPI account
سجّل في chinamodelapi.com — لا يلزم وجود بطاقة ائتمان.
-
2
Purchase tokens with USDT
خطة Starter بسعر $9.9 كافية للاختبار. والرموز (Tokens) لا تنتهي صلاحيتها أبداً.
-
3
Copy your API key
مفتاحك من لوحة التحكم يعمل عبر جميع نماذج Qwen.
-
4
Change base_url in your SDK
سطر برمجي واحد — راجع الأمثلة أدناه.
تكامل Python: واجهة Qwen API
تثبيت مكتبة OpenAI Python SDK: pip install openai
from openai import OpenAI
client = OpenAI(
base_url="https://api.chinamodelapi.com/v1",
api_key="your-chinamodelapi-key"
)
response = client.chat.completions.create(
model="qwen-3", # or qwen-max, qwen-plus, qwen-2.5
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Explain transformer architecture in 3 sentences."}
],
max_tokens=1024
)
print(response.choices[0].message.content)
للحصول على استجابات متدفقة (Streaming):
stream = client.chat.completions.create(
model="qwen-max",
messages=[{"role": "user", "content": "Write a Python function for binary search."}],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
تكامل Node.js: واجهة Qwen API
التثبيت: npm install openai
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.chinamodelapi.com/v1",
apiKey: "your-chinamodelapi-key"
});
const response = await client.chat.completions.create({
model: "qwen-3", // or "qwen-max", "qwen-plus"
messages: [
{ role: "user", content: "Translate this to Chinese: Hello, world!" }
]
});
console.log(response.choices[0].message.content);
الأسئلة الشائعة
هل يمكنني استخدام Qwen API مجاناً؟
لا تقدم ChinaModelAPI باقة مجانية، لكن خطة Starter بسعر $9.9 توفر قدراً كبيراً من الرموز للاختبار والمشاريع الصغيرة. الرموز لا تنتهي صلاحيتها أبداً، لذلك لا يوجد أي ضغط زمني لاستنفادها.
هل تدعم Qwen API استدعاء الدوال (function calling)؟
نعم. يدعم كلا النموذجين Qwen3.8 و Qwen-Max استدعاء الدوال المتوافق مع OpenAI (استخدام الأدوات). تنسيق الطلب مطابق تماماً لتنسيق OpenAI — ما عليك سوى تحديد أدواتك في المعامل tools وسيقوم النموذج بإرجاع استدعاءات دوال مهيكلة.
ما هو حجم نافذة السياق في Qwen-Max؟
يدعم Qwen-Max سياقاً يصل إلى 1,000,000 رمز (tokens) — ما يعادل تقريباً 750,000 كلمة أو كتاباً كاملاً. وتُعد هذه واحدة من أكبر نوافذ السياق المتاحة، مما يجعلها مثالية لتحليل المستندات الطويلة، أو قواعد الأكواد، أو الأوراق البحثية.
هل يوجد حد لمعدل الاستخدام (Rate Limit) في Qwen API؟
تعتمد حدود معدل الاستخدام على باقة اشتراكك. تتضمن باقة Starter حدوداً أساسية مناسبة للتطوير، بينما توفر باقة Pro وما فوقها سرعة معالجة وإنتاجية أعلى. تشمل باقات Enterprise حدوداً مخصصة لمعدل الاستخدام مع ضمانات اتفاقية مستوى الخدمة (SLA). تواصل معنا للحصول على أرقام محددة.
أدلة ذات صلة
هل أنت مستعد لاستخدام Qwen API؟ احصل على الوصول في أقل من 5 دقائق.
احصل على وصول مبكر