Dify خودمیزبان روی ویندوز ۱۱: اتصال QCode قدم‌به‌قدم (۱۳ تصویر)

Dify را روی ویندوز ۱۱ با Docker Desktop اجرا کنید و QCode را به‌عنوان مدلی سازگار با OpenAI اضافه کنید: ۱۳ تصویر شماره‌دار از نصب تا نخستین پاسخ.

به‌روزرسانی 2026-11-23

به کلید API نیاز دارید؟ ثبت‌نام ←نقاط پایانی و Base URL ←

در این صفحه

پاسخ کوتاه: در 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 Base URL https://api.qcode.cc/openai/v1
نام مدل gpt-6.2-sol
نوع مدل / حالت تکمیل LLM / Chat
کلید API cr_xxxxxxxx

بررسی‌شده در 2026-11-22 · Dify 1.20.0 · ویندوز ۱۱

۱۳ تصویر زیر را روی یک رایانه ویندوز ۱۱ دنبال کنید و در پایان QCode داخل Dify پاسخ می‌دهد: یک اپ Chatbot در Studio که به نخستین پیام شما پاسخ می‌دهد. خود Dify به حساب هیچ ارائه‌دهنده مدلی نیاز ندارد — تنها اعتبارنامه اینجا کلید API QCode است.

  • مناسب برای: ویندوز ۱۰ / ۱۱ (۶۴ بیتی) با Docker Desktop و WSL 2؛ تصویرها ویندوز ۱۱ را نشان می‌دهند
  • نسخه نرم‌افزار: Dify Community Edition 1.20.0 + افزونه OpenAI-API-compatible 0.0.87
  • تصویرها به‌روزرسانی شده در: 2026-11
  • زمان لازم: حدود ۲۵ دقیقه، به‌علاوه دانلود نخستین ایمیج Docker
  • چیزهایی که لازم دارید: یک کلید API از QCode که با cr_ شروع می‌شود

پیش از نخستین تصویر، بررسی کنید که این‌ها را دارید:

  • یک رایانه ویندوز ۱۰ یا ۱۱، ۶۴ بیتی، که می‌تواند وب‌سایت باز کند و دست‌کم ۲ هسته CPU و ۴ گیگابایت حافظه برای Docker نگه می‌دارد
  • یک مرورگر — Edge یا Chrome — چون Dify اپ دسکتاپ ندارد؛ تمام آموزش در یک تب مرورگر اجرا می‌شود
  • یک نمونه Dify که می‌توانید به آن وارد شوید: استقرار Docker Compose خودتان روی http://localhost:8080، یا Dify Cloud در cloud.dify.ai
  • یک کلید API از QCode که از داشبورد خود کپی کرده‌اید (cr_xxxxxxxx)؛ این تنها موردی است که نمی‌توانید از آن صرف‌نظر کنید. هنوز حساب ندارید؟ ابتدا ثبت‌نام کنید، در صفحه قیمت‌ها یک پلن انتخاب کنید و سپس در داشبورد کلید بسازید.

دانلود و نصب Dify

Dify یک سرویس وب است، پس هیچ نصب‌کننده ویندوزی برای رابط Dify وجود ندارد. یا Dify Cloud را در مرورگر باز می‌کنید، یا همان رابط را به‌صورت محلی با Docker Compose اجرا می‌کنید. هر دو مسیر به همان صفحه Model Provider می‌رسند که قدم‌های زیر از آن استفاده می‌کنند. تبی را انتخاب کنید که با وضعیت شما می‌خواند:

dify.ai را باز کنید و از مسیر Cloud استفاده کنید: در cloud.dify.ai ثبت‌نام کنید و تمام آموزش در مرورگر اجرا می‌شود.

برای استقرار محلی، راهنمای رسمی Docker Compose را در docs.dify.ai باز کنید، Docker Desktop را از docker.com نصب کنید (ویندوز، x64)، با توافق‌نامه موافقت کنید و بک‌اند Use WSL 2 را نگه دارید. نصب‌کننده به دسترسی مدیر نیاز دارد و معمولاً راه‌اندازی مجدد می‌خواهد. مخزن راهنما همچنین GitHub Releases دارد، که در آن فایل ویندوزی difyctl-v1.20.0-windows-x64.exe یک ابزار خط فرمان برای مدیران است — این رابط Dify نیست، پس انتظار نداشته باشید پنجره‌ای از آن باز شود. پس از docker compose up -d، رابط در http://localhost:8080 است.

dify.ai را باز کنید و از مسیر Cloud استفاده کنید: رابط سپس در cloud.dify.ai قرار دارد و هیچ چیزی روی رایانه نصب نمی‌شود.

اگر می‌خواهید رابط به‌جای آن روی دستگاه خودتان باشد، راهنمای رسمی Docker Compose را در docs.dify.ai باز کنید و آن را با Docker Desktop دنبال کنید. ابتدا Docker Desktop را از docker.com نصب کنید. اگر صفحه‌ای کند باز می‌شود یا دانلودی متوقف می‌شود، یک دقیقه صبر کنید و دوباره شروع کنید — صفحه و نصب‌کننده از همان میزبان ارائه می‌شوند، پس تلاش دوباره بعداً معمولاً هر دو را درست می‌کند.

ابتدا صفحه نیازمندی‌ها را بخوانید

پیش از دانلود هر چیزی، راهنمای رسمی Docker Compose را باز کنید. ① عنوان صفحه تأیید می‌کند که در صفحه خودمیزبانی Docker Compose هستید، و ② بلوک پیش‌نیازها چیزهایی را که ماشین باید فراهم کند فهرست می‌کند: دست‌کم ۲ هسته CPU، ۴ گیگابایت RAM و خود Docker Compose.

راهنمای رسمی خودمیزبانی Dify با Docker Compose، با عنوان صفحه در بالا و بلوک پیش‌نیازهای سخت‌افزاری و نرم‌افزاری در پایین آن

اگر درست پیش بروید این را می‌بینید: ① عنوان صفحه نصب Docker Compose، و ② فهرست پیش‌نیازها با خطوط CPU، حافظه و Docker Compose که در یک صفحه خوانا هستند.

گیر کرده‌اید؟ صفحه روش نصب دیگری نشان می‌دهد

Dify مستندات Docker Compose و Kubernetes را کنار هم دارد و نتایج جست‌وجو گاهی به صفحه Kubernetes می‌رسند. به بالا بروید و بررسی کنید که آدرس شامل docker-compose باشد؛ این همان مسیری است که این آموزش استفاده می‌کند.

نصب Docker Desktop

Dify روی ویندوز در کانتینرها اجرا می‌شود، پس اول Docker Desktop لازم است. در docker.com روی ① Download Docker Desktop کلیک کنید، فایل دانلودشده Docker Desktop Installer.exe را اجرا کنید، با توافق‌نامه موافقت کنید و بک‌اند Use WSL 2 را انتخاب‌شده نگه دارید. نصب‌کننده دسترسی مدیر می‌خواهد و معمولاً راه‌اندازی مجدد پیشنهاد می‌دهد؛ آن را بپذیرید.

صفحه رسمی دانلود Docker Desktop با دکمه Download Docker Desktop

اگر درست پیش بروید این را می‌بینید: دانلود از دکمه ① شروع می‌شود، و پس از نصب آیکون نهنگ در ناحیه اعلان با وضعیت Engine running ظاهر می‌شود.

گیر کرده‌اید؟ ویندوز «Windows protected your PC» نشان می‌دهد

روی More info و سپس Run anyway کلیک کنید. SmartScreen این کادر را برای نصب‌کننده‌هایی نشان می‌دهد که به‌اندازه کافی ندیده است؛ فایل همان چیزی است که دکمه ① تازه دانلود کرده است.

به نمونه Dify خود وارد شوید

http://localhost:8080 را در مرورگر باز کنید. نخستین بازدید به صفحه /install می‌رود، جایی که حساب مدیر را با یک نشانی ایمیل و یک رمز عبور می‌سازید؛ هر بازدید بعدی صفحه ورود را باز می‌کند. ایمیل و رمز را در ① وارد کنید، سپس روی ② Sign in کلیک کنید.

صفحه ورود یک نمونه Dify خودمیزبان با فیلدهای ایمیل و رمز عبور و دکمه Sign in

اگر درست پیش بروید این را می‌بینید: ① هر دو فیلد پر شده و رمز با نقطه پوشیده شده، ② Sign in آبی می‌شود، و پس از کلیک صفحه اصلی Dify با نام فضای کاری در گوشه بالا-چپ.

گیر کرده‌اید؟ مرورگر می‌گوید سایت در دسترس نیست

کانتینرها هنوز در حال اجرا نیستند. Docker Desktop را باز کنید، منتظر Engine running بمانید، سپس در پوشه سورس Dify دستور docker compose up -d را اجرا کنید و صفحه را تازه کنید. نخستین شروع چند ایمیج را می‌کشد و کمی طول می‌کشد.

باز کردن Integrations

صفحه اصلی Dify پس از ورود باز می‌شود. تمام ناوبری در یک ستون در سمت چپ قرار دارد: Home، Studio، Agents، Knowledge، Contacts، Skills، Integrations، Marketplace. روی ① Integrations کلیک کنید؛ Dify مستقیم شما را به Model Provider می‌برد.

صفحه اصلی Dify با ناوبری نوار کناری چپ و ورودی Integrations برجسته‌شده

اگر درست پیش بروید این را می‌بینید: ① Integrations در ستون چپ برجسته است، و صفحه پشت آن عنوان Model Provider با جعبه Search models... در بالا دارد.

جست‌وجوی ارائه‌دهنده OpenAI-API-compatible

Model Provider هر یکپارچه‌سازی‌ای را که Dify می‌تواند با آن صحبت کند فهرست می‌کند. روی ① جعبه Search models... کلیک کنید و OpenAI-API-compatible را تایپ کنید. ② کارت مطابق در فهرست ظاهر می‌شود، با دکمه آبی Install روی آن.

صفحه Model Provider با عبارت OpenAI-API-compatible تایپ‌شده در جعبه جست‌وجو و کارت ارائه‌دهنده مطابق فهرست‌شده در پایین

اگر درست پیش بروید این را می‌بینید: ① متن شما در جعبه جست‌وجو، و ② یک کارت با نام OpenAI-API-compatible با دکمه Install — نه OpenAI که افزونه دیگری است.

گیر کرده‌اید؟ جست‌وجو چیزی برنمی‌گرداند

فقط OpenAI را تایپ کنید و فهرست را به پایین بروید. نصب افزونه‌ها به مالک فضای کاری یا یک مدیر نیاز دارد، پس حساب یک عضو ممکن است کارت‌ها را بدون دکمه Install ببیند. پس از نصب، پیش از جست‌وجوی دوباره صفحه را تازه کنید.

تأیید نصب افزونه

کلیک روی Install روی کارت، به‌جای نصب فوری، پنجره‌ای با عنوان Install Integration باز می‌کند. نام داخل پنجره را بخوانید و روی ① Install در پایین پنجره کلیک کنید. سپس Dify افزونه را از Marketplace خودش دانلود می‌کند که چند ثانیه طول می‌کشد.

پنجره تأیید Install Integration با دکمه آبی Install در پایین آن

اگر درست پیش بروید این را می‌بینید: ① پنجره خودبه‌خود بسته می‌شود، و کارت 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 در سمت راست آن

اگر درست پیش بروید این را می‌بینید: ① 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 پر از نقطه

به کلید API نیاز دارید؟

اگر هنوز حساب QCode ندارید، ابتدا ثبت‌نام کنید. اگر پلن ماهانه نمی‌خواهید، از صفحه بسته‌های پرداخت به‌ازای مصرف یک بسته بخرید و سپس در داشبورد کلید بسازید. رشته‌ای را که با cr_ شروع می‌شود کپی کنید و به‌جای cr_xxxxxxxx بچسبانید. می‌توانید با کارت اعتباری یا نقدی (Visa / Mastercard)، Apple Pay / Google Pay، یا رمزارز پرداخت کنید — به روش‌های پرداخت مراجعه کنید.

اگر درست پیش بروید این را می‌بینید: ① 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

اگر درست پیش بروید این را می‌بینید: ① نشانی با /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 در بالا-راست

اگر درست پیش بروید این را می‌بینید: ① یک ردیف مدل با 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

اگر درست پیش بروید این را می‌بینید: ① 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

اگر درست پیش بروید این را می‌بینید: ① 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

اگر درست پیش بروید این را می‌بینید: ① 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 برای System Reasoning Model مقدار gpt-6.2-sol را نشان می‌دهد، نه یک ردیف خالی.
  • QCode Assistant در Debug & Preview پاسخ می‌دهد و پاسخ به‌صورت جریان می‌رسد، نه به‌صورت خطای 401، 404 یا «model not found».
  • تب مرورگر را ببندید، دوباره Dify را باز کنید و مدل، تنظیم پیش‌فرض و اپ همه هنوز سر جای خود باشند.

تمام شد

شما QCode را به Dify وصل کرده‌اید و یک اپ Chatbot از طریق آن پاسخ می‌دهد. از اینجا می‌توانید:

خطاهای رایج

متن خطا علت چه کار کنید
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 می‌سازید. در هر دو حالت، کلیدی که به مدل می‌رسد کلید cr_ QCode شماست و هیچ‌جای این آموزش ورود به 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 است. ۱۳ تصویر این صفحه افزونه سازگار با 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 است.

نکات خودمیزبانی

  • ویندوز به Docker Desktop به‌همراه WSL 2 نیاز دارد. مخزن Dify مجموعه‌ای از سرویس‌هاست، نه اپی که با دوبار کلیک اجرا شود؛ Docker Desktop آن‌ها را اجرا می‌کند، و راهنما دست‌کم ۲ هسته CPU و ۴ گیگابایت RAM می‌خواهد.
  • سورس باید روی فایل‌سیستم لینوکس باشد. کارایی و مجوزهای فایل بهتر عمل می‌کنند وقتی پوشه Dify داخل WSL 2 باشد نه روی C:\.
  • نخستین شروع کند است. نخستین بار چند ایمیج کانتینر کشیده می‌شود و صفحه خالی می‌ماند تا کانتینر API آماده را گزارش کند. شروع‌های بعدی چند ثانیه طول می‌کشند.
  • http://localhost:8080 رابط است، نه API. برای مرورگر هیچ چیزی از خود Dify لازم نیست دانلود شود؛ پورت را کانتینرها ارائه می‌دهند.
  • زبان رابط Dify از مرورگر جداست. آن را در منوی حساب زیر Preferences → General → Display Language عوض می‌کنید؛ این آموزش از رابط انگلیسی استفاده می‌کند، پس هر برچسب اینجا با آنچه تصویرها نشان می‌دهند می‌خواند.

مستندات مرتبط

با QCode شروع کنید

یک کلید API برای Claude Code، Codex و بیشتر — بر اساس توکن، قیمت هر مدل در qcode.cc/models

سازمانی ←