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

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

Open WebUI با هوش مصنوعی FluxCDN

Open WebUI روی سرور یا کامپیوتر خودتان بالا می‌آید و از مرورگر باز می‌شود. اتصالی که مدیر می‌سازد از سرور Open WebUI به FluxCDN می‌رود و فهرست مدل‌ها را خودش می‌گیرد.

مجوز:
Open WebUI License: بر پایهٔ BSD-3 با شرط حفظ نام و نشان؛ متن‌باز به تعریف OSI نیست
سیستم‌عامل‌ها:
خودمیزبان (Docker، pip)؛ از هر مرورگر
آدرس (سازگار با OpenAI):
https://ai.fluxcdn.cloud/api/v1
مستندات خود ابزار ↗

پیش از شروع

  • یک کلید API بسازید. در صفحهٔ کلیدهای API دکمهٔ «ساخت کلید» را بزنید و کلید را همان لحظه کپی کنید؛ با flux_live_ شروع می‌شود و دوباره کامل نشان داده نمی‌شود.
  • برای ایجنت‌ها کلید جدا بسازید و با دکمهٔ «سقف‌ها» برایش سقف هزینهٔ روزانه یا ماهانه بگذارید. ایجنت‌ها خودشان پشت هم درخواست می‌فرستند؛ سقف جلوی هزینهٔ پیش‌بینی‌نشده را می‌گیرد.
  • کمی اعتبار در حساب داشته باشید (صورت‌حساب).
  • در نمونه‌ها به‌جای flux_live_YOUR_KEY کلید خودتان را بگذارید.

راه‌اندازی

  1. گام 1: یک اتصال بسازید

    با حساب مدیر: Settings → Admin → Connections، زیر Manage OpenAI API Connections دکمهٔ + Add Connection. آدرس و کلید را بدهید، Verify Connection و بعد Save را بزنید. فهرست Model IDs را خالی بگذارید تا همهٔ مدل‌ها بیایند، یا فقط چند شناسه بنویسید.

    Admin → Connections
    URL:      https://ai.fluxcdn.cloud/api/v1
    API Key:  flux_live_YOUR_KEY

    با Docker، متغیرها فقط در اولین اجرا خوانده می‌شوند و بعد در پایگاه داده می‌مانند؛ تغییرهای بعدی را از تنظیمات انجام دهید.

  2. گام 2: یک مدل ارزان برای کارهای کوچک

    Open WebUI برای ساختن عنوان، برچسب و پیشنهاد سؤال بعدی هم مدل صدا می‌زند. در تنظیمات مدیر، Task Model بیرونی (External) را روی یک مدل ارزان مثل deepseek/deepseek-v4-flash بگذارید (در Docker: TASK_MODEL_EXTERNAL).

بررسی کنید که کار می‌کند

  1. گام 1: اتصال و یک گفت‌وگو

    Verify Connection فهرست مدل‌ها را از FluxCDN می‌گیرد. بعد در گفت‌وگوی تازه مدلی مثل anthropic/claude-sonnet-5.5 را بردارید و پیامی بفرستید.

رفع مشکل

فهرست مدل‌ها خیلی بلند است
در Model IDs اتصال فقط شناسه‌هایی را بنویسید که می‌خواهید. این فهرست جای فهرست کامل را می‌گیرد.
اتصال مستقیم کاربران (Direct Connections) خطای شبکه می‌دهد
این اتصال از مرورگر کاربر می‌رود و FluxCDN حالا به آن جواب می‌دهد. آدرس و کلید را بررسی کنید.
خطای 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
سرویس سازندهٔ مدل لحظه‌ای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را می‌کنند. درخواستی که پیش از پاسخ شکست بخورد هزینه‌ای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.

محدودیت‌ها

  • اسناد (RAG) با embedder محلی خود Open WebUI کار می‌کنند. RAG_EMBEDDING_ENGINE را به FluxCDN وصل نکنید؛ embedding نداریم.
  • ساخت تصویر داخلی Open WebUI و تبدیل متن و گفتار به مسیرهای /images و /audio نیاز دارند و از FluxCDN کار نمی‌کنند. برای این‌ها موتور محلی یا مرورگر را بگذارید.

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