آموزش اتصال API هوش مصنوعی Mindbase به Flowise
Flowise بیلدر بصری جریانهای زنجیرهای (مثل مکمل n8n/Dify که نوشتیم) است. مایندبیس با نود ChatOpenAI وارد میشود: کلید در Credential، آدرس در فیلد Base Path زیر Additional Parameters.
پیشنیازها
- Flowise اجراشده (v1.3+ برای اعتبارنامه رمزنگاریشده).
- کلید API مایندبیس (گام صفر پایین).
گام صفر: دریافت API Key و Base URL از مایندبیس
قبل از هر چیز به دو مقدار نیاز دارید: کلید API و Base URL. هر دو از سایت مایندبیس قابل دریافت هستند:
- وارد حساب کاربری خود در mindbase.ir شوید (ثبتنام رایگان است).
- از منوی پروفایل، بخش «کلیدهای API» را باز کنید.
- روی «+ کلید جدید» بزنید و یک نام دلخواه بدهید؛ مثلاً
Flowiseتا بعداً بدانید این کلید مال کدام ابزار است. - مقدار کلید را کپی کنید — این کلید با پیشوند
mb_شروع میشود. - Base URL نیز در همین صفحه نمایش داده میشود:
https://api.mindbase.ir/v1
در ادامه همین دو مقدار را در تنظیمات Flowise جایگذاری میکنیم. اگر خواستید مدل دیگری هم امتحان کنید، لیست کامل مدلها (GLM-5.3 در سه سطح توان، مدل سبک سریع و Qwen3.8) در صفحه مدلهای مایندبیس قابل مشاهده است.
مرحله اول: اعتبارنامه
به Flowise (معمولاً :3000) بروید. در نود ChatOpenAI، Connect Credential → Create New → OpenAI API: CREDENTIAL NAME + «OpenAI Api Key» = mb_… (در v1.3 اعتبارنامهها با PASSPHRASE رمزنگاری میشوند).
# .env (v1.3)
PORT=3000
PASSPHRASE=MYPASSPHRASE
DATABASE_PATH=/root/.flowise
SECRETKEY_PATH=/root/.flowise
LOG_PATH=/root/.flowise/logs
مرحله دوم: Base Path
در همان نود «Additional Parameters» را باز کنید و فیلد Base Path را https://api.mindbase.ir/v1 بگذارید — مستندات، سازگاری OpenAI-compatible را همینطور نشان میدهد (Together، OpenRouter و…)
مدل
مدل در فیلد مدل نود؛ اگر در لیست نبود از ChatOpenAI Custom استفاده کنید که نام دلخواه میپذیرد: MindBase
نکات مهم
- نام فیلد: برچسب «Base Path» و سطح نود است نه credential.
- BaseOptions: کنار Base Path در Additional Parameters برای گزینههای بیشتر.
- استریم: مسیر /predictions با streaming=true استریم SSE میدهد؛ سمت سرویس به خود API وابسته است.
رفع مشکلات رایج
- خطای credential: PASSPHRASE در env ست شده؟ اعتبارنامه را از نو بسازید.
- ۴۰۴: Base Path با /v1.
- ۴۰۱: کلید mb_ در credential.
جمعبندی
Flowise با دو مقدار در ChatOpenAI — credential و Base Path — مایندبیس را وارد جریانهای بصری میکند؛ همان زنجیرهها حالا با مدل ایرانی.
سوالات متداول
Base Path یا baseUrl؟
فیلد رسمی نود ChatOpenAI «Base Path» است؛ baseUrl عنوان دیگری نیست.
مدل لیست نیست؟
ChatOpenAI Custom دقیقاً برای نامهای خارج از لیست رسمی است.
اپلود تصویر؟
فقط در LLMChain/ConversationChain/ReAct/Conversational Agent.