اپهای گفتوگوی دسکتاپ: Cherry Studio، Chatbox و Jan
این اپها روی کامپیوتر خودتان نصب میشوند و درخواستها را مستقیم از همانجا میفرستند. هر سه یک «ارائهدهندهٔ سفارشی» سازگار با OpenAI میپذیرند و فهرست مدلها را از FluxCDN میگیرند.
- آدرس (سازگار با OpenAI):
https://ai.fluxcdn.cloud/api/v1
پیش از شروع
- یک کلید API بسازید. در صفحهٔ کلیدهای API دکمهٔ «ساخت کلید» را بزنید و کلید را همان لحظه کپی کنید؛ با
flux_live_شروع میشود و دوباره کامل نشان داده نمیشود. - برای ایجنتها کلید جدا بسازید و با دکمهٔ «سقفها» برایش سقف هزینهٔ روزانه یا ماهانه بگذارید. ایجنتها خودشان پشت هم درخواست میفرستند؛ سقف جلوی هزینهٔ پیشبینینشده را میگیرد.
- کمی اعتبار در حساب داشته باشید (صورتحساب).
- در نمونهها بهجای
flux_live_YOUR_KEYکلید خودتان را بگذارید.
Cherry Studio
- مجوز:
- AGPL-3.0 (نسخهٔ Community)
- سیستمعاملها:
- Windows، macOS، Linux
گام 1: ارائهدهنده را اضافه کنید
Settings → Model Provider → Add Provider، نام FluxCDN AI و نوع OpenAI. کلید و آدرس را بدهید. خط Preview زیر آدرس باید
https://ai.fluxcdn.cloud/api/v1/chat/completionsرا نشان دهد. Check را بزنید، بعد از Model management مدلها را اضافه کنید و ارائهدهنده را روشن کنید.Settings → Model Provider → Add ProviderProvider Type: OpenAI API Key: flux_live_YOUR_KEY API Host: https://ai.fluxcdn.cloud/api/v1
Chatbox
- مجوز:
- نسخهٔ Community روی GitHub با GPL-3.0
- سیستمعاملها:
- Windows، macOS، Linux، iOS، Android، وب
گام 1: ارائهدهنده را اضافه کنید
Settings → Model Provider، پایین فهرست Add. نام FluxCDN AI و نوع OpenAI API compatible. کلید و آدرس را بدهید و API Path را خالی بگذارید. مدلها را از سرور بگیرید یا دستی اضافه کنید، Save و بعد Check را بزنید. نسخهٔ وب Chatbox هم کار میکند.
Settings → Model Provider → AddAPI type: OpenAI API compatible API Key: flux_live_YOUR_KEY API Host: https://ai.fluxcdn.cloud/api/v1 API Path: (empty)
Jan
- مجوز:
- Apache-2.0
- سیستمعاملها:
- Windows، macOS، Linux
گام 1: ارائهدهنده را اضافه کنید
Settings → Model Providers → Add Provider، نام FluxCDN AI، قالب OpenAI-compatible، آدرس و کلید، و Create. Jan فهرست مدلها را میگیرد؛ اگر نگرفت، با + شناسه را دستی اضافه کنید. برای استفاده از ابزارها، کنار مدل روی مداد بزنید و Tools را روشن کنید.
Settings → Model Providers → Add ProviderAPI format: OpenAI-compatible Base URL: https://ai.fluxcdn.cloud/api/v1 API key: flux_live_YOUR_KEY
بررسی کنید که کار میکند
گام 1: دکمهٔ بررسی و یک گفتوگو
Cherry Studio و Chatbox دکمهٔ Check دارند. بعد در یک گفتوگوی تازه مدل FluxCDN را بردارید و پیامی بفرستید.
رفع مشکل
- فهرست مدلها خالی است
- شناسه را دستی اضافه کنید، مثلاً
anthropic/claude-sonnet-5.5. آدرس باید/v1داشته باشد (Cherry Studio و Chatbox اگر نباشد خودشان اضافه میکنند؛ Jan نه). - در Chatbox نوع «OpenAI Responses» انتخاب شده و پاسخ نمیآید
- نوع را OpenAI API compatible بگذارید؛ این مسیر همهٔ مدلها را یکسان میفرستد.
- خطای 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. حروف کوچک و نقطهها مهماند. شناسه را کپی کنید، تایپ نکنید. - خطای 429:
rate_limit_exceededیاbudget_exceeded - یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره میفرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقفها» ببینید.
- خطای 502، 503، 504 یا 529
- سرویس سازندهٔ مدل لحظهای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را میکنند. درخواستی که پیش از پاسخ شکست بخورد هزینهای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.
محدودیتها
- پایگاه دانش در این اپها مدل embedding میخواهد؛ از یک ارائهدهندهٔ دیگر یا مدل محلی (مثلاً Ollama) استفاده کنید.
- بخشهای ساخت تصویر (مثل «Paintings» در Cherry Studio) مسیر
/imagesرا صدا میزنند و با FluxCDN کار نمیکنند.

