API الذكاء الاصطناعي عبر Qwen Code في 2026: المفتاح والاتصال وحساب الاستخدام

يثبّت شخص ما Qwen Code ويشغّله في الطرفية، ثم يطلب منه مفتاحًا عند أول طلب. وهنا يبدأ البحث: يكتب الناس «buy api key for qwen code» وينتهي بهم المطاف في صفحات تبيع إما اشتراكًا أو إمكانية وصول جاهزة تخص شخصًا آخر. إليك ما هو المفتاح، وأين تحصل عليه، وكم تبلغ تكلفته، خطوة بخطوة.

لنبدأ بالنقطة الأهم: لا يبيع أحد مفتاح API كمنتج مستقل جاهز. إنه سلسلة وصول تصدرها بنفسك من حساب مزوّد النموذج، وإصدارها مجاني. ستحتاج إلى المال لاحقًا عند شحن رصيدك؛ وعندها تسري شروط المزوّد. فيما يلي: أين تحصل على مفتاح، وكيف تربطه بـ Qwen Code، وكم تبلغ تكلفة استخدامه.

كيف يتيح مفتاح API الاتصال بالذكاء الاصطناعي عبر Qwen Code؟#

Qwen Code وكيل ذكاء اصطناعي مفتوح المصدر يعمل في الطرفية ويكتب التعليمات البرمجية لمهامك. وهو مجاني، ويُثبّت عبر npm، ولا يحتوي على شبكة عصبية خاصة به. يتولى النموذج كل العمل الذكي، ويعمل النموذج على خوادم المزوّد.

يحتاج Qwen Code إلى تصريح للوصول إلى النموذج. وهذا التصريح هو مفتاح API، وهو سلسلة طويلة شبيهة بكلمة مرور يصدرها المزوّد لك شخصيًا. عندما يرسل الوكيل طلبًا، يرفق المفتاح به؛ ويستخدمه المزوّد لمعرفة صاحب الطلب، ثم يرد ويخصم الاستخدام من رصيدك.

وهذا يقود إلى نقطة بسيطة تزيل نصف الالتباس. لا يُشترى المفتاح كمنتج من سوق إلكترونية: تنشئ حسابًا لدى مزوّد، وتنقر على «إنشاء مفتاح»، فتحصل على السلسلة مجانًا. والبحث عن «buy api key» يعني في الواقع «أين أنشئ حسابًا، وكيف أدفع مقابل الاستخدام لاحقًا؟» وقد تناولنا السؤالين أدناه.

كيف يختلف مفتاح API عن الاشتراك وتسجيل الدخول المجاني القديم؟#

يعرض /auth داخل Qwen Code خيارات المصادقة التي يدعمها الإصدار المثبّت لديك. اختر المنصة التي أصدرت مفتاحك وخطة فوترته. تشرح الفروق أدناه تسجيل الدخول المجاني القديم وCoding Plan والمفتاح القياسي المستخدم هنا؛ وليست قائمة حصرية بعناصر القائمة الحالية.

الخيار الأول هو تسجيل الدخول مجانًا عبر حساب Qwen (Qwen OAuth). كان يتيح الوصول إلى النموذج من دون مفتاح، لكنه أُوقف.

الخيار الثاني هو اشتراك Coding Plan في Alibaba ModelStudio. وهو رسم شهري ثابت يمنحك حصة أسبوعية من الطلبات وعنوان اتصال منفصلًا.

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

أين يمكنك إصدار مفتاح API لـ Qwen Code؟#

بما أن Qwen Code يفهم بروتوكولات مختلفة، فلست مقيدًا بمزوّد مفاتيح واحد. وتذكر الوثائق الرسمية صراحةً الخدمات التي يمكنه الاتصال بها.

فيما يلي مسار الاتصال المباشر.

للمسار المباشر، افتح وحدة تحكم Alibaba Model Studio، واختر المنطقة المقصودة، وأنشئ مفتاحًا من صفحة إدارة مفاتيح API. احتفظ باسم المنطقة ومساحة العمل مع الإعدادات، ولا تنسخ المفتاح إلى ملاحظات مشتركة.

يوصي دليل المناطق بنطاقات مخصصة لمساحة العمل في الإنتاج. انسخ API Host الحقيقي من Workspace Management واتبع دليل عنوان الأساس، ولا تخترع معرّف مساحة عمل. نقاط DashScope المشتركة والنقاط المخصصة لمساحة العمل خيارا وصول مختلفان. وتستخدم Coding Plan وToken Plan مفاتيح ونقاط نهاية خاصة بهما. انسخ عنوان Base URL الكامل المتوافق مع OpenAI من وحدة تحكم مساحة العمل في المنطقة المختارة إلى DASHSCOPE_BASE_URL. يُحذف baseUrl من JSON ويُمرر عبر OPENAI_BASE_URL قبل التشغيل؛ استخدم القيم الحقيقية من وحدة التحكم لا معرّف مساحة عمل افتراضيًا.

هناك أيضًا خيار مجاني لا يتطلب أي مفتاح: شغّل نموذج Qwen على حاسوبك عبر Ollama، وصِل Qwen Code به بوصفه خادمك الخاص. ويتطلب ذلك جهازًا قويًا وإعدادًا منفصلًا. يوضح دليل تشغيل Qwen Code في الطرفية كيفية تشغيل الوكيل محليًا.

كيف تضيف المفتاح إلى Qwen Code ليعمل؟#

انسخ إعداداتك الحالية احتياطيًا وادمج الاتصال التالي في ~/.qwen/settings.json، دون استبدال المزوّدين أو التفضيلات الأخرى. يتبع هذا المثال مثال مصادقة Qwen Code مع تمرير عنوان مساحة العمل عبر OPENAI_BASE_URL، وقراءة مفتاح API من متغير البيئة المحدد في envKey، وحذف كتلة env ذات السر النصي. النموذج qwen3-coder-plus هو نموذج المثال الرسمي؛ تحقق أولًا من توفره في منطقتك وحسابك، أو استخدم معرّف نموذج حقيقي من وحدة تحكم المنطقة في الموضعين.

انسخ عنوان Base URL الكامل المتوافق مع OpenAI من وحدة تحكم مساحة العمل في المنطقة المختارة إلى DASHSCOPE_BASE_URL. يُحذف baseUrl من JSON ويُمرر عبر OPENAI_BASE_URL قبل التشغيل؛ استخدم القيم الحقيقية من وحدة التحكم لا معرّف مساحة عمل افتراضيًا.

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "qwen3-coder-plus" }
}

يختار openai البروتوكول المتوافق. وenvKey اسم المتغير الذي يقرؤه Qwen Code، وليس قيمة المفتاح. يجب أن يطابق model.name قيمة id المضبوطة. يوثق مرجع مزوّدي النماذج هذه الحقول.

على macOS أو Linux، افتح طرفية Bash وأدخل المفتاح في مطالبة مخفية، ثم شغّل Qwen Code من الطرفية نفسها:

read -r -p 'Workspace OpenAI-compatible Base URL (copy from regional console): ' DASHSCOPE_BASE_URL
if [[ -z "$DASHSCOPE_BASE_URL" || ! "$DASHSCOPE_BASE_URL" =~ ^https:[/][/] || "$DASHSCOPE_BASE_URL" == *'{'* || "$DASHSCOPE_BASE_URL" == *'}'* ]]; then
  printf '%s\n' 'STOP: supply the real regional workspace Base URL.' >&2
else
  read -r -s -p 'DashScope API key: ' DASHSCOPE_API_KEY
  printf '\n'
  if [[ -n "$DASHSCOPE_API_KEY" ]]; then
    export DASHSCOPE_API_KEY
    export OPENAI_BASE_URL="$DASHSCOPE_BASE_URL"
    qwen
  else
    printf '%s\n' 'STOP: API key is empty.' >&2
  fi
fi

على Windows، استخدم PowerShell:

$env:DASHSCOPE_BASE_URL = Read-Host 'Workspace OpenAI-compatible Base URL (copy from regional console)'
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_BASE_URL) -or $env:DASHSCOPE_BASE_URL -notmatch '^https:[/][/]' -or $env:DASHSCOPE_BASE_URL -match '[{}]') {
  throw 'Supply the real regional workspace Base URL.'
}
$qwenKey = Read-Host 'DashScope API key' -AsSecureString
$env:DASHSCOPE_API_KEY = [System.Net.NetworkCredential]::new('', $qwenKey).Password
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_API_KEY)) {
  throw 'API key is empty.'
}
$env:OPENAI_BASE_URL = $env:DASHSCOPE_BASE_URL
qwen

تُبقي هذه الأوامر قيمة السر الحرفية خارج JSON وسجل أوامر shell؛ لكن العملية الجارية تستقبلها في بيئتها. لا تطبعها أو ترفعها إلى Git أو تلصقها في موجّه. عند اعتماد هذا المسار، أزل إدخال env القديم الذي يحتوي على السر. وتحتاج الطرفية الجديدة إلى إدخال المتغير مجددًا.

داخل Qwen Code، استخدم /doctor لفحص المصادقة و/model للتحقق من الخيار المضبوط. في مجلد اختبار فارغ غير حساس، أرسل: «أجب بكلمة connected. لا تقرأ الملفات أو تغيّرها ولا تشغّل أوامر». تختبر الاستجابة الناجحة طلب نموذج واحدًا وقد تترتب عليها رسوم استخدام. ظهور النموذج في /model يؤكد الإعداد المحلي فقط.

إذا فشل الطلب، فسجّل الخطأ بعد حجب الأسرار ومعرّف الطلب إن توفر. افحص المصادقة بمعزل عن توفر النموذج والفوترة: تحقق من منصة إصدار المفتاح والمنطقة ومساحة العمل ونقطة النهاية القياسية أو الخاصة بالخطة ومعرّف النموذج والرصيد أو الحصة في وحدة التحكم نفسها. قد يدل 401 على عدم توافق المفتاح أو نقطة النهاية أو خطة الفوترة؛ وليس دليلًا على تعطل المزوّد. توقف بعد الاختبار الفاشل وصحح الاختلاف الموثق قبل المحاولة مجددًا. يصف المقال مثالًا مستندًا إلى الوثائق، وليس طلبًا مدفوعًا نُفّذ لهذا الدليل.

كم يكلف العمل باستخدام مفتاح API، وما الذي يزيد الفاتورة؟#

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

يبدو المليون رمز كمية كبيرة، لكن عند العمل على مشروع كبير ينفد أسرع مما تتوقع: فالوكيل يقرأ ملفاتك كاملةً مع كل طلب.

إليك الخلاصة العملية: تعتمد الفاتورة على كمية النص التي يعالجها الوكيل. فالملفات الطويلة والجلسات الطويلة وإعادة قراءة التعليمات البرمجية باستمرار هي أكثر ما يستهلك رصيدك بسرعة؛ أما عدد المهام فهو عامل ثانوي. يشرح مقال منفصل خطوة بخطوة كيفية حساب استهلاك رموز API ولماذا قد ينفد من دون أن تلاحظ.

لماذا تُرفض المدفوعات؟#

هنا يقع خطأ شائع.

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

إذا كان الرفض مرتبطًا بالبنك الذي أصدر البطاقة، فلن يؤدي تغيير بريدك الإلكتروني أو لغة الواجهة أو إعدادات ملفك الشخصي إلى تغيير شروط الدفع. وتُشرح هذه الآلية باستخدام مثال بطاقة أجنبية لـ Claude.

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

من أين تبدأ؟#

خطة موجزة خطوة بخطوة:

1. حدد المنصة وخطة الفوترة. أُوقف Qwen OAuth المجاني القديم في أبريل 2026؛ وCoding Plan اشتراك منفصل، بينما يغطي هذا الدليل مفتاح Model Studio القياسي حسب الاستخدام. تختلف القائمة باختلاف الإصدار.
2. أنشئ حسابًا لدى مزوّد. أبسط خيار هو Alibaba مباشرةً.
3. اختر منطقة Model Studio ومساحة العمل، ثم أصدر مفتاحًا من إدارة مفاتيح API في وحدة التحكم نفسها. إصدار المفتاح منفصل عن تمويل الاستخدام.
4. ادمج الاتصال الإقليمي في ~/.qwen/settings.json من دون قيمة سرية. وفّر DASHSCOPE_API_KEY في الطرفية التي تشغّل البرنامج، ثم تحقق من النموذج المختار ومن رد قصير كما سبق.
5. لدفع تكلفة الاستخدام، تحتاج إلى بطاقة صادرة باسمك وتقبلها بوابة الدفع لدى المزوّد. تحدد بوابة الدفع شروط شحن الرصيد؛ وإصدار المفتاح ودفع تكلفة الاستخدام خطوتان منفصلتان.

ومن المفيد أيضًا التفكير في النموذج الذي تحتاج إليه. للمهام الصعبة، اختر Qwen3-Coder-Plus الأعلى أداءً؛ ولتوفير المال، اختر Flash الأخف، فهو أقل تكلفة بعدة مرات للحجم نفسه. يوضح دليل Qwen Code بديلًا لـ Claude Code أوجه اختلاف Qwen Code عن وكلاء الطرفية الآخرين.

تتوفر مواد أخرى على Ailoot.