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

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

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. گام 1: افزونه را نصب کنید

    Integrations → Model Provider و افزونهٔ OpenAI-API-compatible را نصب کنید (یا از marketplace.dify.ai).

  2. گام 2: مدل را اضافه کنید

    روی کارت افزونه Add Model را بزنید و این مقدارها را بدهید. برای ایجنت‌ها Function Call Type باید Tool Call باشد؛ پیش‌فرضش «Not Support» است. Vision Support را فقط برای مدل‌هایی بزنید که تصویر می‌فهمند. اندازه‌ها را از صفحهٔ همان مدل بردارید. برای هر مدل دیگر همین کار را تکرار کنید.

    OpenAI-API-compatible → Add Model
    Model 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. گام 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 می‌خواهد؛ آن را از ارائه‌دهندهٔ دیگری اضافه کنید.

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