Flowise ابزار بصری متن‌باز برای ساخت زنجیره‌ها و ایجنت‌های LangChain با کشیدن و رها کردن گره‌هاست. گره ChatOpenAI گزینه‌ی BasePath در پارامترهای اضافه دارد که آدرس API را عوض می‌کند، یعنی همان کاری که در کد با base_url انجام می‌دهیم.
نام گره‌ها و جای فیلدها بین نسخه‌های Flowise کمی تغییر می‌کند؛ اگر چیزی را پیدا نکردید به دنبال گره «ChatOpenAI Custom» نیز بگردید.
پیش‌نیازها
- یک حساب پیکو هوش و یک کلید API از داشبورد (کلید فقط یک‌بار کامل نمایش داده می‌شود).
- شناسه‌ی دقیق مدل از کاتالوگ؛ در مثال‌ها از gpt-6-sol و claude-sonnet-5-5 استفاده شده است.
- کمی موجودی در کیف پول تومانی یا اعتبار؛ تعرفه را در صفحه‌ی قیمت‌ها ببینید.
راه‌اندازی گام‌به‌گام
ساخت اعتبارنامه
در بخش Credentials یک اعتبارنامه از نوع OpenAI API بسازید و کلید پیکو هوش را وارد کنید.
افزودن گره ChatOpenAI
گره ChatOpenAI را به بوم بیاورید، اعتبارنامه را انتخاب کنید و نام مدل را بنویسید.
ChatOpenAI node Model Name: gpt-6-solتنظیم BasePath
Additional Parameters را باز کنید و BasePath را بگذارید.
Additional Parameters BasePath: https://api.picoai.ir/v1اتصال به زنجیره
گره را به Conversation Chain یا Agent وصل کنید و در پنل چت تست کنید.
تست سریع اتصال
پیش از نوشتن منطق برنامه، یک بار فهرست مدل‌ها را بگیرید. اگر پاسخ ۲۰۰ و فهرستی از شناسه‌ها برگشت، کلید، شبکه و آدرس درست است و هر مشکل بعدی مربوط به تنظیمات Flowise خواهد بود.
curl https://api.picoai.ir/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"نکته‌های کاربردی برای Flowise
- برای حافظه‌ی گفتگو از گره‌های Memory خود Flowise استفاده کنید؛ این به مدل ربطی ندارد.
- نسخه‌های گره‌ها را ثابت نگه دارید و پیش از به‌روزرسانی فلو را export کنید.
- برای انتشار عمومی چت‌بات، کلید جداگانه با سقف ماهانه بسازید.
عیب‌یابی
گره به api.openai.com وصل می‌شود
BasePath ذخیره نشده یا گره دیگری استفاده شده است. فلو را ذخیره و دوباره تست کنید.
خطای Invalid model
نام مدل را مطابق کاتالوگ بنویسید؛ لیست کشویی Flowise ممکن است فقط نام‌های OpenAI را نشان دهد، پس مقدار سفارشی را تایپ کنید.
embedding کار نمی‌کند
امبدینگ در پیکو هوش نیست؛ برای گره‌های Vector Store مدل دیگری انتخاب کنید.
خطای 401 (Unauthorized)
کلید اشتباه، غیرفعال یا همراه فاصله‌ی اضافه است. در داشبورد کلید را بررسی و در صورت نیاز یک کلید تازه بسازید.
خطای 429 (Rate limit)
تعداد درخواست‌های شما در دقیقه از سقف کلید بیشتر شده است. چند ثانیه صبر و دوباره تلاش کنید یا سقف کلید را در داشبورد بررسی کنید.
هزینه و صورتحساب
هر درخواست قبل از اجرا مقداری از موجودی را رزرو می‌کند و پس از پاسخ موفق بر پایه‌ی توکن‌های واقعی تسویه می‌شود؛ مابه‌التفاوت برمی‌گردد و درخواست ناموفق چیزی کم نمی‌کند. جدول قیمت هر مدل در صفحه‌ی قیمت‌ها منتشر شده و مصرف هر درخواست در داشبورد قابل مشاهده است. اگر قبلاً از سرویس دیگری استفاده می‌کردید، راهنمای مهاجرت و صفحه‌ی مقایسه را ببینید.
پرسش‌های متداول
آیا باید Flowise را روی سرور خودم نصب کنم؟
بله، Flowise متن‌باز است و معمولاً خودمیزبان اجرا می‌شود.
آیا استریم دارد؟
گره ChatOpenAI گزینه‌ی Streaming دارد که با استریم پیکو هوش سازگار است.
جایگزین Dify است؟
هر دو ابزار بصری‌اند؛ Flowise به LangChain نزدیک‌تر و Dify محصول‌محورتر است.
اگر درخواست ناموفق باشد هزینه کم می‌شود؟
خیر. در پیکو هوش هزینه ابتدا رزرو و پس از پاسخ موفق بر اساس مصرف واقعی تسویه می‌شود؛ درخواست ناموفق بدون کسر هزینه است.
Flowise را همین حالا وصل کنید
با ساخت حساب و یک کلید، در چند دقیقه اولین پاسخ را بگیرید. اگر ابزار دیگری دارید، فهرست کامل اتصال‌ها را ببینید.
راهنمای ابزارهای مرتبط
- اتصال Difyافزودن مدلهای پیکو هوش به Dify با OpenAI-API-compatible
- اتصال n8nاتوماسیون n8n با گره OpenAI و آدرس پایه‌ی پیکو هوش
- اتصال LangChainاستفاده از مدلهای پیکو هوش در LangChain پایتون و جاوااسکریپت
- اتصال Open WebUIرابط چت خودمیزبان Open WebUI با مدلهای پیکو هوش
- اتصال LibreChatافزودن پیکو هوش بهعنوان Custom Endpoint در LibreChat
- اتصال Postmanآزمایش API پیکو هوش با Postman و متغیرهای محیطی
- مقایسهی پیکو هوش با سرویسهای مشابهمقایسهی بیطرفانه و مبتنی بر اطلاعات عمومی
- Base URL چیست؟تعریف و کاربرد آدرس پایه در APIهای سازگار