مایندبیس و Ollama؛ مسیر درست اتصال

این سوال زیاد پرسیده می‌شود: «چطور Ollama را به API مایندبیس وصل کنم؟» پاسخ کوتاه: از داخل Ollama، هیچ راهی وجود ندارد — و قرار هم نیست داشته باشد. Ollama یک ران‌تایم محلی است؛ یعنی مدل‌های GGUF را روی سیستم خودتان اجرا می‌کند و آن‌ها را از طریق API لوکال (http://localhost:11434) سرو می‌کند. Ollama «سرویس‌دهنده» است نه «مصرف‌کننده» — هیچ تنظیم یا متغیری ندارد که بتوان به‌جای مدل محلی، یک API راه دور مثل مایندبیس را به آن داد.

در این مقاله دقیق توضیح می‌دهیم چرا این اتصال ممکن نیست، راه‌های واسطه (مثل LiteLLM) چرا جواب نمی‌دهند، و مسیر درست برای رسیدن به همان نتیجه — یعنی استفاده از مدل‌های مایندبیس در ابزارهایی که برای Ollama ساخته شده‌اند — چیست.

چرا Ollama به API راه دور وصل نمی‌شود؟

Ollama دو نقش دارد:

  • سرور بودن: Ollama دو سطح API برای کلاینت‌های دیگر ارائه می‌دهد — فرمت خودش (/api/chat، /api/generate، /api/tags) و زیرمجموعه‌ای از فرمت OpenAI (/v1/chat/completions). یعنی ابزارهای دیگر می‌توانند از Ollama استفاده کنند.
  • مصرف‌کننده بودن: هرگز. Ollama فقط مدل‌های دانلودشده روی دیسک (و مدل‌های کلود خود ollama.com) را اجرا می‌کند؛ امکان تعریف یک آدرس OpenAI-سازگار به‌عنوان Backend وجود ندارد و طبق موضوعات مطرح‌شده در مخزن رسمی هم چنین قابلیتی در نقشه راه نیست.

پس پروکسی چیست؟ چرا LiteLLM جواب نمی‌دهد؟

برخی فکر می‌کنند با یک پروکسی مثل LiteLLM می‌توان مایندبیس را به فرمت Ollama ترجمه کرد. اما تحقیق در سورس LiteLLM نشان می‌دهد این پروکسی فقط دو فرمت را «سرو» می‌کند: OpenAI و Anthropic — هیچ مسیر /api/chat یا /api/tags (فرمت Ollama) در آن وجود ندارد. پروژه‌های کوچک و کم‌کاربر برای این ترجمه هم پیدا می‌شوند، اما نه پایداری و نه امنیت لازم برای استفاده واقعی را دارند؛ توصیه ما اتکا به آن‌ها نیست.

مسیر درست: جایگزین کردن Ollama با Provider باز-سازگار

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

نکته کلیدی این است: تقریباً هر ابزاری که گزینه «Ollama» دارد، به این دلیل دارد که Ollama فرمت OpenAI را هم سرو می‌کند — و برای همین، همان ابزار معمولاً گزینه‌ای به نام OpenAI Compatible / Custom OpenAI هم دارد. و این گزینه، مستقیم به مایندبیس وصل می‌شود:

  1. در ابزار خودتان، به‌جای گزینه Ollama، گزینه OpenAI Compatible (یا Custom Provider از نوع OpenAI) را انتخاب کنید.
  2. در فیلد Base URL بنویسید: https://api.mindbase.ir/v1
  3. در فیلد API Key، کلید مایندبیس (پیشوند mb_، از پروفایل ← کلیدهای API) را وارد کنید.
  4. مدل دلخواه را انتخاب یا اضافه کنید — مدل پیش‌فرض MindBase است.
دریافت کلید API و Base URL از پنل کاربری مایندبیس

مثال‌های مشخص: در Open WebUI به‌جای اتصال Ollama، از اتصال OpenAI استفاده کنید (آموزش جداگانه آن را در همین دسته‌بندی داریم)؛ در n8n به‌جای گره Ollama Chat Model، از گره OpenAI Chat Model با Base URL مایندبیس؛ در Continue و بقیه ابزارهای کدنویسی، Provider از نوع openai. در همه این‌ها نتیجه دقیقاً همان چیزی است که از Ollama می‌خواستید، با این تفاوت که:

  • هیچ گیگابایتی دانلود نمی‌کنید و GPU قوی لازم ندارید.
  • مدل‌ها همیشه به‌روزند (MindBase، GLM-5.3 با بافتار یک میلیون توکن، Qwen3.8).
  • سرعت پاسخ‌دهی روی سخت‌افزارهای معمولی هم عالی است، چون پردازش روی سرور مایندبیس انجام می‌شود.

اگر ابزار من فقط گزینه Ollama دارد؟

در آن حالت — یعنی ابزار صرفاً فرمت /api/chat را می‌فهمد و هیچ گزینه OpenAI ندارد — امروز راه قابل‌اتکایی برای وصل‌کردن آن به مایندبیس وجود ندارد. دو انتخاب دارید: یا ابزار را عوض کنید (گزینه‌های معادل با پشتیبانی OpenAI Compatible زیادند)، یا مدل محلی Ollama را برای آن ابزار نگه دارید و بقیه کارها را با کلاینتی که مایندبیس را می‌پذیرد انجام دهید.

جمع‌بندی

Ollama و مایندبیس دو نقطه مقابل یک طیف‌اند: یکی ران‌تایم محلی و سرویس‌دهنده مدل، دیگری API ابری سازگار با OpenAI. اتصال Ollama به مایندبیس از درون Ollama ممکن نیست و پروکسی‌ها هم فرمت Ollama را سرو نمی‌کنند؛ اما نیازی به این اتصال هم نیست — هر جا Ollama بود، یک Provider باز-سازگار هم هست که مستقیم و بدون واسطه به https://api.mindbase.ir/v1 وصل می‌شود.

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

آیا با OLLAMA_HOST می‌توانم به مایندبیس وصل شوم؟

نه؛ OLLAMA_HOST فقط مشخص می‌کند Ollama روی چه آدرس و پورتی گوش بدهد. برای آدرس دهی به backend راه دور هیچ متغیری وجود ندارد.

آیا MindBase خودش فرمت Ollama هم دارد؟

نه؛ مایندبیس استاندارد OpenAI Chat Completions را ارائه می‌دهد. اگر ابزاری فقط فرمت Ollama را می‌فهمد، قابل اتصال به مایندبیس نیست.

کدام ابزارها هم گزینه Ollama دارند هم OpenAI Compatible؟

تقریباً همه: Open WebUI، n8n، Dify، اپ‌های چت مثل Cherry Studio و Chatbox و ابزارهای کدنویسی مثل Continue. در همه‌شان گزینه OpenAI را انتخاب و Base URL مایندبیس را بدهید.

مزیت مایندبیس نسبت به اجرای محلی چیست؟

بدون دانلود چند گیگابایتی و بدون نیاز به GPU، به مدل‌های قوی و به‌روز با بافتار بزرگ دسترسی دارید؛ مصرف هم به انرژی پلن حساب مایندبیس تبدیل می‌شود که همه‌ش ریالی است.