Dify با هوش مصنوعی FluxCDN
Dify (ابری یا روی سرور خودتان) با افزونهٔ رسمی «OpenAI-API-compatible» به FluxCDN وصل میشود. هر مدل را جدا اضافه میکنید. فقط مالک و مدیر فضای کاری میتوانند ارائهدهنده اضافه کنند.
- مجوز:
- Dify Open Source License (بر پایهٔ Apache-2.0 با شرطهای اضافه)
- سیستمعاملها:
- خودمیزبان (Docker) یا Dify Cloud
- آدرس (سازگار با OpenAI):
https://ai.fluxcdn.cloud/api/v1
پیش از شروع
- یک کلید API بسازید. در صفحهٔ کلیدهای API دکمهٔ «ساخت کلید» را بزنید و کلید را همان لحظه کپی کنید؛ با
flux_live_شروع میشود و دوباره کامل نشان داده نمیشود. - برای ایجنتها کلید جدا بسازید و با دکمهٔ «سقفها» برایش سقف هزینهٔ روزانه یا ماهانه بگذارید. ایجنتها خودشان پشت هم درخواست میفرستند؛ سقف جلوی هزینهٔ پیشبینینشده را میگیرد.
- کمی اعتبار در حساب داشته باشید (صورتحساب).
- در نمونهها بهجای
flux_live_YOUR_KEYکلید خودتان را بگذارید.
راهاندازی
گام 1: افزونه را نصب کنید
Integrations → Model Provider و افزونهٔ OpenAI-API-compatible را نصب کنید (یا از marketplace.dify.ai).
گام 2: مدل را اضافه کنید
روی کارت افزونه Add Model را بزنید و این مقدارها را بدهید. برای ایجنتها Function Call Type باید Tool Call باشد؛ پیشفرضش «Not Support» است. Vision Support را فقط برای مدلهایی بزنید که تصویر میفهمند. اندازهها را از صفحهٔ همان مدل بردارید. برای هر مدل دیگر همین کار را تکرار کنید.
OpenAI-API-compatible → Add ModelModel Type: LLM Model Name: anthropic/claude-sonnet-5.5 API Key: flux_live_YOUR_KEY API Base URL: https://ai.fluxcdn.cloud/api/v1 Completion mode: Chat Model context size: 1000000 Upper bound for max tokens: 32000 Function Call Type: Tool Call Stream function calling: Support Vision Support: Support API Type: Chat Completions API (/chat/completions)
بررسی کنید که کار میکند
گام 1: ذخیره و پیشنمایش
با Save، افزونه یک درخواست خیلی کوچک («ping») میفرستد؛ هزینهاش ناچیز است. بعد مدل را در یک Chatflow بگذارید و پیشنمایش بگیرید.
رفع مشکل
- ایجنت با روش ReAct کار میکند، نه با ابزار
- Function Call Type مدل را Tool Call کنید.
- خطای 401 یا
invalid_api_key - کلید کامل کپی نشده، باطل شده یا جای دیگری گذاشته شده. کلید با
flux_live_شروع میشود و فاصلهٔ اضافه ندارد. اگر ابزار کلید را از متغیر محیطی میخواند، پس از تنظیم آن یک ترمینال یا پنجرهٔ تازه باز کنید. - خطای 402،
insufficient_credit(در Codex:insufficient_quota) با اینکه اعتبار دارید - پیش از هر درخواست، بیشترین هزینهای که آن درخواست ممکن است داشته باشد از اعتبارتان کنار گذاشته میشود. وقتی پاسخ تمام شد فقط هزینهٔ واقعی برداشته میشود و بقیه برمیگردد. ابزاری که برای هر درخواست خروجی خیلی بلندی میخواهد، مبلغ بزرگی کنار میگذارد. سقف خروجی ابزار را کمتر کنید (مثلاً 32000 توکن) یا اعتبار اضافه کنید.
- خطای 404 یا
model_not_found - شناسهٔ مدل باید دقیقاً همان باشد که در صفحهٔ مدلها آمده، با پیشوند سازنده:
anthropic/claude-sonnet-5.5، نهclaude-sonnet-5.5. حروف کوچک و نقطهها مهماند. شناسه را کپی کنید، تایپ نکنید. - خطای 404 که از مدل حرفی نمیزند
- آدرس پایه درست نیست. بیشتر ابزارها
https://ai.fluxcdn.cloud/api/v1را میخواهند و خودشان بقیه را اضافه میکنند؛/chat/completionsرا دو بار ننویسید و/v1را جا نیندازید. جدول کدام آدرس را ببینید. - خطای 429:
rate_limit_exceededیاbudget_exceeded - یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره میفرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقفها» ببینید.
- خطای 502، 503، 504 یا 529
- سرویس سازندهٔ مدل لحظهای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را میکنند. درخواستی که پیش از پاسخ شکست بخورد هزینهای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.
محدودیتها
- پایگاه دانش Dify مدل embedding میخواهد؛ آن را از ارائهدهندهٔ دیگری اضافه کنید.

