ادموزش اتصال API هوش مصنوعی Mindbase به Khoj
Khoj دستیار شخصی جستجو روی یادداشتها و اسناد شماست. در نسخه خودمیزبان، سرویس مدل از ادمن سرور ساخته میشود: AI Model API با «Api base url» — همان هوک رسمی برای پروکسیهای OpenAI-compatible طبق مستندات LiteLLM خودشان.
پیشنیازها
- Khoj خودمیزبان (Docker).
- کلید API مایندبیس (گام صفر پایین).
گام صفر: دریافت API Key و Base URL از مایندبیس
قبل از هر چیز به دو مقدار نیاز دارید: کلید API و Base URL. هر دو از سایت مایندبیس قابل دریافت هستند:
- وارد حساب کاربری خود در mindbase.ir شوید (ثبتنام رایگان است).
- از منوی پروفایل، بخش «کلیدهای API» را باز کنید.
- روی «+ کلید جدید» بزنید و یک نام دلخواه بدهید؛ مثلاً
Khojتا بعداً بدانید این کلید مال کدام ابزار است. - مقدار کلید را کپی کنید — این کلید با پیشوند
mb_شروع میشود. - Base URL نیز در همین صفحه نمایش داده میشود:
https://api.mindbase.ir/v1
در ادامه همین دو مقدار را در تنظیمات Khoj جایگذاری میکنیم. اگر خواستید مدل دیگری هم امتحان کنید، لیست کامل مدلها (GLM-5.3 در سه سطح توان، مدل سبک سریع و Qwen3.8) در صفحه مدلهای مایندبیس قابل مشاهده است.
مرحله اول: ادمن سرویس
ادمن localhost:42110/server/admin/ (KHOJ_ADMIN_EMAIL/PASSWORD) ← AI Model API.
# UI/DB — ادمن:
AiModelApi : { name: "MindBase", api_key: "mb_...", api_base_url: "https://api.mindbase.ir/v1" }
ChatModelOptions: { chat_model: "MindBase", model_type: "openai" }
مرحله دوم: ثبت مایندبیس
Name = MindBase، Api key = mb_…، Api base url = https://api.mindbase.ir/v1. سپس Chat Model Options: Chat model = MindBase، Model type = OpenAI، در صورت نیاز Vision enabled.
مرحله سوم: پیشفرض
Server Chat Settings ← Default ← مدل جدید. نسخه ابری app.khoj.dev فیلد base-url ندارد؛ این مسیر فقط سلفهاست.
نکات مهم
- فقط سلفهاست: کلاد Khoj فیلد base-url کاربری ندارد.
- Tokenizer: برای مدل OpenAI خالی بگذارید.
- پرچم استریم: در این مسیر ندارد؛ رفتار کلاینت.
رفع مشکلات رایج
- خطای سرویس: Api base url با /v1 و model_type openai.
- ۴۰۱: Api key mb_.
- پاسخ طولانی: chat model را با نام دقیق سرویس بگذارید.
جمعبندی
Khoj خودمیزبان با Api base url در ادمن — سرویس مدلهایش را به مایندبیس میدهد؛ جستجوی شخصی روی مدل ایرانی.
سوالات متداول
Api base url؟
فیلد رسمی برای «پروکسی OpenAI-compatible دیگر» — مستندات و admin.py مرجعاند.
Vision؟
پرچم Vision enabled برای مدلهای تصویری سازگار.
مدلهای GLM؟
AiModelApi جدید یا chat model با model_type openai.