مُحدّث في أغسطس 2026 · دليل تكامل API

دليل 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. 1
    Create a ChinaModelAPI account

    سجّل في chinamodelapi.com — لا يلزم وجود بطاقة ائتمان.

  2. 2
    Purchase tokens with USDT

    خطة Starter بسعر $9.9 كافية للاختبار. والرموز (Tokens) لا تنتهي صلاحيتها أبداً.

  3. 3
    Copy your API key

    مفتاحك من لوحة التحكم يعمل عبر جميع نماذج Qwen.

  4. 4
    Change base_url in your SDK

    سطر برمجي واحد — راجع الأمثلة أدناه.

تكامل Python: واجهة Qwen API

تثبيت مكتبة OpenAI Python SDK: pip install openai

qwen_basic.py
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):

qwen_streaming.py
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

qwen.js
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 دقائق.

احصل على وصول مبكر