Dify و Flowise دو ابزار متن‌باز برای ساختن چت‌بات، ایجنت و گردش‌کار هوش مصنوعی با کشیدن و وصل کردن بلوک‌ها هستند، بدون کدنویسی یا با کد کم. هر دو یک سرویس‌دهندهٔ «سازگار با OpenAI» دارند؛ با کلید گیسو، مدل‌های متنی و امبدینگ کاتالوگ گیسو در هر دو در دسترس‌اند.
| API endpoint URL / BasePath | https://gisoo.pro/api/v1 |
| API Key | کلید گیسو، sk-gisoo-v1-… |
| Model Name | شناسهٔ دقیق مدل گیسو، مثلاً gpt-4.1-mini |
Dify
- سرویس‌دهندهٔ سازگار با OpenAI را نصب کنید
در Dify از منوی حساب به
Settings → Model Providerبروید وOpenAI-API-compatibleرا از فهرست سرویس‌دهنده‌ها (Marketplace) نصب کنید. در نسخه‌های تازهٔ Dify سرویس‌دهنده‌ها افزونه‌اند و از Marketplace خود Dify دانلود می‌شوند. - مدل گفت‌وگو را اضافه کنید
روی همان سرویس‌دهنده
Add Modelرا بزنید و فیلدها را مثل جدول پایین پر کنید. - مدل امبدینگ را اضافه کنید
برای پایگاه دانش (Knowledge) یک مدل دیگر با
Model TypeبرابرText Embeddingو نامtext-embedding-3-smallبسازید. - در برنامه انتخابشان کنید
در هر برنامه یا گردش‌کار، مدل گیسو را از فهرست انتخاب کنید؛ در پایگاه دانش هم مدل امبدینگ را.
| فیلد در Add Model | چه بگذارید |
|---|---|
Model Type | LLM برای گفت‌وگو، Text Embedding برای امبدینگ. |
Model Name | شناسهٔ دقیق از صفحهٔ مدل‌ها، مثلاً gpt-4.1-mini. |
API Key | کلید گیسو. |
API endpoint URL | https://gisoo.pro/api/v1، با /v1 و بدون مسیر اضافه. |
Completion mode | Chat. |
Model context size | پنجرهٔ ورودی مدل از جدول پایین (برای gpt-4.1-mini: ۱٬۰۴۷٬۵۷۶). |
Upper bound for max tokens | حدود ۴٬۰۰۰ تا ۸٬۰۰۰. سقف بزرگ‌تر مبلغی را که پیش از هر درخواست کنار گذاشته می‌شود بالا می‌برد. |
Function calling | Tool Call برای مدل‌هایی که فراخوانی ابزار دارند (همهٔ مدل‌های جدول پایین). برای ایجنت‌های Dify لازم است. |
Vision support | روشن برای مدل‌هایی که تصویر می‌خوانند. |
Stream function calling | پشتیبانی می‌شود. |
Dify هنگام ذخیره، با یک درخواست کوچک کلید و مدل را می‌آزماید؛ همان درخواست هزینهٔ ناچیزی از اعتبار کم می‌کند.
Flowise
- گره مدل
در بوم Flowise گره
ChatOpenAI Customرا بگذارید؛ این گره نام مدل را آزاد می‌گیرد و فقط به نام‌های OpenAI محدود نیست. - Credential
در
Connect Credentialیک Credential از نوع OpenAI API با کلید گیسو بسازید. - نام مدل و نشانی
Model Nameرا شناسهٔ گیسو بگذارید و درAdditional Parameters، فیلدBasePathراhttps://gisoo.pro/api/v1. - امبدینگ
برای پایگاه برداری، گره امبدینگ سفارشی OpenAI (
OpenAI Embeddings Custom) را با همان Credential، نشانی و مدلtext-embedding-3-smallبگذارید.
برای ایجنت ابزاردار (Tool Agent) مدلی انتخاب کنید که فراخوانی ابزار دارد؛ مدل‌های جدول پایین همه دارند.
کدام مدل را بگذارید
| برای | شناسهٔ مدل | پنجرهٔ ورودی (توکن) | ورودی / خروجی (دلار برای هر یک میلیون توکن) |
|---|---|---|---|
| چت‌بات و گردش‌کار پرتکرار ارزان و سریع. |
gpt-4.1-mini |
۱٬۰۴۷٬۵۷۶ | $0.56 / $2.24 |
| ایجنت با ابزارهای زیاد | openrouter/anthropic/claude-sonnet-5.5 |
۱٬۰۰۰٬۰۰۰ | $3.0595 / $15.2975 |
| پایگاه دانش با سندهای بلند | gemini-3.6-flash |
۱٬۰۴۸٬۵۷۶ | $1.05 / $5.25 |
| حجم بالا با هزینهٔ کم | deepseek-v4-flash |
۱٬۰۰۰٬۰۰۰ | $0.42 / $1.68 |
شناسه‌ها و قیمت‌ها هنگام باز شدن این صفحه از کاتالوگ خوانده می‌شوند و با تغییر قیمت سرویس‌دهنده عوض می‌شوند. فهرست کامل، با قیمت هر مدل به سکه، در صفحهٔ مدل‌ها است.
خطاهای رایج
| نشانه | علت | راه رفع |
|---|---|---|
| ذخیرهٔ مدل در Dify با خطا تمام می‌شود | یکی از سه مقدار نادرست است. | نشانی دقیقاً https://gisoo.pro/api/v1، نام مدل از صفحهٔ مدل‌ها و کلید کامل. متن خطا کد گیسو را هم می‌گوید. |
400 model_endpoint_mismatch | مدل امبدینگ را به‌عنوان LLM (یا برعکس) تعریف کرده‌اید. | Model Type را درست بگذارید. |
402 insufficient_credit | اعتبار برای مبلغ کنارگذاشتنی کافی نیست. | شارژ کنید یا Upper bound for max tokens را کمتر بگذارید. |
| ایجنت ابزار را صدا نمی‌زند | Function calling روی Not Support مانده است. | آن را Tool Call بگذارید. |
429 rate_limit_exceeded هنگام ساختن پایگاه دانش | نمایه‌سازی سندهای زیاد درخواست‌های پشت سر هم می‌فرستد. | سندها را در چند نوبت بارگذاری کنید یا با تیکت سقف بیشتری بخواهید. |
پرسش‌های پرتکرار
Dify نصب‌شده روی سرور ایران کار می‌کند؟
بله، برای مدل‌ها فقط به gisoo.pro وصل می‌شود. نصب خود Dify و افزونه‌هایش از منبع Dify انجام می‌شود، نه از گیسو. آزمایش اتصال از سرور: API بدون فیلترشکن.
سرویس‌دهندهٔ OpenAI خود Dify را بگذارم یا OpenAI-API-compatible را؟
OpenAI-API-compatible را. سرویس‌دهندهٔ OpenAI فقط نام مدل‌های OpenAI را می‌شناسد؛ این یکی هر شناسه‌ای را می‌پذیرد، از جمله Claude و Gemini.
مدل Rerank دارید؟
نه، گیسو endpoint رتبه‌بندی دوباره (rerank) ندارد. در پایگاه دانش Dify جست‌وجوی برداری یا ترکیبی را بدون Rerank به کار ببرید.
راهنماهای مرتبط
پاسخ پرسشتان را پیدا نکردید؟
شناسهٔ درخواست (هدر X-Request-Id) را با پرسشتان در تیکت بفرستید تا دقیق بررسی کنیم.
