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

LobeChat (نام جدید: LobeHub) یکی از کامل‌ترین رابط‌های چت هوش مصنوعی متن‌باز است — با پلاگین‌ها، مارکت دستیارها، پشتیبانی از تصویر و نسخه دسکتاپ برای ویندوز، مک و لینوکس. LobeChat برای OpenAI یک فیلد آدرس پروکسی دارد که دقیقاً برای سرویس‌هایی مثل مایندبیس طراحی شده؛ یعنی همه مدل‌های مایندبیس بدون واسطه در این رابط اجرا می‌شوند.

در این مقاله اتصال API Mindbase به LobeChat را در دو حالت آموزش می‌دهیم: از رابط کاربری (دسکتاپ و وب) و با متغیرهای محیطی برای استقرار Docker.

پیش‌نیازها

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

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

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

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

روش اول: تنظیم از رابط کاربری

محیط واقعی LobeChat — آموزش تنظیم اتصال به مایندبیس
  1. LobeChat را باز کنید و به App Settings ← AI Providers (در نسخه‌های وب: Settings ← Language Model) بروید.
  2. از لیست Providerها گزینه OpenAI را انتخاب و فعال کنید.
  3. در فیلد API Key کلید mb_... مایندبیس را وارد کنید.
  4. در فیلد API Proxy URL (نام قدیمی: API Proxy Address) بنویسید: https://api.mindbase.ir/v1 — با v1. LobeChat خودش /chat/completions را اضافه می‌کند.
  5. در بخش لیست مدل‌ها، گزینه ساخت مدل سفارشی را بزنید و در پنجره Custom Model Configuration مقدار Model ID را MindBase بگذارید، یک نام نمایشی دلخواه بدهید و برای Maximum Token Count مقدار 110000 را وارد کنید.
  6. مدل را در لیست فعال کنید و از بخش Connectivity Check دکمه Check را بزنید؛ پیام Check Passed باید ببینید.

هشدار مستندات رسمی LobeChat را جدی بگیرید: اگر هنگام تست پاسخ خالی گرفتید، اول مطمئن شوید /v1 انتهای Proxy URL را نگذاشته‌اید (یا برعکس، حذف نکرده باشید) — این شایع‌ترین علت سکوت مدل در LobeChat است. برای مایندبیس آدرس درست همان آدرس با /v1 است.

روش دوم: متغیرهای محیطی (Docker)

برای استقرار سرور خودتان، مایندبیس را به‌عنوان Provider پیش‌فرض تعریف کنید:

OPENAI_API_KEY=mb_xxxxxxxxxxxxxxxxxxxxxxxx
OPENAI_PROXY_URL=https://api.mindbase.ir/v1
OPENAI_MODEL_LIST=-all,+MindBase,+GLM-5.3-High,+GLM-5.3-Flash-Low,+Qwen3.8-27b

متغیر OPENAI_MODEL_LIST لیست مدل‌های OpenAI را کنترل می‌کند: با -all همه پیش‌فرض‌ها حذف و با + مدل‌های مایندبیس اضافه می‌شوند؛ با فرمت نام=نام نمایشی هم می‌توانید برچسب فارسی بدهید (مثلاً MindBase=مایندبیس). بعد از تغییر متغیرها کانتینر را ری‌استارت کنید.

تست نهایی

  1. در صفحه چت، مدل MindBase را از انتخابگر بزنید.
  2. یک پیام فارسی بفرستید و استریم پاسخ را ببینید.
  3. اگر خواستید توان بالاتر امتحان کنید، مدل GLM-5.3-Max را هم با همین روش اضافه و فعال کنید.

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

  • پاسخ خالی یا سکوت مدل: طبق مستندات رسمی، Proxy URL را بررسی کنید — برای مایندبیس باید با /v1 باشد؛ نبودنش باعث درخواست به مسیر اشتباه می‌شود.
  • مدل در انتخابگر نیست: مدل را با Custom Model اضافه کنید و بعد حتماً در لیست همان Provider فعال (روشن) کنید؛ مدل غیرفعال در چت دیده نمی‌شود.
  • خطای ۴۰۱ در Check: کلید اشتباه است؛ کلید mb_ را بدون فاصله اضافه از پروفایل مایندبیس کپی کنید.
  • تغییر متغیرهای محیطی اثری ندارد: کانتینر باید بعد از هر تغییر ری‌استارت شود؛ لیست مدل‌های محیطی با لیست UI یکی است و تداخل نکنید.

جمع‌بندی

LobeChat با سه مقدار به مایندبیس وصل می‌شود: کلید mb_، آدرس پروکسی https://api.mindbase.ir/v1 و Model ID هایی مثل MindBase. بعد از آن، دنیای کامل LobeChat — دستیارهای مارکت، پلاگین‌ها، چت چندمدلی و نسخه دسکتاپ — روی مدل‌های مایندبیس در دسترس شماست.

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

در API Proxy URL باید v1 بنویسم؟

بله. مایندبیس مسیر کاملش https://api.mindbase.ir/v1 است و LobeChat فقط /chat/completions را اضافه می‌کند؛ اگر /v1 را حذف کنید درخواست به مسیر اشتباه می‌رود.

چرا مدل مایندبیس بعد از افزودن باز هم در چت نیست؟

افزودن مدل و فعال‌کردنش دو کار جدا هستند؛ بعد از ساخت Custom Model، سوییچ فعال‌سازی همان مدل در لیست را روشن کنید.

آیا می‌توان همزمان مدل محلی Ollama و مایندبیس را داشت؟

بله؛ LobeChat هم‌زمان چند Provider را پشتیبانی می‌کند. Ollama را روی Provider خودش تنظیم کنید و مایندبیس را روی OpenAI با Proxy URL — و بین مدل‌ها در یک چت جابجا شوید.

فرمت OPENAI_MODEL_LIST چطور است؟

مدل‌ها با ویرگول جدا می‌شوند؛ + یعنی افزودن، - یعنی حذف و نام=نام نمایشی برچسب دلخواه می‌دهد. با -all,+MindBase فقط مدل‌های مایندبیس نمایش داده می‌شوند.