پرش به محتوا
FluxCDNFluxCDN
esc
ورود
در این صفحه

مستنداتراهنمای ابزارها

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. گام 1: یک credential از نوع OpenAI بسازید

    Credentials → Create credential → OpenAI. کلید را بدهید، Organization ID را خالی بگذارید و Base URL را عوض کنید. با Save، n8n اتصال را امتحان می‌کند. آدرس را در خود credential بگذارید، نه در گزینهٔ Base URL نود.

    Credentials → OpenAI
    API Key:   flux_live_YOUR_KEY
    Base URL:  https://ai.fluxcdn.cloud/api/v1
  2. گام 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. گام 3: برای هر کار دیگر: نود HTTP Request

    اگر نودی آدرس نمی‌پذیرد، با HTTP Request مستقیم درخواست بفرستید و پاسخ را از choices[0].message.content بردارید.

    HTTP Request
    Method:   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. گام 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 SDK openai.chat(...) و در LangChain use_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 ندارد.

آنچه از این راه کار نمی‌کند →