آموزش اتصال API هوش مصنوعی Mindbase به Jan
Jan چتیوبای محلی متنباز با رابط زیباست که مدلهای راه دور را هم میپذیرد. مسیر رسمی: Add Custom Provider با API format اوپنای — Base URL باید /v1 داشته باشد و اگر سرویس لیست مدل نداشت، مدل را دستی اضافه میکنید.
پیشنیازها
- اپ Jan نصبشده (menloresearch/jan).
- کلید API مایندبیس (گام صفر پایین).
گام صفر: دریافت API Key و Base URL از مایندبیس
قبل از هر چیز به دو مقدار نیاز دارید: کلید API و Base URL. هر دو از سایت مایندبیس قابل دریافت هستند:
- وارد حساب کاربری خود در mindbase.ir شوید (ثبتنام رایگان است).
- از منوی پروفایل، بخش «کلیدهای API» را باز کنید.
- روی «+ کلید جدید» بزنید و یک نام دلخواه بدهید؛ مثلاً
Janتا بعداً بدانید این کلید مال کدام ابزار است. - مقدار کلید را کپی کنید — این کلید با پیشوند
mb_شروع میشود. - Base URL نیز در همین صفحه نمایش داده میشود:
https://api.mindbase.ir/v1
در ادامه همین دو مقدار را در تنظیمات Jan جایگذاری میکنیم. اگر خواستید مدل دیگری هم امتحان کنید، لیست کامل مدلها (GLM-5.3 در سه سطح توان، مدل سبک سریع و Qwen3.8) در صفحه مدلهای مایندبیس قابل مشاهده است.
مرحله اول: ساخت پروایدر
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 با همان پروایدر؛ دستی اضافه کنید.