آموزش اتصال API هوش مصنوعی Mindbase به Void (ادیتور متنباز)
Void جایگزین متنباز Cursor برای تجربه ادیتوری با مدل دلخواه است (توجه: ریپو رسماً deprecated شده ولی فایلهای رسمی برای همین نسخه معتبرند). پروایدر آماده OpenAI-Compatible: baseURL و کلید و نام مدل در Settings.
پیشنیازها
- Void نصبشده.
- کلید API مایندبیس (گام صفر پایین).
گام صفر: دریافت API Key و Base URL از مایندبیس
قبل از هر چیز به دو مقدار نیاز دارید: کلید API و Base URL. هر دو از سایت مایندبیس قابل دریافت هستند:
- وارد حساب کاربری خود در mindbase.ir شوید (ثبتنام رایگان است).
- از منوی پروفایل، بخش «کلیدهای API» را باز کنید.
- روی «+ کلید جدید» بزنید و یک نام دلخواه بدهید؛ مثلاً
Voidتا بعداً بدانید این کلید مال کدام ابزار است. - مقدار کلید را کپی کنید — این کلید با پیشوند
mb_شروع میشود. - Base URL نیز در همین صفحه نمایش داده میشود:
https://api.mindbase.ir/v1
در ادامه همین دو مقدار را در تنظیمات Void جایگذاری میکنیم. اگر خواستید مدل دیگری هم امتحان کنید، لیست کامل مدلها (GLM-5.3 در سه سطح توان، مدل سبک سریع و Qwen3.8) در صفحه مدلهای مایندبیس قابل مشاهده است.
مرحله اول: تنظیمات مدل
آیکون چرخدنده ← تب Models / Main Providers ← پروایدر «OpenAI-Compatible» (زیرنویس: llama.cpp و امثال آن).
# UI-only:
OpenAI-Compatible:
baseURL : https://api.mindbase.ir/v1
API Key : mb_xxxxxxxxxxxxxxxxxxxxxxxx
Model Name: MindBase
مرحله دوم: آدرس و کلید
API Key = mb_… و baseURL = https://api.mindbase.ir/v1 — در کامنت منبع رسمی تأکید: /chat/completions اضافه نکنید.
مرحله سوم: مدل
«Add a model»: پروایدر dropdown + Model Name = MindBase. در سلکتور چت/ایجنت انتخاب کنید؛ قابلیتهای per-model در تنظیمات مدل.
نکات مهم
- deprecated: ریپو دیگر contribution نمیگیرد؛ تنظیمات موجود همان است.
- استریم: از baseURL/chat/completions جریان میگیرد.
- /models: لیست مدل detection میشود (ستاره «Detected locally»).
رفع مشکلات رایج
- پاسخ نیست: baseURL بدون /chat/completions.
- ۴۰۱: کلید mb_.
- مدل نیست: Add a model دستی.
جمعبندی
Void (حتی با وضعیت deprecated) با پروایدر OpenAI-Compatible — baseURL + کلید + مدل MindBase — تجربه ادیتوری با مدل ایرانی میسازد.
سوالات متداول
OpenAI-Compatible دقیقاً؟
پروایدر رسمی Void با زیرنویس «OpenAI-compatible (llama.cpp و…)».
مدلهای دیگر؟
Add a model با نام دقیق API.
چرا deprecated؟
توسعهدهندهها ریپو را تعطیل کردهاند؛ برای استفاده فعلی مشکلی نیست.