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

Flowise بیلدر بصری جریان‌های زنجیره‌ای (مثل مکمل n8n/Dify که نوشتیم) است. مایندبیس با نود ChatOpenAI وارد می‌شود: کلید در Credential، آدرس در فیلد Base Path زیر Additional Parameters.

پیش‌نیازها

  • Flowise اجراشده (v1.3+ برای اعتبارنامه رمزنگاری‌شده).
  • کلید API مایندبیس (گام صفر پایین).

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

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

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

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

مرحله اول: اعتبارنامه

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

به 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.