# Dify مستضاف ذاتيًا على Windows 11: وصّل QCode خطوة بخطوة


**الإجابة المختصرة**: في Dify افتح `Integrations` ← `Model Provider`، ثم ثبّت إضافة `OpenAI-API-compatible`، وبعد ذلك انقر `Add Model` واملأ عنوان الوصول `https://api.qcode.cc/openai/v1`، واسم النموذج `gpt-6.2-sol`، ومفتاحك الذي يبدأ بـ `cr_`، و`Chat` كوضع الإكمال.

| البند | ما تملؤه |
|---|---|
| الإضافة التي تثبّتها | `OpenAI-API-compatible` |
| عنوان واجهة API (`API Base URL`) | `https://api.qcode.cc/openai/v1` |
| اسم النموذج | `gpt-6.2-sol` |
| نوع النموذج / وضع الإكمال | `LLM` / `Chat` |
| مفتاح API | `cr_xxxxxxxx` |

تم التحقق في 2026-11-22 · Dify 1.20.0 · Windows 11


اتبع اللقطات الـ13 أدناه على جهاز كمبيوتر يعمل بـ Windows 11، وستنتهي بـ QCode وهو يجيب داخل Dify: تطبيق Chatbot في `Studio` يرد على أول رسالة ترسلها. ولا يحتاج Dify نفسه إلى حساب من مزوّد نماذج — فبيانات الاعتماد الوحيدة هنا هي مفتاح API من QCode.


- **ينطبق على**: Windows 10 / 11 (64 بت) مع Docker Desktop وWSL 2؛ واللقطات تعرض Windows 11
- **إصدار البرنامج**: Dify Community Edition 1.20.0 + إضافة `OpenAI-API-compatible` 0.0.87
- **تاريخ تحديث اللقطات**: 2026-11
- **الوقت المتوقع**: نحو 25 دقيقة، إضافةً إلى تنزيل أول صورة Docker
- **ما تحتاج إليه**: مفتاح API من QCode يبدأ بـ `cr_`


قبل أول لقطة شاشة، تحقق من توفر ما يلي:


- جهاز كمبيوتر يعمل بـ Windows 10 أو 11 (64 بت) ويستطيع فتح المواقع، مع نواتين (2 CPU cores) على الأقل و4 GiB من الذاكرة مخصّصة لـ Docker
- متصفح — Edge أو Chrome — لأن Dify لا يملك تطبيق سطح مكتب؛ فالدليل كله يعمل في تبويب متصفح
- نسخة Dify تستطيع تسجيل الدخول إليها: نشرك الخاص عبر Docker Compose على `http://localhost:8080`، أو Dify Cloud على **cloud.dify.ai**
- مفتاح API من QCode منسوخ من لوحة التحكم (`cr_xxxxxxxx`)؛ وهذا هو العنصر الوحيد الذي لا يمكن تجاوزه. ليس لديك حساب بعد؟ [أنشئ حسابًا](https://qcode.cc/ar/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-dify-before) أولًا، واختر خطة من [صفحة الأسعار](https://qcode.cc/ar/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-dify-before)، ثم أنشئ المفتاح في [لوحة التحكم](https://qcode.cc/ar/dashboard).


## تنزيل Dify وتثبيته

Dify خدمة ويب، لذا لا يوجد مثبّت Windows لواجهة Dify. إما أن تفتح Dify Cloud في المتصفح، أو تشغّل الواجهة نفسها محليًا عبر Docker Compose. وكلا الطريقين ينتهي إلى صفحة `Model Provider` ذاتها التي تستخدمها الخطوات أدناه. اختر التبويب المطابق لموضعك:

**مناطق أخرى**

افتح **dify.ai** واستخدم مسار السحابة: سجّل في **cloud.dify.ai** ويعمل الدليل كله في المتصفح.

وللنشر المحلي، افتح دليل Docker Compose الرسمي على **docs.dify.ai**، وثبّت Docker Desktop من **docker.com** (Windows، `x64`)، واقبل الاتفاقية وأبقِ الواجهة الخلفية `Use WSL 2`. يحتاج المثبّت صلاحيات المسؤول ويطلب عادةً إعادة التشغيل. ويحتوي مستودع الدليل أيضًا على GitHub Releases، حيث الملف `difyctl-v1.20.0-windows-x64.exe` أداة سطر أوامر للمسؤولين — وهو ليس واجهة Dify، فلا تتوقع أن تُفتح منه نافذة. وبعد `docker compose up -d` تكون الواجهة على `http://localhost:8080`.


**البر الرئيسي للصين**

افتح **dify.ai** واستخدم مسار السحابة: تكون الواجهة عندئذ على **cloud.dify.ai**، ولا يُثبَّت شيء على الكمبيوتر.

وإذا أردت الواجهة على جهازك أنت، فافتح دليل Docker Compose الرسمي على **docs.dify.ai** واتبعه باستخدام Docker Desktop. ثبّت Docker Desktop من **docker.com** أولًا. وإذا كانت إحدى الصفحات بطيئة التحميل أو توقّف أحد التنزيلات، فانتظر دقيقة وابدأ من جديد — فالصفحة والمثبّت يُخدمان من المضيف نفسه، لذا غالبًا ما تحلّ إعادة المحاولة لاحقًا المشكلتين معًا.




### اقرأ صفحة المتطلبات أولًا

قبل تنزيل أي شيء، افتح دليل Docker Compose الرسمي. عند ① يؤكد عنوان الصفحة أنك في صفحة الاستضافة الذاتية الخاصة بـ Docker Compose، وعند ② تسرد كتلة المتطلبات المسبقة ما يجب أن يوفره الجهاز: نواتان (2 CPU cores) على الأقل، و4 GiB من الذاكرة، وDocker Compose نفسه.

![دليل Dify الرسمي للاستضافة الذاتية عبر Docker Compose، وفي أعلى الصفحة عنوانها، وأسفله كتلة المتطلبات المسبقة من العتاد والبرمجيات](https://docs.qcode.cc/static/images/tut/dify/202611/en/01-dify-docs-docker.webp)


إذا فعلتها بشكل صحيح فسترى: ① عنوان صفحة تثبيت Docker Compose، و② قائمة المتطلبات المسبقة وفيها سطور المعالج والذاكرة وDocker Compose مقروءة في شاشة واحدة.


**تعثّرت؟ تعرض الصفحة طريقة تثبيت مختلفة**

يوثّق Dify طريقتي Docker Compose وKubernetes جنبًا إلى جنب، وأحيانًا تصل نتائج البحث إلى صفحة Kubernetes. مرّر إلى أعلى الصفحة وتأكد من أن العنوان يحتوي على `docker-compose`؛ فهذا هو المسار الذي يستخدمه هذا الدليل.




### ثبّت Docker Desktop

يعمل Dify في حاويات على Windows، لذا يأتي Docker Desktop أولًا. في **docker.com** انقر ① `Download Docker Desktop`، ثم شغّل الملف الذي نزّلته `Docker Desktop Installer.exe`، واقبل الاتفاقية وأبقِ الواجهة الخلفية `Use WSL 2` محددة. يطلب المثبّت صلاحيات المسؤول ويعرض عادةً إعادة التشغيل؛ فاقبلها.

![صفحة تنزيل Docker Desktop الرسمية وفيها زر Download Docker Desktop](https://docs.qcode.cc/static/images/tut/dify/202611/en/02-docker-desktop-download.webp)


إذا فعلتها بشكل صحيح فسترى: يبدأ التنزيل من الزر ①، وبعد التثبيت تظهر أيقونة الحوت في منطقة الإشعارات مع الحالة `Engine running`.


**تعثّرت؟ يعرض Windows رسالة “Windows protected your PC”**

انقر `More info` ثم `Run anyway`. تعرض SmartScreen هذا الصندوق للمثبّتات التي لم ترها مرات كافية؛ والملف هو نفسه الذي نزّله الزر ① للتو.




### سجّل الدخول إلى نسخة Dify لديك

افتح `http://localhost:8080` في متصفحك. أول زيارة تذهب إلى صفحة `/install` حيث تنشئ حساب المسؤول ببريد إلكتروني وكلمة مرور؛ وكل زيارة بعدها تفتح صفحة تسجيل الدخول. اكتب البريد الإلكتروني وكلمة المرور في ①، ثم انقر ② `Sign in`.

![صفحة تسجيل الدخول في نسخة Dify مستضافة ذاتيًا، وفيها حقلا البريد الإلكتروني وكلمة المرور وزر Sign in](https://docs.qcode.cc/static/images/tut/dify/202611/en/03-dify-signin.webp)


إذا فعلتها بشكل صحيح فسترى: ① الحقلين مملوءين ونقاط تغطي كلمة المرور، و② `Sign in` يتحول إلى الأزرق، وبعد النقر صفحة Dify الرئيسية واسم مساحة العمل في الزاوية العليا اليسرى.


**تعثّرت؟ يقول المتصفح إن الموقع لا يمكن الوصول إليه**

الحاويات ليست قيد التشغيل بعد. افتح Docker Desktop، وانتظر `Engine running`، ثم نفّذ `docker compose up -d` في مجلد مصدر Dify وأعد تحميل الصفحة. يسحب أول تشغيل عدة صور ويستغرق وقتًا.




### افتح Integrations

تُفتح صفحة Dify الرئيسية بعد تسجيل الدخول. يقع التنقل كله في عمود واحد على الجانب الأيسر: `Home`، `Studio`، `Agents`، `Knowledge`، `Contacts`، `Skills`، `Integrations`، `Marketplace`. انقر ① `Integrations`؛ ينقلك Dify مباشرة إلى `Model Provider`.

![صفحة Dify الرئيسية مع شريط التنقل الأيسر وعنصر Integrations مظلّلًا](https://docs.qcode.cc/static/images/tut/dify/202611/en/04-dify-home-integrations.webp)


إذا فعلتها بشكل صحيح فسترى: ① `Integrations` مظلّلًا في العمود الأيسر، والصفحة خلفه عنوانها `Model Provider` وفي أعلاها مربع `Search models...`.




### ابحث عن مزوّد OpenAI-API-compatible

تسرد صفحة `Model Provider` كل تكامل يستطيع Dify التحدث معه. انقر ① مربع `Search models...` واكتب `OpenAI-API-compatible`. عند ② تظهر البطاقة المطابقة في القائمة، وعليها زر أزرق `Install`.

![صفحة Model Provider وقد كُتب OpenAI-API-compatible في مربع البحث، وبطاقة المزوّد المطابق مدرجة أسفله](https://docs.qcode.cc/static/images/tut/dify/202611/en/05-search-openai-compat.webp)


إذا فعلتها بشكل صحيح فسترى: ① نصك في مربع البحث، و② بطاقة واحدة اسمها `OpenAI-API-compatible` وعليها زر `Install` — لا `OpenAI`، فذلك إضافة مختلفة.


**تعثّرت؟ لا يعيد البحث أي نتيجة**

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




### أكّد تثبيت الإضافة

النقر على `Install` في البطاقة يفتح نافذة حوار عنوانها `Install Integration` بدلًا من التثبيت فورًا. اقرأ الاسم في النافذة وانقر ① `Install` في أسفل النافذة. عندئذ ينزّل Dify الإضافة من Marketplace الخاص به، وهذا يستغرق بضع ثوانٍ.

![نافذة تأكيد Install Integration وفي أسفلها زر Install الأزرق](https://docs.qcode.cc/static/images/tut/dify/202611/en/06-install-plugin-confirm.webp)


إذا فعلتها بشكل صحيح فسترى: ① النافذة تُغلق من تلقاء نفسها، وبطاقة `OpenAI-API-compatible` تنتقل إلى مجموعة `Configuration required`.


**تعثّرت؟ تدور النافذة ثم تفشل**

تُجلب الإضافة من **marketplace.dify.ai**. تحقق من أن العنوان يُفتح في تبويب آخر؛ فعلى شبكة شركة أو خلف وكيل قد يُحجب التنزيل، وإعادة المحاولة على شبكة أخرى تنجح عادةً.




### افتح نافذة إضافة النموذج

تقع الإضافة المثبّتة الآن تحت `Configuration required` مع الملاحظة `Set up api-key or add model to use`. انقر ① `Add Model` على يمين تلك البطاقة — فهنا يوضع عنوان QCode والمفتاح.

![بطاقة OpenAI-API-compatible تحت Configuration required وزر Add Model على يمينها](https://docs.qcode.cc/static/images/tut/dify/202611/en/07-provider-add-model-entry.webp)


إذا فعلتها بشكل صحيح فسترى: ① `Add Model`، والنقر عليه يفتح نافذة اسمها `Add model` وفيها `Model Name` و`Model Type` و`API Key`.




### سمِّ النموذج واختر نوعه

اكتب `gpt-6.2-sol` في ① `Model Name` — فهو معرّف النموذج في QCode، فانسخه كما هو تمامًا. افتح ② `Model Type` واختر `LLM`. ثم انقر حقل `API Key` والصق مفتاحك الذي يبدأ بـ `cr_`؛ وتخفيه النافذة خلف نقاط.

![النصف الأعلى من نافذة Add model وفيه gpt-6.2-sol في Model Name وLLM في Model Type وحقل API Key مملوءًا بالنقاط](https://docs.qcode.cc/static/images/tut/dify/202611/en/08-add-model-config-top.webp)

**تحتاج مفتاح API؟**

إن لم يكن لديك حساب QCode بعد، [أنشئ حسابًا](https://qcode.cc/ar/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-dify-key) أولًا. وإذا لم ترد خطة شهرية، فاشترِ باقة من صفحة [باقات الدفع حسب الاستخدام](https://qcode.cc/ar/pay-as-you-go?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-dify-key)، ثم أنشئ المفتاح في [لوحة التحكم](https://qcode.cc/ar/dashboard). انسخ السلسلة التي تبدأ بـ `cr_` والصقها مكان `cr_xxxxxxxx`. ويمكنك الدفع ببطاقة الائتمان أو الخصم (Visa / Mastercard)، أو Apple Pay / Google Pay، أو العملات المشفرة — راجع [طرق الدفع](/docs/reference/payment-methods).



إذا فعلتها بشكل صحيح فسترى: ① `gpt-6.2-sol` مكتوبًا بهذا الشكل تمامًا، و② `LLM` في حقل النوع، وسطرًا من النقاط في `API Key` — دون علامات اقتباس حول أي منها.




### أدخل عنوان QCode ووضع الإكمال

مرّر إلى الأسفل داخل النافذة. ضع `https://api.qcode.cc/openai/v1` في ① `API Base URL` — فالمسار كله ينتمي إلى الحقل، بما فيه `/openai/v1`، دون شرطة مائلة في النهاية ودون `/chat/completions`. أبقِ ② `Completion mode` على `Chat`، ثم انقر ③ `Add` للحفظ والتحقق من المفتاح.

![النصف الأسفل من نافذة Add model وفيه عنوان QCode في API Base URL وChat في Completion mode وزر Add](https://docs.qcode.cc/static/images/tut/dify/202611/en/09-add-model-config-url.webp)


إذا فعلتها بشكل صحيح فسترى: ① العنوان ينتهي بـ `/openai/v1`، و② `Chat` محددًا، و③ `Add` يغلق النافذة دون سطر خطأ أحمر.


**تعثّرت؟ يتوقف الحفظ عند 401 أو 404**

الخطأ 401 يعني أن المفتاح اقتُطع أو يحمل مسافة أو علامة اقتباس — انسخه من لوحة التحكم مرة أخرى وأعد كتابة الحقل. والخطأ 404 يعني أن العنوان فيه مسار زائد أو ناقص؛ ويجب أن يكون `https://api.qcode.cc/openai/v1` بالضبط.




### تحقق من أن النموذج مُفعّل

بعد `Add` تترك الإضافة `Configuration required`. انقر `Show Models` أسفل البطاقة لتوسيع قائمة النماذج: عند ① يظهر السطر `gpt-6.2-sol LLM CHAT` ومفتاحه في وضع التشغيل. ثم انقر ② `Default Models` في شريط الأدوات أعلى يمين الصفحة.

![قائمة Show Models الموسّعة وفيها سطر gpt-6.2-sol LLM CHAT المفعّل، وزر Default Models في أعلى اليمين](https://docs.qcode.cc/static/images/tut/dify/202611/en/10-model-saved-enabled.webp)


إذا فعلتها بشكل صحيح فسترى: ① سطر نموذج واحد عليه `gpt-6.2-sol` و`LLM` و`CHAT` والمفتاح على يمينه في وضع التشغيل، و② `Default Models` زرًا أزرق في الزاوية العليا اليمنى.




### اجعله نموذج النظام الافتراضي

تُفتح `Default Model Settings` كنافذة حوار. سطرها الأول هو ① `System Reasoning Model`: افتحه واختر `gpt-6.2-sol` من القائمة، ثم انقر ② `Save`.

![نافذة Default Model Settings وقد اختير gpt-6.2-sol في System Reasoning Model، مع زر Save](https://docs.qcode.cc/static/images/tut/dify/202611/en/11-default-model-settings.webp)


إذا فعلتها بشكل صحيح فسترى: ① `gpt-6.2-sol` معروضًا في سطر System Reasoning Model، وبعد النقر على ② `Save` يختفي الشريط الأصفر `Configure a default system model to run applications` من أعلى الصفحة.


**تعثّرت؟ يقول السطر إن قائمة النماذج فارغة**

القائمة الفارغة تعني أن الإضافة ليس فيها نموذج مفعّل بعد — عُد خطوة واحدة ووسّع `Show Models` لتتأكد من أن المفتاح في وضع التشغيل. والنموذج الذي عُطّل في تلك القائمة لا يُعرض هنا.




### أنشئ تطبيق Chatbot

افتح `Studio` في العمود الأيسر وانقر `Create from Blank`. في البداية يُعرض `Workflow` و`Chatflow` فقط؛ انقر `MORE BASIC APP TYPES` لتوسيع البقية واختر ① `Chatbot`. اكتب `QCode Assistant` في ② `App name`، ثم انقر ③ `Create`.

![بطاقة Create from Blank في Studio مع توسيع MORE BASIC APP TYPES، ونوع Chatbot محددًا، واسم التطبيق QCode Assistant، وزر Create](https://docs.qcode.cc/static/images/tut/dify/202611/en/12-create-chatbot-app.webp)


إذا فعلتها بشكل صحيح فسترى: ① `Chatbot` محاطًا بإطار أزرق بعد اختياره، و② `QCode Assistant` في حقل الاسم، و③ `Create` يفتح التطبيق الجديد.


**تعثّرت؟ لا يوجد خيار Chatbot**

`Chatbot` مطوي افتراضيًا: انقر `MORE BASIC APP TYPES` أسفل البطاقتين الكبيرتين، فيظهر `Chatbot` و`Agent` و`Text Generator`. وتحقق أيضًا من أن الصفحة هي `Studio` لا `Agents`.




### أرسل أول رسالة وتحقّق من الرد

إنشاء التطبيق يفتح صفحة `Orchestrate`. عند ① يقرأ محدّد النموذج في الأعلى `gpt-6.2-sol CHAT` بالفعل. اكتب `Hello! Please introduce yourself in one sentence.` في ③ مربع `Talk to Bot` أسفل `Debug & Preview` واضغط `Send`؛ وعند ② يتدفق الجواب إلى اللوحة فوقه.

![صفحة Orchestrate وفي أعلاها gpt-6.2-sol CHAT، ومربع الإدخال Talk to Bot، ورد متدفق في Debug and Preview](https://docs.qcode.cc/static/images/tut/dify/202611/en/13-chatbot-preview-reply.webp)


إذا فعلتها بشكل صحيح فسترى: ① `gpt-6.2-sol CHAT` في الأعلى، و③ جملتك في مربع الإدخال، و② إجابة إنجليزية قصيرة تظهر كلمة كلمة — لا رسالة 401 أو 404 أو “model not found”.


**تعثّرت؟ لا يبدأ الجواب أبدًا**

افتح `Default Model Settings` مرة أخرى وتأكد من أن `System Reasoning Model` ما زال يحمل `gpt-6.2-sol`؛ فالتطبيق الذي أُنشئ قبل حفظ الافتراضي يبدأ بلا نموذج. وإذا كان الرد أحمر، فالمفتاح أو العنوان خطأ — راجع **الأخطاء الشائعة** أدناه.




## تحقق من أنه يعمل

يكتمل إعدادك عندما تتحقق الأمور الأربعة كلها:

- تسرد `Model Provider` الإضافة `OpenAI-API-compatible` ضمن التكاملات المثبّتة، مع `gpt-6.2-sol` مفعّلًا في `Show Models`.
- تعرض `Default Model Settings` القيمة `gpt-6.2-sol` في `System Reasoning Model` بدلًا من سطر فارغ.
- يجيب `QCode Assistant` في `Debug & Preview`، ويصل الرد متدفقًا لا كخطأ 401 أو 404 أو “model not found”.
- أغلق تبويب المتصفح، وافتح Dify مرة أخرى، فيبقى النموذج والإعداد الافتراضي والتطبيق كما هي.


### انتهى كل شيء

أصبح QCode موصولًا داخل Dify وتطبيق Chatbot يجيب من خلاله. ومن هنا يمكنك:

- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths) — مضيفات QCode الثلاثة وكل مسار تخدمه
- [الفوترة](/docs/reference/billing) — كيف يُشارك مفتاح واحد وحصة واحدة بين التطبيقات والأدوات
- [حلّ المشكلات](/docs/reference/troubleshooting)
- قارن الخطط في [صفحة الأسعار](https://qcode.cc/ar/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-dify-done)
- ارجع إلى [لوحة التحكم](https://qcode.cc/ar/dashboard) لمراجعة الاستخدام والرصيد


## الأخطاء الشائعة

| نص الخطأ | السبب | ما العمل |
|---|---|---|
| `Set up api-key or add model to use` | الإضافة مثبّتة لكن لم يُضف إليها أي نموذج بعد، فليس لدى Dify ما يختاره | افتح `Model Provider`، وانقر `Add Model` في بطاقة `OpenAI-API-compatible`، واملأ الحقول الأربعة كلها |
| `Configure a default system model to run applications` | يوجد نموذج لكن لم يُختر افتراضي، فتبدأ التطبيقات الجديدة بلا نموذج | انقر `Default Models` أعلى اليمين، واضبط `System Reasoning Model` على `gpt-6.2-sol` ثم انقر `Save` |
| `401` | وصل المفتاح إلى QCode ورُفض: نُسخ مع مسافة أو علامة اقتباس أو جزئيًا فقط، أو يعود إلى خطة انتهت | انسخ مفتاح `cr_` من لوحة التحكم مرة أخرى، والصقه في `API Key` دون أي إضافة، وتحقق من حالة الخطة في لوحة التحكم |
| `404` | يحمل العنوان مسارًا زائدًا أو ناقصًا، فيتلقى QCode طلبًا لا يخدمه | أبقِ `API Base URL` على `https://api.qcode.cc/openai/v1` بالضبط — دون شرطة مائلة في النهاية ودون `/chat/completions` |

## الأسئلة الشائعة

### هل أحتاج إلى حساب Dify، أو حساب Anthropic أو OpenAI؟

لا حاجة إلى حساب من مزوّد نماذج. يطلب Dify Cloud حساب Dify؛ وتطلب النسخة المستضافة ذاتيًا حساب المسؤول الذي تنشئه في صفحة `/install`. وفي الحالتين يكون المفتاح الذي يصل إلى النموذج هو مفتاح QCode الذي يبدأ بـ `cr_`، ولا يطلب أي جزء من هذا الدليل تسجيل دخول إلى Anthropic أو OpenAI.

### لماذا تظهر `OpenAI-API-compatible` مفقودة من القائمة؟

ثلاثة أسباب معتادة: أن مربع البحث ما زال يحمل عبارة أطول (اكتب `OpenAI` وحدها ومرّر القائمة)، أو أن الإضافة مثبّتة أصلًا فانتقلت خارج قسم Marketplace في الصفحة، أو أن الحساب ليس مالك مساحة العمل ولا مسؤولًا، وهذه صلاحية لازمة لتثبيت الإضافات. أعد تحميل الصفحة مرة واحدة قبل أن تبحث مجددًا.

### لماذا يجب أن يكون اسم النموذج `gpt-6.2-sol`؟

`Model Name` ليس تسمية — فDify يرسل تلك السلسلة إلى QCode كمعرّف النموذج. ويجب كتابة معرّف نموذج QCode كما تسرده وثائق QCode حرفيًا، لذا يعمل `gpt-6.2-sol` بينما لا يعمل `GPT 6.2 Sol`. وأي معرّف آخر تخدمه نقطة النهاية نفسها يوضع في الحقل نفسه، مثل `gpt-6.2-astra`.

### هل يمكنني استخدام نماذج Claude في Dify عبر QCode؟

نعم، عبر تكامل Anthropic الخاص بـ Dify نفسه، مع عنوان التوافق مع Anthropic `https://api.qcode.cc/api` بدلًا من العنوان المتوافق مع OpenAI. والافتراضي في QCode هناك هو `claude-opus-5-5`. واللقطات الـ13 في هذه الصفحة تتبع إضافة التوافق مع OpenAI لأن ذلك هو المسار المشروح هنا من أوله إلى آخره؛ فاعتبر عنوان Anthropic خيارًا لوقت لاحق.

### ماذا يحدث عندما ينتهي مفتاحي؟

يتوقف ذلك على ما اشتريته. المفتاح الذي جاء مع خطة شخصية **لا يمكن تجديده** — أعد فتح الخطة، وأنشئ مفتاحًا جديدًا، والصقه في حقل `API Key` مرة أخرى. أما المفتاح من باقة الدفع حسب الاستخدام فيعود للعمل عند شراء باقة أخرى: يستمر المفتاح نفسه في العمل، ولا يلزم تغيير أي شيء في Dify.

### هل يحتفظ Dify بإعدادات النموذج بعد إعادة التشغيل؟

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

### أستخدم `Chat` أم `Completion` في وضع الإكمال؟

استخدم `Chat`. يخدم QCode على نقطة النهاية هذه نماذج chat-completions، ويتوقع `Completion` واجهة prompt-completion لا تتيحها هذه النماذج. والاختيار الخاطئ هنا يظهر كخطأ عند `Add` لا داخل التطبيق.

## النماذج التي يُنصح باستخدامها

يكشف مفتاح QCode نفسه نماذج من عدة بائعين، ويوضع معرّف النموذج في `Model Name`. اختر واحدًا وأبقِ بقية الحقول كما هي.

| النموذج | البروتوكول والعنوان | يُستخدم في |
|---|---|---|
| `gpt-6.2-sol` | متوافق مع OpenAI — `https://api.qcode.cc/openai/v1` | الافتراضي في هذا الدليل: المحادثة اليومية والكتابة وأسئلة الشيفرة |
| `gpt-6.2-astra` | متوافق مع OpenAI — `https://api.qcode.cc/openai/v1` | الفئة الأعلى من عائلة GPT، لأصعب المهام |
| `claude-opus-5-5` | متوافق مع Anthropic — `https://api.qcode.cc/api` | Claude الرائد، للاستدلال الطويل وإعادة الهيكلة الكبيرة |
| `claude-haiku-5-5` | متوافق مع Anthropic — `https://api.qcode.cc/api` | Claude الخفيف، لأجوبة سريعة منخفضة التكلفة |

معرّف `claude-*` يُرسَل إلى نقطة النهاية المتوافقة مع OpenAI فيُرفض، ومعرّف `gpt-*` يُرسَل إلى نقطة نهاية Anthropic فيُرفض كذلك — فيجب أن تطابق عائلة النموذج العنوان. والقائمة الحيّة للمعرّفات في لوحة التحكم.

## كيف يُستخدم العنوان

`API Base URL` أساس وليس مسار طلب كامل. يحتفظ Dify بالجزء `/openai/v1` ويضيف `chat/completions` بنفسه، ولهذا يجب أن يتوقف الحقل عند `/v1`.

| الحقل | القيمة | ملاحظة |
|---|---|---|
| `API Base URL` | `https://api.qcode.cc/openai/v1` | أبقِ `/openai/v1`؛ دون شرطة مائلة في النهاية |
| ما يطلبه Dify | `https://api.qcode.cc/openai/v1/chat/completions` | يُبنى من الحقل أعلاه — لا تكتبه |
| `Model Name` | `gpt-6.2-sol` | أي معرّف نموذج تخدمه نقطة النهاية تلك |
| `Model Type` | `LLM` | النوع الذي يجيب طلبات المحادثة |
| `Completion mode` | `Chat` | لا `Completion` |
| `API Key` | `cr_xxxxxxxx` | يُخزَّن مع النموذج، فيُكتب مرة واحدة |

## نقاط نهاية بديلة

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

| نقطة النهاية | أساس متوافق مع OpenAI | أساس متوافق مع Anthropic |
|---|---|---|
| الافتراضي | `https://api.qcode.cc/openai/v1` | `https://api.qcode.cc/api` |
| آسيا | `https://asia.qcode.cc/openai/v1` | `https://asia.qcode.cc/api` |
| أمريكا الشمالية وأوروبا | `https://us.qcode.cc/openai/v1` | `https://us.qcode.cc/api` |

يقبل المضيفان البديلان المفتاح نفسه والمسارات نفسها. وإذا بدّلت المضيف، فعدّل `API Base URL` في بطاقة النموذج وانقر `Add` مرة أخرى للتحقق منه. والتفاصيل الكاملة في [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths).

## ملاحظات الاستضافة الذاتية

- **يحتاج Windows إلى Docker Desktop مع WSL 2.** فمستودع Dify مجموعة خدمات لا تطبيق تنقره نقرة مزدوجة؛ ويشغّلها Docker Desktop، ويطلب الدليل نواتين (2 CPU cores) على الأقل و4 GiB من الذاكرة.
- **المصدر مكانه نظام ملفات Linux.** فالأداء وصلاحيات الملفات أفضل حين يقع مجلد Dify داخل WSL 2 لا على `C:\`.
- **أول تشغيل بطيء.** تُسحب عدة صور حاويات في المرة الأولى، وتبقى الصفحة فارغة حتى تعلن حاوية API جاهزيتها. وأما التشغيلات اللاحقة فتستغرق ثوانٍ.
- **`http://localhost:8080` هي الواجهة لا واجهة API.** لا يلزم تنزيل أي جزء من Dify نفسه للمتصفح؛ فالمنفذ تخدمه الحاويات.
- **لغة واجهة Dify منفصلة عن المتصفح.** تُبدَّل من قائمة الحساب تحت `Preferences` ← `General` ← `Display Language`؛ وهذا الدليل يستخدم الواجهة الإنجليزية، لذا يطابق كل تسمية هنا ما تعرضه اللقطات.

## وثائق ذات صلة

- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths) — كل نطاق دخول ومساراته
- [الفوترة](/docs/reference/billing) — قواعد الحصة المشتركة
- [حلّ المشكلات](/docs/reference/troubleshooting) — عندما يعيد الطلب 401 أو 404 أو خطأ نموذج
- [دليل Claude Code](/docs/getting-started/claude-code-tutorial) — المفتاح نفسه في طرفية
- [طرق الدفع](/docs/reference/payment-methods) — كيف تُدفع قيمة باقة أو خطة