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

Jan چت‌یوبای محلی متن‌باز با رابط زیباست که مدل‌های راه دور را هم می‌پذیرد. مسیر رسمی: Add Custom Provider با API format اوپن‌ای‌ — Base URL باید /v1 داشته باشد و اگر سرویس لیست مدل نداشت، مدل را دستی اضافه می‌کنید.

پیش‌نیازها

  • اپ Jan نصب‌شده (menloresearch/jan).
  • کلید API مایندبیس (گام صفر پایین).

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

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

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

در ادامه همین دو مقدار را در تنظیمات Jan جای‌گذاری می‌کنیم. اگر خواستید مدل دیگری هم امتحان کنید، لیست کامل مدل‌ها (GLM-5.3 در سه سطح توان، مدل سبک سریع و Qwen3.8) در صفحه مدل‌های مایندبیس قابل مشاهده است.

مرحله اول: ساخت پروایدر

محیط واقعی Jan — آموزش تنظیم اتصال به مایندبیس

Settings ← Model Providers ← Add Provider. در دیالوگ Add Custom Provider: API format = OpenAI-compatible، Provider name (نامی که در سلکتور می‌بینید) = MindBase.

# UI-only — کانفیگ فایل ندارد:
Provider name : MindBase
API format    : OpenAI-compatible
Base URL      : https://api.mindbase.ir/v1   ← /v1 الزامی
API key       : mb_xxxxxxxxxxxxxxxxxxxxxxxx
Models (+)    : MindBase

مرحله دوم: Base URL و کلید

Base URL را https://api.mindbase.ir/v1 بگذارید — مستندات تأکید دارند /v1 الزامی است و اسلش انتهایی حذف می‌شود. کلید mb_ و Create.

مرحله سوم: مدل MindBase

Jan بعد از ساخت، {base}/models را صدا می‌زند؛ اگر لیست خالی ماند، از بخش Models همان پروایدر دکمه + و نام دقیق مدل را بزنید. برای اینکه Tool Calling فعال شود، قابلیت‌ها را با آیکون مداد مدل روشن کنید.

نکات مهم

  • /models خالی: اگر سرویس لیست مدل ندارد، مدل دستی — «No models listed» یعنی همین.
  • قابلیت‌ها: برای مدل‌های custom قابلیت detection ندارد؛ Tools/vision دستی.
  • پارامترها: دمپلینگ ارسال می‌شود اما سرور ممکن است نادیده بگیرد.

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

  • No models listed: مدل دستی با نام دقیق MindBase.
  • ۴۰۴: Base URL بدون /v1 است.
  • ۴۰۱: کلید در همان فرم Add Provider.

جمع‌بندی

Jan با Add Custom Provider (فرمت اوپن‌ای‌ + /v1 + مدل دستی) مایندبیس را در لیست مدل‌هایش می‌گذارد؛ چت‌یوبای محلی حالا مدل ایرانی هم دارد.

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

/v1 لازم است؟

بله — مستندات Jan می‌گویند بدون version path درخواست ۴۰۴ می‌گیرد.

Tools خاموش است؟

مدل custom قابلیت خودکار ندارد؛ با مداد، Tools را روشن کنید.

مدل‌های دیگر؟

هر مدل سازگار-OpenAI با همان پروایدر؛ دستی اضافه کنید.