آموزش اتصال API هوش مصنوعی Mindbase به NextChat

NextChat (با نام قبلی ChatGPT-Next-Web) یکی از پراستفاده‌ترین رابط‌های چت متن‌باز است که هم به‌صورت وب‌اپلیکیشن و هم به‌صورت اپ دسکتاپ (ویندوز، مک، لینوکس) اجرا می‌شود. NextChat از Endpoint سفارشی پشتیبانی می‌کند و مایندبیس را می‌توان بدون هیچ واسطی به‌عنوان سرویس پشت آن قرار داد.

نکته کلیدی این آموزش یک تفاوت ظریف است: برخلاف بیشتر ابزارها، در NextChat آدرس API را بدون /v1 وارد می‌کنیم — اگر این نکته را رعایت نکنید درخواست‌ها به مسیر اشتباه می‌روند و خطای ۴۰۴ می‌گیرید.

پیش‌نیازها

  • NextChat روی دسکتاپ نصب شده یا نسخه وب در دسترس است (برای وب خودمیزبان از مخزن رسمی).
  • کلید API و Base URL مایندبیس (گام صفر پایین).

گام صفر: دریافت API Key و Base URL از مایندبیس

قبل از هر چیز به دو مقدار نیاز دارید: کلید API و Base URL. هر دو از سایت مایندبیس قابل دریافت هستند:

  1. وارد حساب کاربری خود در mindbase.ir شوید (ثبت‌نام رایگان است).
  2. از منوی پروفایل، بخش «کلیدهای API» را باز کنید.
  3. روی «+ کلید جدید» بزنید و یک نام دلخواه بدهید؛ مثلاً NextChat.
  4. مقدار کلید را کپی کنید — این کلید با پیشوند mb_ شروع می‌شود.
  5. Base URL نیز در همین صفحه نمایش داده می‌شود: https://api.mindbase.ir/v1 — اما دقت کنید در NextChat فقط تا دامنه را می‌بریم.
دریافت کلید API و Base URL از پنل کاربری مایندبیس

روش اول: تنظیم در خود برنامه (دسکتاپ/وب)

محیط واقعی NextChat — آموزش تنظیم اتصال به مایندبیس
  1. NextChat را باز کنید و از منوی کنار صفحه روی Settings (چرخ‌دنده) کلیک کنید.
  2. در لیست تنظیمات، سوییچ Custom Endpoint را روشن کنید.
  3. در منوی Model Provider همان بخش، گزینه OpenAI را انتخاب کنید.
  4. در فیلد OpenAI Endpoint بنویسید: https://api.mindbase.ir — بدون /v1 انتهایی.
  5. در فیلد OpenAI API Key کلید mb_... مایندبیس را وارد کنید.
  6. پایین‌تر، در فیلد Custom Models بنویسید: MindBase (اگر مدل دیگری هم می‌خواهید، با ویرگول انگلیسی جدا کنید؛ مثل MindBase,GLM-5.3-High,GLM-5.3-Flash-Low).
  7. تنظیمات را ببندید؛ ذخیره خودکار است.

چرا بدون /v1؟ چون NextChat مسیر v1/chat/completions را خودش به انتهای Endpoint می‌چسباند. اگر آدرس را با /v1 بدهید، آدرس نهایی می‌شود /v1/v1/chat/completions و خطای ۴۰۴ می‌گیرید. همچنین NextChat لیست مدل‌ها را از سرور نمی‌گیرد؛ تنها راه دیدن مدل‌های مایندبیس، همان فیلد Custom Models است.

روش دوم: متغیرهای محیطی برای استقرار سرور

اگر NextChat را خودتان روی سرور یا Vercel اجرا می‌کنید، می‌توانید مایندبیس را به‌عنوان سرویس پیش‌فرض کل نصب تنظیم کنید تا کاربران بدون واردکردن کلید استفاده کنند:

OPENAI_API_KEY=mb_xxxxxxxxxxxxxxxxxxxxxxxx
BASE_URL=https://api.mindbase.ir
CUSTOM_MODELS=+MindBase,+GLM-5.3-High,+GLM-5.3-Flash-Low,+Qwen3.8-27b

در این حالت کلید سمت سرور می‌ماند و اگر می‌خواهید کلاینت آن را نبیند، متغیر HIDE_USER_API_KEY=1 را هم اضافه کنید. برای محدودکردن دسترسی به خود اپ، از متغیر CODE به‌عنوان رمز ورود استفاده کنید.

تست نهایی

  1. به صفحه چت برگردید و از انتخابگر مدل، مدل MindBase را بزنید.
  2. یک پیام فارسی بفرستید؛ پاسخ باید استریم شود.

رفع مشکلات رایج

  • خطای ۴۰۴: علت شماره یک در NextChat، اضافه‌کردن /v1 به Endpoint است. آدرس را به https://api.mindbase.ir برگردانید.
  • مدل MindBase در انتخابگر نیست: NextChat لیست مدل‌ها را واکشی نمی‌کند؛ مدل را در Custom Models بنویسید. فرمت‌های +=افزودن، -=حذف و نام=نام نمایشی پشتیبانی می‌شود.
  • خطای ۴۰۱: کلید اشتباه است؛ دوباره از پروفایل مایندبیس کپی کنید.
  • در نسخه سرور، درخواست‌ها جواب نمی‌دهند: BASE_URL باید از خود سرور قابل دسترس باشد؛ بعد از تغییر متغیرها، سرویس را ری‌استارت کنید.

جمع‌بندی

اتصال NextChat به مایندبیس سه مقدار بیشتر ندارد: Endpoint بدون /v1، کلید mb_ و مدل‌های دلخواه در Custom Models. بعد از آن، رابط سبک و سریع NextChat — با پشتیبانی از ماسک‌ها و اشتراک‌گذاری گفتگو — روی مدل‌های مایندبیس اجرا می‌شود.

سوالات متداول

چرا در NextChat باید آدرس را بدون v1 وارد کنم؟

چون NextChat خودش مسیر v1/chat/completions را به Endpoint اضافه می‌کند؛ واردکردن /v1 باعث می‌شود مسیر نهایی /v1/v1/... شود و سرور ۴۰۴ برگرداند.

مدل‌های مایندبیس خودکار در لیست می‌آیند؟

خیر. NextChat لیست مدل‌ها را از سرور نمی‌گیرد؛ باید شناسه مدل‌ها را در فیلد Custom Models (یا متغیر CUSTOM_MODELS) دستی وارد کنید.

آیا Embeddings مایندبیس در NextChat کار می‌کند؟

نه؛ پروکسی داخلی NextChat فقط مسیرهای چت و چند مسیر محدود را مجاز می‌داند. برای RAG و Embeddings بهتر است از Open WebUI یا اتصال مستقیم SDK استفاده کنید.

آیا این تنظیم در نسخه دسکتاپ و وب یکی است؟

بله؛ در نسخه دسکتاپ درخواست مستقیم از دستگاه شما به مایندبیس می‌رود و در نسخه وب خودمیزبان، از سرور NextChat به مایندبیس پروکسی می‌شود — مقادیر در هر دو یکسان است.