n8n با هوش مصنوعی FluxCDN
n8n (ابری یا روی سرور خودتان) در credential خود OpenAI جایی برای آدرس دارد. همین کافی است تا نودهای AI Agent، Basic LLM Chain و OpenAI با مدلهای FluxCDN کار کنند.
- مجوز:
- Sustainable Use License (fair-code؛ متنباز به تعریف OSI نیست)
- سیستمعاملها:
- خودمیزبان (Docker، npm) یا n8n Cloud
- آدرس (سازگار با OpenAI):
https://ai.fluxcdn.cloud/api/v1- آدرس (آدرس کامل درخواست):
https://ai.fluxcdn.cloud/api/v1/chat/completions
پیش از شروع
- یک کلید API بسازید. در صفحهٔ کلیدهای API دکمهٔ «ساخت کلید» را بزنید و کلید را همان لحظه کپی کنید؛ با
flux_live_شروع میشود و دوباره کامل نشان داده نمیشود. - برای ایجنتها کلید جدا بسازید و با دکمهٔ «سقفها» برایش سقف هزینهٔ روزانه یا ماهانه بگذارید. ایجنتها خودشان پشت هم درخواست میفرستند؛ سقف جلوی هزینهٔ پیشبینینشده را میگیرد.
- کمی اعتبار در حساب داشته باشید (صورتحساب).
- در نمونهها بهجای
flux_live_YOUR_KEYکلید خودتان را بگذارید.
راهاندازی
گام 1: یک credential از نوع OpenAI بسازید
Credentials → Create credential → OpenAI. کلید را بدهید، Organization ID را خالی بگذارید و Base URL را عوض کنید. با Save، n8n اتصال را امتحان میکند. آدرس را در خود credential بگذارید، نه در گزینهٔ Base URL نود.
Credentials → OpenAIAPI Key: flux_live_YOUR_KEY Base URL: https://ai.fluxcdn.cloud/api/v1گام 2: نود مدل را تنظیم کنید
به نود AI Agent (یا Basic LLM Chain) یک OpenAI Chat Model بدهید و credential را انتخاب کنید. Model را از From list به By ID ببرید و شناسه را بنویسید، مثلاً
anthropic/claude-sonnet-5.5. Use Responses API را خاموش کنید: FluxCDN آن مسیر را هم دارد، اما ابزارهای داخلی OpenAI (Web Search، File Search، Code Interpreter) از این راه کار نمیکنند و Chat Completions سادهتر است.گام 3: برای هر کار دیگر: نود HTTP Request
اگر نودی آدرس نمیپذیرد، با HTTP Request مستقیم درخواست بفرستید و پاسخ را از
choices[0].message.contentبردارید.HTTP RequestMethod: POST URL: https://ai.fluxcdn.cloud/api/v1/chat/completions Headers: Authorization: Bearer flux_live_YOUR_KEY Body (JSON): { "model": "deepseek/deepseek-v4-flash", "messages": [{ "role": "user", "content": "{{ $json.text }}" }] }
بررسی کنید که کار میکند
گام 1: credential و یک پیام
ذخیرهٔ credential باید «Connection tested successfully» نشان دهد. بعد در گردشکاری که Chat Trigger دارد Open chat را بزنید و «سلام» بفرستید.
رفع مشکل
- AI Agent ابزارها را صدا نمیزند یا خطا میدهد
- AI Agent دستکم یک ابزار و مدلی با پشتیبانی از ابزار میخواهد. مدلی با برچسب Tools انتخاب کنید و پاسخ JSON را فقط وقتی روشن کنید که مدل پشتیبانی کند.
- خطای 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را جا نیندازید. جدول کدام آدرس را ببینید. - خطا دربارهٔ
previous_response_idیا ابزارهای داخلی OpenAI (جستوجوی وب، جستوجوی فایل، اجرای کد) - بعضی ابزارها بیصدا به API Responses میروند. FluxCDN آن را دارد، اما بدون حافظه (هر بار کل گفتوگو فرستاده میشود) و بدون ابزارهایی که روی سرور OpenAI اجرا میشوند. ابزار را روی Chat Completions بگذارید: در n8n Use Responses API را خاموش کنید، در Continue
useResponsesApi: false، در Vercel AI SDKopenai.chat(...)و در LangChainuse_responses_api=False. - خطای 429:
rate_limit_exceededیاbudget_exceeded - یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره میفرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقفها» ببینید.
- خطای 502، 503، 504 یا 529
- سرویس سازندهٔ مدل لحظهای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را میکنند. درخواستی که پیش از پاسخ شکست بخورد هزینهای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.
محدودیتها
- نودهای Vector Store و RAG مدل embedding میخواهند؛ از ارائهدهندهٔ دیگری بگیرید.
- عملیات Image، Audio و File نود OpenAI مسیرهای
/images،/audioو/filesرا صدا میزنند که FluxCDN ندارد.

