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

Aider یکی از قدیمی‌ترین و محبوب‌ترین ابزارهای جفت‌برنامه‌نویسی با AI در ترمینال است: به مخزن گیت وصل می‌شود، فایل‌ها را ویرایش می‌کند و کامیت می‌زند. Aider زیرساخت مدل‌هایش با LiteLLM ساخته شده و برای سرویس‌های سازگار با OpenAI مسیر رسمی دارد: متغیر OPENAI_API_BASE و مدل با پیشوند openai/. مایندبیس دقیقاً با همین مسیر وصل می‌شود.

پیش‌نیازها

  • نصب Aider طبق aider.chat: python -m pip install aider-install && aider-install.
  • کلید API مایندبیس (گام صفر پایین).

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

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

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

مرحله اول: تنظیم متغیرها در .env پروژه

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

Aider فایل .env در ریشه پروژه را خودکار می‌خواند؛ در ریشه مخزن گیت‌تان این سه خط را بگذارید:

OPENAI_API_BASE=https://api.mindbase.ir/v1
OPENAI_API_KEY=mb_xxxxxxxxxxxxxxxxxxxxxxxx
AIDER_MODEL=openai/MindBase

یا اگر ترجیح می‌دهید متغیرها را سراسری بدهید (ویندوز):

setx OPENAI_API_BASE https://api.mindbase.ir/v1
setx OPENAI_API_KEY mb_xxxxxxxxxxxxxxxxxxxxxxxx

و در لینوکس/مک با export در فایل ~/.bashrc. بعد از setx حتماً ترمینال را دوباره باز کنید.

مرحله دوم: اجرا

aider

Aider با مدل openai/MindBase بالا می‌آید. پیشوند openai/ تعیین می‌کند درخواست‌ها از مسیر سازگار-OpenAI (با BASE_URL شما) برود؛ دقت کنید این پیشوند حذف نشود، وگرنه Aider مدل را در سرویس رسمی OpenAI جستجو می‌کند.

اگر نمی‌خواهید از .env استفاده کنید، همان مقادیر را خط فرمانی هم می‌شود داد:

aider --model openai/MindBase --openai-api-base https://api.mindbase.ir/v1 --openai-api-key mb_xxx

مرحله سوم: یک جلسه کاری معمول

  1. داخل مخزن، aider را اجرا کنید.
  2. درخواست فارسی بدهید؛ مثلاً: «تابع اعتبارسنجی فرم ثبت‌نام را در فایل auth.py اضافه کن».
  3. Aider فایل‌ها را ویرایش می‌کند و diff پیشنهادی را نشان می‌دهد؛ با تایید شما کامیت می‌زند.

هشدار معمول اول اجرا: Aider چون متادیتای مدل‌های مایندبیس را از قبل در فهرستش ندارد، پیام «unknown model» می‌دهد — طبیعی است و به کار ادامه بدهید؛ هزینه‌ی توکن هم از حساب مایندبیس محاسبه می‌شود، نه از نرخ‌های نمایشی Aider.

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

  • خطای ۴۰۴: مطمئن شوید OPENAI_API_BASE با /v1 است — Aider/LiteLLM مسیر /chat/completions را خودش می‌چسباند و اگر v1 را حذف کنید به ریشه دامنه می‌زند.
  • خطای ۴۰۱: کلید اشتباه است؛ کلید mb_ را بدون فاصله از پروفایل مایندبیس کپی کنید.
  • مدل اشتباه صدا زده می‌شود: پیشوند openai/ در نام مدل لازم است؛ --model MindBase بدون پیشوند به مسیر دیگری می‌رود.
  • متغیرها اثر نمی‌کنند: بعد از setx، ترمینال جدید باز کنید؛ و مطمئن شوید فایل .env در همان دایرکتوری است که aider را اجرا می‌کنید.

جمع‌بندی

اتصال Aider به مایندبیس سه خط بیشتر نیست: OPENAI_API_BASE با /v1، کلید mb_ و مدل openai/MindBase. بعد از آن، جفت‌برنامه‌نویسی ترمینالی با ویرایش فایل، diff و کامیت خودکار — همه روی مدل‌های مایندبیس اجرا می‌شود.

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

چرا مدل با پیشوند openai/ نوشته می‌شود؟

چون این پیشوند به Aider می‌گوید از کلاینت سازگار-OpenAI (LiteLLM داخلی) با BASE_URL شما استفاده کند؛ بدون پیشوند، مدل در فهرست سرویس رسمی OpenAI جستجو می‌شود.

آدرس پایه باید v1 داشته باشد یا نه؟

بله؛ مسیر پایه کامل https://api.mindbase.ir/v1 است و Aider فقط انتهای مسیر درخواست را اضافه می‌کند.

می‌توانم مدل دوگانه داشته باشم (سخت/سبک)؟

بله؛ Aider گزینه‌های weak-model و architect دارد — مثلاً MindBase برای مدل اصلی و GLM-5.3-Flash-Low برای کارهای سبک؛ همان‌ها را با پیشوند openai/ در .env بدهید.

تغییر مدل حین جلسه ممکن است؟

بله؛ با دستور /model openai/GLM-5.3-Max وسط جلسه جابجا شوید.