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: یک اتصال بسازید
با حساب مدیر: Settings → Admin → Connections، زیر Manage OpenAI API Connections دکمهٔ + Add Connection. آدرس و کلید را بدهید، Verify Connection و بعد Save را بزنید. فهرست Model IDs را خالی بگذارید تا همهٔ مدلها بیایند، یا فقط چند شناسه بنویسید.
Admin → ConnectionsURL: https://ai.fluxcdn.cloud/api/v1 API Key: flux_live_YOUR_KEYبا Docker، متغیرها فقط در اولین اجرا خوانده میشوند و بعد در پایگاه داده میمانند؛ تغییرهای بعدی را از تنظیمات انجام دهید.
گام 2: یک مدل ارزان برای کارهای کوچک
Open WebUI برای ساختن عنوان، برچسب و پیشنهاد سؤال بعدی هم مدل صدا میزند. در تنظیمات مدیر، Task Model بیرونی (External) را روی یک مدل ارزان مثل
deepseek/deepseek-v4-flashبگذارید (در Docker:TASK_MODEL_EXTERNAL).
بررسی کنید که کار میکند
گام 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 کار نمیکنند. برای اینها موتور محلی یا مرورگر را بگذارید.

