آموزش اتصال API هوش مصنوعی Mindbase به Void (ادیتور متن‌باز)

Void جایگزین متن‌باز Cursor برای تجربه ادیتوری با مدل دلخواه است (توجه: ریپو رسماً deprecated شده ولی فایل‌های رسمی برای همین نسخه معتبرند). پروایدر آماده OpenAI-Compatible: baseURL و کلید و نام مدل در Settings.

پیش‌نیازها

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

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

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

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

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

مرحله اول: تنظیمات مدل

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

آیکون چرخ‌دنده ← تب 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؟

توسعه‌دهنده‌ها ریپو را تعطیل کرده‌اند؛ برای استفاده فعلی مشکلی نیست.