Qwen 3.7 Plus هو نموذج وكيل علي بابا متعدد الوسائط: يتضمن النصوص والصور والفيديو، ويدعم سياق 1 مليون توكن، وبسعر اقتصادي. وبما أنه يُشحن كواجهة برمجة تطبيقات (API) فقط، تبرز الأسئلة العملية فورًا. كيف أحصل على مفتاح، كيف أرسل صورة، وما هي التكلفة؟ يجيب هذا الدليل على كل هذه الأسئلة الثلاثة.
سنغطي الوصول، وكيفية الحصول على مفتاح، وطلبك الأول بلغات Python وCurl وJavaScript، وتنسيق حمولة البيانات متعددة الوسائط، وتفاصيل التسعير الكاملة مع أمثلة للتكاليف المحسوبة، وحدود المعدل. على طول الطريق، ستستخدم Apidog لإرسال طلبات الاختبار، وفحص الاستجابات الأولية، ومحاكاة نقطة النهاية حتى يستمر تطبيقك في البناء. إذا كنت تريد معرفة الإمكانيات والمعايير أولاً، ابدأ بنظرتنا العامة على Qwen 3.7 Plus؛ وللإصدار الرائد المعتمد على النصوص فقط، راجع دليل واجهة برمجة تطبيقات Qwen 3.7 الأساسية.
باختصار
يعمل Qwen 3.7 Plus عبر Alibaba Cloud Model Studio على نقطة نهاية متوافقة مع OpenAI. تقوم بتعيين عنوان URL أساسي للمنطقة، وتمرر مفتاحك كرمز Bearer، وتستدعي /chat/completions باستخدام معرف النموذج qwen3.7-plus. تضيف الطلبات متعددة الوسائط أجزاء الصور أو الفيديو إلى محتوى الرسالة. التسعير هو 0.40 دولار لكل مليون رمز إدخال و 1.60 دولار لكل مليون رمز إخراج، مع إدخال مخزّن مؤقتًا بسعر 0.08 دولار، أي أرخص بحوالي ست مرات من Qwen 3.7-Max. لا توجد طبقة مجانية دائمة، على الرغم من أن الحسابات الجديدة تحصل على حصة مجانية لمرة واحدة. تشارك رموز الرؤية ميزانية السياق، لذا فإن الصور والفيديو تزيد فاتورتك. تأكد من معرف النموذج الدقيق في وثائق Model Studio قبل النشر.
كيفية الوصول إلى Qwen 3.7 Plus
على عكس النموذج الرائد المعتمد على النصوص، الذي قضى أيامه الأولى خلف معاينة للدردشة فقط، فإن Plus هو واجهة برمجة تطبيقات تجارية منذ اليوم الأول. سطحان مهمان:
دردشة Qwen (chat.qwen.ai). أسرع طريقة لتجربة Plus مع صورة. سجّل الدخول، واختر نموذج Plus، وأسقط لقطة شاشة، وشاهد كيف تتفاعل. إنه للتقييم، وليس للتكامل.
Alibaba Cloud Model Studio (DashScope). هذه هي واجهة برمجة التطبيقات الحقيقية. تعرض Model Studio نموذج Plus من خلال نقطة نهاية متوافقة مع OpenAI، لذا يمكن لأي رمز برمجي يتحدث بالفعل إلى OpenAI SDK استدعاؤها بتبديل عنوان URL الأساسي والمفتاح.
هناك حد صارم يجب التخطيط له: Plus مملوك. لا توجد أوزان مفتوحة للتنزيل، لذا لا يمكنك استضافته بنفسك أو تشغيله معزولًا. إذا كان ذلك مطلبًا، فإن نظرتنا العامة على Qwen 3.7 Plus تغطي التفاصيل حول المقايضات.
| الطريقة | الوصول إلى API | التكلفة | الأفضل لـ |
|---|---|---|---|
| دردشة Qwen (chat.qwen.ai) | لا | مجاني، مع قيود على المعدل | تقييم سريع بالصور |
| Model Studio (DashScope) | نعم، متوافق مع OpenAI | الدفع حسب الرمز | التكامل في بيئة الإنتاج |
| الاستضافة الذاتية | لا | غير متاح | غير متاح؛ الأوزان مغلقة |
الحصول على مفتاح API لـ Qwen 3.7 Plus
يتم الوصول عبر حساب Alibaba Cloud.
- أنشئ حساب Alibaba Cloud وافتح لوحة تحكم Model Studio (
modelstudio.console.alibabacloud.com). - قم بتنشيط Model Studio لحسابك ومنطقتك. المفاتيح محددة بالمنطقة، لذا لن يتم مصادقة مفتاح سنغافورة مقابل بكين.
- افتح قسم مفاتيح API وقم بإنشاء مفتاح. يبدو كـ
sk-متبوعًا بسلسلة. - انسخه مرة واحدة وخزنه ككلمة مرور.
تحدد منطقتك عنوان URL الأساسي الخاص بك:
| المنطقة | عنوان URL الأساسي |
|---|---|
| سنغافورة | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| الولايات المتحدة (فرجينيا) | https://dashscope-us.aliyuncs.com/compatible-mode/v1 |
| بكين (الصين) | https://dashscope.aliyuncs.com/compatible-mode/v1 |
حافظ على المفتاح خارج التحكم في الإصدار. استخدم متغير بيئة:
# macOS / Linux
export DASHSCOPE_API_KEY="sk-your-key-here"
# Windows PowerShell
setx DASHSCOPE_API_KEY "sk-your-key-here"
طلبك الأول: Python، curl، وJavaScript
نقطة النهاية متوافقة مع OpenAI، لذا يمكنك استخدام OpenAI SDK الرسمي الموجه إلى عنوان URL الأساسي لـ DashScope، أو استدعاء HTTP خام. معرف النموذج هو qwen3.7-plus، ولكن تأكد من السلسلة الحالية في قائمة نماذج Model Studio قبل النشر، حيث يمكن أن تتغير المعرفات.
Python مع OpenAI SDK
ثبت باستخدام pip install openai، ثم:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DASHSCOPE_API_KEY"],
base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)
resp = client.chat.completions.create(
model="qwen3.7-plus",
messages=[{"role": "user", "content": "Summarize the Qwen 3.7 Plus pricing model in two sentences."}],
)
print(resp.choices[0].message.content)
curl
curl "https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.7-plus",
"messages": [{"role": "user", "content": "Hello from the Qwen 3.7 Plus API."}]
}'
JavaScript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.DASHSCOPE_API_KEY,
baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
});
const resp = await client.chat.completions.create({
model: "qwen3.7-plus",
messages: [{ role: "user", content: "Hello from the Qwen 3.7 Plus API." }],
});
console.log(resp.choices[0].message.content);
إرسال الصور والفيديو
السبب لاستخدام Plus بدلاً من Max هو الإدخال متعدد الوسائط. تمرر المحتوى المرئي كأجزاء إضافية في مصفوفة content الرسالة، بنفس الشكل الذي تستخدمه واجهة برمجة تطبيقات رؤية OpenAI.
resp = client.chat.completions.create(
model="qwen3.7-plus",
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "Which button submits this form? Give pixel coordinates."},
{"type": "image_url", "image_url": {"url": "https://example.com/screenshot.png"}},
],
}],
)
يمكنك تمرير صورة كعنوان URL عام أو URI بيانات base64. يتبع الفيديو نفس النمط بجزء فيديو. هذا ما يشغل سلوك تحديد واجهة المستخدم الرسومية: أعطِ Plus لقطة شاشة، وسيعيد إجراءات منظمة مثل click at (x=487, y=232). قد تختلف أسماء الأجزاء الدقيقة للفيديو حسب المنطقة، لذا تحقق من وثائق التوافق مع OpenAI لمعرفة المخطط الحالي.
التسعير
يتم تسعير Plus كفئة متعددة الوسائط اقتصادية. إليك مقارنة بينها وبين النموذج الرائد المعتمد على النصوص:
| النموذج | الإدخال / 1 مليون | الإخراج / 1 مليون | الإدخال المخزّن مؤقتًا / 1 مليون |
|---|---|---|---|
| Qwen 3.7 Plus | $0.40 | $1.60 | $0.08 |
| Qwen 3.7 Max | $2.50 | $7.50 | $0.25 |
هذا أرخص بحوالي ست مرات من Max في الإدخال. لا توجد طبقة مجانية دائمة، ولكن تحصل حسابات Model Studio الجديدة على حصة رمزية مجانية لمرة واحدة (عادةً في منطقة سنغافورة) لتقييم النموذج قبل أن يتحول الفوترة إلى الدفع حسب الاستخدام. لاحظ أن المسار المجاني القديم لـ Qwen OAuth تم إيقافه في 15 أبريل 2026، لذا لا تعتمد عليه. توجد الأرقام الرسمية على صفحة تسعير Model Studio و دليل الحصة المجانية؛ للحصول على طرق مجانية لتجربة المجموعة الأوسع، راجع دليل Qwen 3.7 مجانًا.
ما هي التكلفة الفعلية للطلبات
النص رخيص. تكمن الزيادة في الفاتورة في الرؤية، لأن الصور والفيديو تُحول إلى رموز (tokens) تُحاسب بنفس المعدل لكل رمز ونفس ميزانية السياق البالغة 1 مليون رمز. يمكن أن تكلف لقطة شاشة عالية الدقة بضعة آلاف من الرموز، وتتراكم إطارات الفيديو بسرعة.
| الطلب | رموز الإدخال | رموز الإخراج | التكلفة التقريبية |
|---|---|---|---|
| مطالبة نصية فقط | 10,000 | 2,000 | ~$0.007 |
| لقطة شاشة واحدة بدقة 1080p + مطالبة | ~1,500 | 300 | ~$0.001 |
| فيديو 30 ثانية تم أخذ عينات منه بمعدل 2 إطار في الثانية | ~77,000 | 500 | ~$0.032 |
أرقام رموز الإطارات تقريبية وتعتمد على الدقة ومعدل أخذ العينات، لكن الدرس واضح: عامل نصي على Plus يكلف تقريبًا لا شيء، بينما يمكن أن يكلف عبء عمل مكثف على الفيديو 30 مرة أكثر لكل استدعاء. قلل من دقة لقطات الشاشة وأخذ عينات الفيديو باعتدال. لاستراتيجية أوسع للتكلفة، راجع ملاحظاتنا حول تقليل تكاليف رموز الوكيل و حرب أسعار نماذج اللغات الكبيرة الصينية 2026 التي وضعت Plus بهذا السعر في المقام الأول.
حدود المعدل والأخطاء
تفرض Model Studio حدودًا للمعدل لكل حساب من حيث الطلبات في الدقيقة والرموز في الدقيقة، وتعتمد هذه الحدود القصوى على مستوى حسابك والمنطقة بدلاً من رقم واحد منشور. تحقق من صفحة الحصص في وحدة التحكم لمعرفة حدودك الحالية، واطلب زيادة هناك إذا وصلت إليها.
تعامل مع الأعطال الشائعة:
- 401 غير مصرح به: مفتاح خاطئ، أو مفتاح من منطقة خاطئة لعنوان URL الأساسي الخاص بك.
- 429 عدد كبير جدًا من الطلبات: لقد وصلت إلى حد المعدل. تراجع وأعد المحاولة بتأخير متزايد.
- 400 طلب سيئ: عادةً ما تكون حمولة بيانات متعددة الوسائط مشوهة، أو صورة كبيرة جدًا، أو تجاوز سعة السياق بمجرد حساب رموز الرؤية.
قم بتضمين الاستدعاءات في إعادة محاولة مع تراجع على أخطاء 429 و 5xx، وتحقق من حجم الصورة قبل الإرسال.
اختبار ومحاكاة واجهة برمجة التطبيقات باستخدام Apidog
من السهل ارتكاب أخطاء في طلبات الوسائط المتعددة. فأنت تقوم بترميز الصور بـ base64، وتضمين مصفوفات المحتوى، وقراءة خطط الإجراءات المنظمة مرة أخرى، غالبًا داخل حلقة استدعاء الأدوات. مراقبة ذلك في الطرفية يصبح أمرًا قديمًا بسرعة.
Apidog يمنحك مساحة عمل حقيقية لذلك. أرسل طلبات Qwen 3.7 Plus بأجزاء الصور والفيديو، وافحص استجابة JSON الخام، وقم بتخزين مفتاح Model Studio الخاص بك لكل بيئة حتى لا تضطر أبدًا إلى لصقه في الكود، وقم بمحاكاة نقطة النهاية حتى يستمر الواجهة الأمامية في البناء بينما تقوم بتعديل المطالبات. عندما يقوم Plus بسلسلة استدعاءات الأدوات عبر تشغيل وكيل GUI-and-CLI، فإن مصحح أخطاء وكيل الذكاء الاصطناعي في Apidog يظهر التسلسل الكامل حتى تتمكن من العثور على مكان تعطل التشغيل.
قم بتنزيل Apidog لاختبار وتصحيح ومحاكاة واجهة برمجة تطبيقات Qwen 3.7 Plus قبل أن تصل إلى الإنتاج.
الأسئلة الشائعة
هل توجد طبقة مجانية لواجهة برمجة تطبيقات Qwen 3.7 Plus؟ لا توجد طبقة مجانية دائمة. تحصل حسابات Alibaba Cloud Model Studio الجديدة على حصة رمزية مجانية لمرة واحدة للتقييم، عادةً في منطقة سنغافورة، ثم تنتقل الفوترة إلى الدفع حسب الاستخدام.
ما هو معرف النموذج؟ qwen3.7-plus على Model Studio. نظرًا لأن المعرفات يمكن أن تتغير، تأكد من السلسلة الحالية في قائمة نماذج Model Studio قبل النشر.
كيف يتم حساب تكلفة الصور والفيديو؟ يتم تحويل المحتوى المرئي إلى رموز يتم احتسابها بمعدل الإدخال القياسي. يمكن أن تكلف لقطة شاشة بدقة 1080 بكسل بضعة آلاف من الرموز، ويضيف الفيديو رموزًا لكل إطار تم أخذ عينات منه، لذا فإن حمولات الوسائط الكبيرة تسيطر على الفاتورة.
كيف تختلف واجهة برمجة التطبيقات عن Qwen 3.7 Max؟ نفس الشكل المتوافق مع OpenAI وعناوين URL الأساسية. يقبل Plus أجزاء الصور والفيديو في محتوى الرسالة ويكلف حوالي ست مرات أقل؛ Max هو نصي فقط ويحتفظ بميزة طفيفة في معايير النصوص البحتة.
هل يمكنني استضافة Qwen 3.7 Plus بنفسي؟ لا. الأوزان مغلقة، لذا لا يعمل إلا من خلال Alibaba Cloud Model Studio.
أي عنوان URL أساسي يجب أن أستخدمه؟ العنوان الذي يطابق المنطقة التي أنشأت فيها مفتاحك: سنغافورة، الولايات المتحدة (فرجينيا)، أو بكين. لن يتم مصادقة المفتاح مقابل نقطة نهاية منطقة مختلفة.
الخلاصة
استدعاء Qwen 3.7 Plus هو مجرد تبديل لعنوان URL أساسي ومفتاح في OpenAI SDK، بالإضافة إلى أجزاء الصور أو الفيديو عندما تحتاج إلى رؤية. التسعير رخيص حقًا للنصوص ويتناسب مع حمولتك المرئية، لذا فإن الانضباط يكمن في عدد البكسلات التي ترسلها، وليس في واجهة برمجة التطبيقات نفسها. احصل على مفتاحك، أرسل أول طلب متعدد الوسائط، واختبر التدفق بأكمله في Apidog قبل ربطه بالإنتاج.