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

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

اپ‌های گفت‌وگوی دسکتاپ: 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. گام 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 Provider
    Provider 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. گام 1: ارائه‌دهنده را اضافه کنید

    Settings → Model Provider، پایین فهرست Add. نام FluxCDN AI و نوع OpenAI API compatible. کلید و آدرس را بدهید و API Path را خالی بگذارید. مدل‌ها را از سرور بگیرید یا دستی اضافه کنید، Save و بعد Check را بزنید. نسخهٔ وب Chatbox هم کار می‌کند.

    Settings → Model Provider → Add
    API 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. گام 1: ارائه‌دهنده را اضافه کنید

    Settings → Model Providers → Add Provider، نام FluxCDN AI، قالب OpenAI-compatible، آدرس و کلید، و Create. Jan فهرست مدل‌ها را می‌گیرد؛ اگر نگرفت، با + شناسه را دستی اضافه کنید. برای استفاده از ابزارها، کنار مدل روی مداد بزنید و Tools را روشن کنید.

    Settings → Model Providers → Add Provider
    API format:  OpenAI-compatible
    Base URL:    https://ai.fluxcdn.cloud/api/v1
    API key:     flux_live_YOUR_KEY

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

  1. گام 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 کار نمی‌کنند.

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