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

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

هوش مصنوعی FluxCDN در ابزارهای شما

یک آدرس و یک کلید برای هر 581 مدل. ابزارهایی را که با آن‌ها کار می‌کنید نگه دارید: دستیارهای کدنویسی، ویرایشگرها، اپ‌های گفت‌وگو، اتوماسیون و کد خودتان.

آنچه لازم دارید

آدرس سازگار با OpenAI

https://ai.fluxcdn.cloud/api/v1

برای بیشتر ابزارها و همهٔ SDKهای OpenAI. Codex هم همین را می‌خواهد.

آدرس سازگار با Anthropic

https://ai.fluxcdn.cloud/api

برای Claude Code و SDKهای Anthropic. خودشان /v1/messages را به آخرش اضافه می‌کنند.

کلید API

در صفحهٔ کلیدهای API بسازید. فقط یک بار کامل نشان داده می‌شود؛ همان لحظه کپی‌اش کنید.

هر دو آدرس همهٔ مدل‌ها را می‌پذیرند. شناسهٔ مدل را از صفحهٔ مدل‌ها کپی کنید، مثل anthropic/claude-sonnet-5.5 یا deepseek/deepseek-v4-pro. پس Claude Code با DeepSeek هم کار می‌کند و Codex با GLM.

برای هر ابزار یک کلید جدا بسازید و در صفحهٔ کلیدها برایش سقف هزینهٔ روزانه یا ماهانه بگذارید. اگر کلیدی لو برود یا ایجنتی در یک حلقه گیر کند، فقط همان کلید متوقف می‌شود.

ابزار من کدام آدرس را می‌خواهد؟

  • آدرس پایه؛ ابزار خودش /chat/completions را اضافه می‌کند
    https://ai.fluxcdn.cloud/api/v1
    بیشتر ابزارها: Cursor، Cline، Continue، Zed، JetBrains، Aider، OpenCode، Open WebUI، n8n، Dify، همهٔ SDKهای OpenAI و Codex
  • آدرس Anthropic؛ ابزار خودش /v1/messages را اضافه می‌کند
    https://ai.fluxcdn.cloud/api
    Claude Code، SDKهای Anthropic، LibreChat با provider: anthropic
  • آدرس کامل یک درخواست
    https://ai.fluxcdn.cloud/api/v1/chat/completions
    VS Code (Custom Endpoint)، TypingMind، Emacs gptel، Make، Zapier، Google Sheets
  • آدرس بدون /v1؛ ابزار خودش /v1/chat/completions را اضافه می‌کند
    https://ai.fluxcdn.cloud/api
    Neovim CodeCompanion

اگر مطمئن نیستید، ردیف اول را امتحان کنید. خطای 404 که از مدل حرفی نمی‌زند یعنی جای /v1 درست نیست.

دستیارهای کدنویسی

ایجنت‌هایی که کد را می‌خوانند، فرمان اجرا می‌کنند و فایل‌ها را تغییر می‌دهند. مدلی انتخاب کنید که ابزار (tools) را پشتیبانی کند.
Claude Codeدستیار کدنویسی Anthropic در ترمینال، VS Code و JetBrains، با هر مدلی از FluxCDN: Claude، DeepSeek، GLM، Kimi و بقیه.نرم‌افزار Anthropic، متن‌باز نیست · macOS، Linux، Windowsراهنمای کامل →Codexدستیار کدنویسی OpenAI در ترمینال و ویرایشگر، با هر مدلی از FluxCDN: GPT، Claude، DeepSeek، GLM و بقیه.Apache-2.0، متن‌باز · macOS، Linux، Windowsراهنمای کامل →OpenCodeدستیار کدنویسی متن‌باز در ترمینال، با یک فایل opencode.json.MIT، متن‌باز · macOS، Linux، Windows (پیشنهاد خودش: WSL)راهنمای کامل →Aiderبرنامه‌نویسی جفتی در ترمینال با git؛ تقریباً با هر مدل گفت‌وگو کار می‌کند.Apache-2.0، متن‌باز · macOS، Linux، Windows (Python 3.10 تا 3.12)راهنمای کامل →Clineایجنت متن‌باز برای VS Code، JetBrains و ترمینال.Apache-2.0 · VS Code، JetBrains، CLIراهنمای کامل →Kilo Codeایجنت متن‌باز که فهرست مدل‌ها را خودش از FluxCDN می‌گیرد.MIT · VS Code، JetBrains، CLIراهنمای کامل →Zoo Codeادامهٔ Roo Code برای VS Code.Apache-2.0 · VS Codeراهنمای کامل →Continueچت و ایجنت متن‌باز با یک فایل config.yaml.Apache-2.0 · VS Code، JetBrains، CLIراهنمای کامل →
Qwen Codeدستیار کدنویسی ترمینال که از Gemini CLI جدا شده و آدرس سازگار با OpenAI می‌پذیرد.Apache-2.0 · macOS، Linux، Windows (Node.js 22+)روش وصل کردن

این را در ~/.qwen/settings.json بگذارید و کلید را در متغیر FLUXCDN_API_KEY تعریف کنید (envKey نام متغیر است، نه خود کلید). یا در Qwen Code بنویسید /auth و Custom Provider را بزنید. امتحان: qwen -p "Say hello".

~/.qwen/settings.json
{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen/qwen3-coder",
        "name": "Qwen3 Coder (FluxCDN)",
        "baseUrl": "https://ai.fluxcdn.cloud/api/v1",
        "envKey": "FLUXCDN_API_KEY",
        "generationConfig": { "contextWindowSize": 262144 }
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "qwen/qwen3-coder" }
}
Gooseایجنت متن‌باز با اپ دسکتاپ و ترمینال.Apache-2.0 · macOS، Linux، Windowsروش وصل کردن

در اپ: Settings → Models → Configure providers → Add Custom Provider، نوع OpenAI Compatible، آدرس https://ai.fluxcdn.cloud/api/v1، کلید و شناسهٔ مدل‌ها (با کاما). در ترمینال: goose configure و Custom Providers، یا فایل زیر. Goose کلیدی را که در config.yaml بنویسید نادیده می‌گیرد؛ از متغیر محیطی یا keychain استفاده کنید.

~/.config/goose/custom_providers/custom_fluxcdn.json
{
  "name": "custom_fluxcdn",
  "engine": "openai",
  "display_name": "FluxCDN AI",
  "description": "FluxCDN AI (OpenAI-compatible)",
  "api_key_env": "CUSTOM_FLUXCDN_API_KEY",
  "base_url": "https://ai.fluxcdn.cloud/api/v1/chat/completions",
  "models": [
    { "name": "anthropic/claude-sonnet-5.5", "context_limit": 1000000 },
    { "name": "qwen/qwen3-coder", "context_limit": 262144 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}
Crushدستیار کدنویسی ترمینال از Charm.FSL-1.1-MIT: کدش باز است ولی متن‌باز به تعریف OSI نیست؛ پس از دو سال MIT می‌شود · macOS، Linux، Windowsروش وصل کردن

این را در ~/.config/crush/crushrc بگذارید و کلید را در FLUXCDN_API_KEY تعریف کنید. امتحان: crush run "Say hello". برای قالب Anthropic: --type messages --base-url "https://ai.fluxcdn.cloud/api".

~/.config/crush/crushrc
provider add fluxcdn --name "FluxCDN AI" --type completions \
  --base-url "https://ai.fluxcdn.cloud/api/v1" \
  --api-key "${FLUXCDN_API_KEY:?set FLUXCDN_API_KEY}"

model add fluxcdn/anthropic/claude-sonnet-5.5 --name "Claude Sonnet 5.5" --context-window 1000000 --default-max-tokens 32000
model add fluxcdn/qwen/qwen3-coder --name "Qwen3 Coder" --context-window 262144 --default-max-tokens 32000

model large fluxcdn/anthropic/claude-sonnet-5.5
model small fluxcdn/qwen/qwen3-coder

ویرایشگرها و IDEها

چت و ایجنت داخل ویرایشگر. تکمیل خودکار حین تایپ از این راه کار نمی‌کند (پایین صفحه).
VS Codeچت و ایجنت Copilot بدون اشتراک Copilot، یا افزونه‌های متن‌باز Cline، Kilo Code، Zoo Code و Continue.VS Code و افزونهٔ Copilot Chat: MIT؛ سرویس Copilot اختصاصی است · macOS، Linux، Windowsراهنمای کامل →Cursorچت Cursor در حالت Ask با مدل‌های FluxCDN. حالت Agent و تکمیل Tab نه.اختصاصی؛ طبق راهنماهای موجود، مدل سفارشی فقط در اشتراک پولی Cursor فعال است · macOS، Linux، Windowsراهنمای کامل →JetBrainsAI Assistant در IntelliJ IDEA، PyCharm، WebStorm و بقیه با کلید شخصی، بدون اشتراک JetBrains AI؛ و Junie CLI.اختصاصی؛ افزونهٔ AI Assistant رایگان است · macOS، Linux، Windowsراهنمای کامل →Zedویرایشگر سریع و متن‌باز؛ ایجنت، دستیار درون‌خطی و پیام commit با مدل‌های FluxCDN.GPL-3.0 (بخش‌هایی Apache-2.0) · macOS، Linux، Windowsراهنمای کامل →
Neovimدو افزونهٔ محبوب: avante.nvim و CodeCompanion.nvim.Apache-2.0 · هر جا Neovim اجرا شودروش وصل کردن

کلید را در FLUXCDN_API_KEY بگذارید. avante: آدرس با /v1. CodeCompanion: آدرس بدون /v1، چون خودش /v1/chat/completions را اضافه می‌کند؛ api_key را حتماً بدهید، وگرنه OPENAI_API_KEY شما فرستاده می‌شود.

lazy.nvim spec
opts = {
  provider = "fluxcdn",
  providers = {
    fluxcdn = {
      __inherited_from = "openai",
      endpoint = "https://ai.fluxcdn.cloud/api/v1",
      api_key_name = "FLUXCDN_API_KEY",
      model = "qwen/qwen3-coder",
    },
  },
},
Emacs (gptel)گفت‌وگو با مدل‌ها در هر بافر Emacs.GPL-3.0 · هر جا Emacs اجرا شودروش وصل کردن

آدرس در gptel دو تکه است: :host بدون https:// و :endpoint با مسیر کامل. gptel فهرست مدل‌ها را نمی‌گیرد، پس مدل‌ها را نام ببرید. امتحان: M-x gptel.

init.el
(setq gptel-model 'anthropic/claude-sonnet-5.5
      gptel-backend
      (gptel-make-openai "FluxCDN"
        :host "ai.fluxcdn.cloud"
        :endpoint "/api/v1/chat/completions"
        :stream t
        :key (lambda () (getenv "FLUXCDN_API_KEY"))
        :models '(anthropic/claude-sonnet-5.5
                  deepseek/deepseek-v4-pro
                  qwen/qwen3-coder)))

اپ‌های گفت‌وگو

رابط‌هایی شبیه ChatGPT که خودتان نصب می‌کنید یا روی سرورتان بالا می‌آورید. فهرست مدل‌ها را خودشان از FluxCDN می‌گیرند.
Open WebUIرابط گفت‌وگوی خودمیزبان برای تیم یا خانواده؛ همهٔ مدل‌های FluxCDN را خودش فهرست می‌کند.Open WebUI License: بر پایهٔ BSD-3 با شرط حفظ نام و نشان؛ متن‌باز به تعریف OSI نیست · خودمیزبان (Docker، pip)؛ از هر مرورگرراهنمای کامل →LibreChatاپ گفت‌وگوی متن‌باز و خودمیزبان با ایجنت و چند کاربر؛ با یک فایل librechat.yaml.MIT، متن‌باز · خودمیزبان (Docker، Node)؛ از هر مرورگرراهنمای کامل →Cherry Studio, Chatbox, Janسه اپ گفت‌وگوی رایگان برای ویندوز، مک و لینوکس که با کلید شما به همهٔ مدل‌های FluxCDN وصل می‌شوند.راهنمای کامل →Cherry Studioاپ گفت‌وگوی دسکتاپ با ده‌ها ابزار کمکی.AGPL-3.0 · Windows، macOS، Linuxراهنمای کامل →Chatboxاپ گفت‌وگو برای دسکتاپ، موبایل و وب.GPL-3.0 (Community) · Windows، macOS، Linux، iOS، Android، وبراهنمای کامل →Janاپ گفت‌وگوی دسکتاپ متن‌باز.Apache-2.0 · Windows، macOS، Linuxراهنمای کامل →
LobeHubاپ گفت‌وگوی وب و دسکتاپ با ایجنت و افزونه.LobeHub Community License (بر پایهٔ Apache-2.0 با شرط؛ متن‌باز به تعریف OSI نیست) · وب (خودمیزبان)، دسکتاپروش وصل کردن

Settings → Provider، Add Custom Provider: شناسه fluxcdn، Request Format openai، Proxy URL برابر https://ai.fluxcdn.cloud/api/v1 و کلید. بعد Fetch models و Connectivity Check.

AnythingLLMگفت‌وگو با اسناد خودتان، روی دسکتاپ یا سرور.MIT · Windows، macOS، Linux، Dockerروش وصل کردن

Settings → AI Providers → LLM، ارائه‌دهندهٔ Generic OpenAI: آدرس، کلید، پنجرهٔ متن مدل و شناسه. Embedder را روی گزینهٔ محلی خودش نگه دارید. در Docker همین‌ها با متغیرهای زیر:

.env
LLM_PROVIDER='generic-openai'
GENERIC_OPEN_AI_BASE_PATH='https://ai.fluxcdn.cloud/api/v1'
GENERIC_OPEN_AI_API_KEY='flux_live_YOUR_KEY'
GENERIC_OPEN_AI_MODEL_PREF='anthropic/claude-sonnet-5.5'
GENERIC_OPEN_AI_MODEL_TOKEN_LIMIT=1000000
Mstyاپ گفت‌وگوی دسکتاپ.اختصاصی (نسخهٔ رایگان دارد) · Windows، macOS، Linuxروش وصل کردن

در بخش Model Providers یک ارائه‌دهندهٔ سازگار با OpenAI اضافه کنید، آدرس https://ai.fluxcdn.cloud/api/v1 و کلید را بدهید و مدل‌ها را بگیرید. نام دقیق گزینه‌ها بسته به نسخهٔ Msty فرق می‌کند.

TypingMindرابط گفت‌وگوی وب که مستقیم از مرورگر درخواست می‌فرستد.اختصاصی · وبروش وصل کردن

Models → Add custom model و این مقدارها، بعد Test & Save. برای هر مدل یک بار. TypingMind آدرس کامل را می‌خواهد.

Add custom model
Model ID:            anthropic/claude-sonnet-5.5
API Type:            OpenAI Chat Completions API
Endpoint URL:        https://ai.fluxcdn.cloud/api/v1/chat/completions
Authentication Type: API Key via HTTP Header
Header Key:          Authorization
Header Value:        Bearer flux_live_YOUR_KEY
Page Assistافزونهٔ مرورگر برای گفت‌وگو کنار هر صفحه.MIT · Chrome، Edge، Brave، Firefoxروش وصل کردن

تنظیمات افزونه، زبانهٔ OpenAI Compatible API، Add Provider و Custom: آدرس و کلید. «گفت‌وگو با صفحه» مدل embedding می‌خواهد؛ آن را محلی (Ollama) نگه دارید.

اتوماسیون و بدون کد

گردش‌کارها، ربات‌ها و ایجنت‌هایی که بدون نوشتن کد می‌سازید.
n8nگردش‌کار، ایجنت و ربات تلگرام بدون کد؛ با همان credential خود OpenAI در n8n.Sustainable Use License (fair-code؛ متن‌باز به تعریف OSI نیست) · خودمیزبان (Docker، npm) یا n8n Cloudراهنمای کامل →Difyساخت اپ، ایجنت و گردش‌کار هوش مصنوعی با افزونهٔ رسمی OpenAI-API-compatible.Dify Open Source License (بر پایهٔ Apache-2.0 با شرط‌های اضافه) · خودمیزبان (Docker) یا Dify Cloudراهنمای کامل →
Flowiseساخت ایجنت و جریان با کشیدن و رها کردن.Apache-2.0 · خودمیزبان یا Flowise Cloudروش وصل کردن

یک Credential از نوع OpenAI API با کلید بسازید. نود OpenAI Custom Model: Model Name برابر شناسه (مثلاً anthropic/claude-sonnet-5.5) و Additional Parameters → Base Path برابر https://ai.fluxcdn.cloud/api/v1.

Langflowساخت جریان و ایجنت به شکل دیداری.MIT · Python، Docker، دسکتاپروش وصل کردن

Settings → Model Providers → OpenAI Compatible: آدرس و کلید، بعد Save. مدل‌ها خودکار می‌آیند؛ زیر Language Models روشنشان کنید. یا متغیرهای OPENAI_COMPATIBLE_BASE_URL و OPENAI_COMPATIBLE_API_KEY.

Activepiecesاتوماسیون متن‌باز شبیه Zapier.MIT (هسته) · ابری یا خودمیزبان (Docker)روش وصل کردن

مدیر پلتفرم: AI Providers و Other (OpenAI Compatible) با آدرس و کلید. اگر در نسخهٔ شما نیست، قطعهٔ HTTP را با POST به https://ai.fluxcdn.cloud/api/v1/chat/completions به کار ببرید.

Makeاپ OpenAI در Make آدرس نمی‌پذیرد؛ ماژول HTTP کار را می‌کند.اختصاصی · وبروش وصل کردن

ماژول HTTP → Make a request با این مقدارها و Parse response روشن. پاسخ در data.choices[].message.content است. stream نخواهید؛ Make آن را نمی‌خواند.

HTTP → Make a request
Method:  POST
URL:     https://ai.fluxcdn.cloud/api/v1/chat/completions
Header:  Authorization: Bearer flux_live_YOUR_KEY
Body:    {"model": "deepseek/deepseek-v4-flash", "messages": [{"role": "user", "content": "…"}]}
Zapierاپ ChatGPT در Zapier آدرس نمی‌پذیرد؛ Webhooks کار را می‌کند.اختصاصی · وبروش وصل کردن

Webhooks by Zapier → Custom Request (در طرح‌های پولی Zapier) با این مقدارها و هدر Content-Type: application/json. متنی که در JSON می‌گذارید نباید گیومه یا خط تازهٔ پاک‌نشده داشته باشد.

Webhooks by Zapier → Custom Request
Method:  POST
URL:     https://ai.fluxcdn.cloud/api/v1/chat/completions
Header:  Authorization: Bearer flux_live_YOUR_KEY
Body:    {"model": "deepseek/deepseek-v4-flash", "messages": [{"role": "user", "content": "…"}]}

جاهای دیگر

یادداشت، لانچر، وردپرس، خانهٔ هوشمند، صفحه‌گسترده و تلگرام.
Obsidianافزونه‌های Copilot و Text Generator برای یادداشت‌ها.Copilot: AGPL-3.0؛ Text Generator: MIT · دسکتاپ و موبایلروش وصل کردن

Copilot: Settings → Copilot → BYOK → Add a custom provider: آدرس و کلید، بعد Test و Save. اگر Test موفق بود ولی گفت‌وگو نه، Enable CORS را در همان ارائه‌دهنده روشن کنید. Text Generator: ارائه‌دهندهٔ OpenAI Chat با Base Path برابر https://ai.fluxcdn.cloud/api/v1.

Raycastلانچر macOS و Windows؛ مدل‌های FluxCDN در Quick AI.اختصاصی؛ Custom Providers فقط در Raycast Pro · macOS، Windowsروش وصل کردن

Settings → AI → Models & Providers، بخش Custom Providers، Reveal Providers Config. فایل providers.yaml را این‌طور بنویسید؛ Raycast تغییر را خودش می‌خواند. tools را فقط برای مدل‌هایی بگذارید که ابزار را پشتیبانی می‌کنند.

~/.config/raycast/ai/providers.yaml
providers:
  - id: fluxcdn
    name: FluxCDN AI
    base_url: https://ai.fluxcdn.cloud/api/v1
    api_keys:
      fluxcdn: flux_live_YOUR_KEY
    models:
      - id: anthropic/claude-sonnet-5.5
        name: Claude Sonnet 5.5 (FluxCDN)
        context: 1000000
        abilities:
          temperature: { supported: true }
          vision: { supported: true }
          system_message: { supported: true }
          tools: { supported: true }
      - id: deepseek/deepseek-v4-flash
        name: DeepSeek V4 Flash (FluxCDN)
        context: 1048576
WordPress (AI Engine)چت‌بات و تولید محتوا در وردپرس با افزونهٔ رایگان AI Engine.GPL-2.0 یا بالاتر (نسخهٔ رایگان، 3.4.8 به بعد) · وردپرسروش وصل کردن

Meow Apps → AI Engine → Settings، بخش Environments for AI: یک محیط از نوع سفارشی سازگار با OpenAI، Endpoint برابر https://ai.fluxcdn.cloud/api/v1 و کلید. مدل‌ها از FluxCDN می‌آیند؛ بعد محیط را برای چت‌بات انتخاب کنید.

Home Assistantدستیار صوتی خانهٔ هوشمند با مدل‌های FluxCDN.Home Assistant: Apache-2.0 · هر جا Home Assistant اجرا شودروش وصل کردن

یکپارچه‌سازی رسمی OpenAI آدرس نمی‌پذیرد. از HACS یکپارچه‌سازی Extended OpenAI Conversation را نصب کنید: Base Url برابر https://ai.fluxcdn.cloud/api/v1، کلید، و مدلی با پشتیبانی خوب از ابزار (مثلاً openai/gpt-5.5). بعد آن را در Voice assistants عامل گفت‌وگو کنید.

Google Sheetsتابع =FLUX() در صفحه‌گسترده با Apps Script.روش وصل کردن

Extensions → Apps Script. در Project Settings → Script Properties ویژگی FLUX_KEY را با کلید بسازید، این کد را بچسبانید و ذخیره کنید. در یک خانه بنویسید =FLUX("Say hello"). تابع‌های سفارشی باید در 30 ثانیه تمام شوند؛ مدل سریع و پاسخ کوتاه بخواهید. هر محاسبهٔ دوباره یک درخواست پولی است.

Apps Script: Code.gs
const FLUX_BASE = 'https://ai.fluxcdn.cloud/api/v1';

/**
 * Ask FluxCDN AI. =FLUX("Summarise: " & A2)  or  =FLUX(A2, "anthropic/claude-haiku-5.5")
 * @customfunction
 */
function FLUX(prompt, model) {
  if (!prompt) return '';
  const key = PropertiesService.getScriptProperties().getProperty('FLUX_KEY');
  const res = UrlFetchApp.fetch(FLUX_BASE + '/chat/completions', {
    method: 'post',
    contentType: 'application/json',
    headers: { Authorization: 'Bearer ' + key },
    payload: JSON.stringify({
      model: model || 'deepseek/deepseek-v4-flash',
      messages: [{ role: 'user', content: String(prompt) }],
      max_tokens: 400,
    }),
    muteHttpExceptions: true,
  });
  const data = JSON.parse(res.getContentText());
  if (res.getResponseCode() !== 200) return 'Error ' + res.getResponseCode() + ': ' + (data.error ? data.error.message : '');
  return data.choices[0].message.content.trim();
}
Excelبا افزونهٔ GPT for Excel (Autosheet).اختصاصی؛ آدرس سفارشی در طرح‌های Business، Enterprise یا پرداخت به‌ازای مصرف · Excel (ویندوز، مک، وب)روش وصل کردن

داشبورد Autosheet: Custom API endpoints → Bulk models → OpenAI-compatible endpoints (Chat Completions API)، آدرس https://ai.fluxcdn.cloud/api/v1 و کلید، بعد Check و Save. اگر Check با این آدرس خطا داد، https://ai.fluxcdn.cloud/api را امتحان کنید.

Telegramربات تلگرام خودتان، با چند خط Python یا با n8n.python-telegram-bot: LGPL-3.0 · سرور شما (Python 3.11+)روش وصل کردن

pip install python-telegram-bot openai، توکن ربات را از BotFather در TELEGRAM_BOT_TOKEN و کلید را در FLUXCDN_API_KEY بگذارید و اجرا کنید. پیام تلگرام حداکثر 4096 نویسه است. بدون کد: در n8n نود Telegram Trigger را به یک AI Agent وصل کنید.

bot.py
import os
from openai import AsyncOpenAI
from telegram.ext import Application, MessageHandler, filters

ai = AsyncOpenAI(base_url="https://ai.fluxcdn.cloud/api/v1", api_key=os.environ["FLUXCDN_API_KEY"])

async def reply(update, context):
    answer = await ai.chat.completions.create(
        model="deepseek/deepseek-v4-flash",
        messages=[{"role": "user", "content": update.message.text}],
    )
    await update.message.reply_text(answer.choices[0].message.content[:4096])

app = Application.builder().token(os.environ["TELEGRAM_BOT_TOKEN"]).build()
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, reply))
app.run_polling()

در کد خودتان

SDK رسمی OpenAI یا Anthropic، یا فریم‌ورکی که با آن‌ها کار می‌کند. فقط آدرس و کلید عوض می‌شود.

ChatGPT، Windsurf و Gemini CLI

این‌ها جایی برای آدرس یا کلید سرویس دیگری ندارند. به‌جایشان:
ChatGPT
اپ ChatGPT کلید یا آدرس سرویس دیگری نمی‌پذیرد. اگر رابطی مثل ChatGPT می‌خواهید، گفت‌وگوی FluxCDN همهٔ مدل‌ها را بدون هیچ تنظیمی دارد. یا یکی از اپ‌های گفت‌وگوی بالا را راه بیندازید.
Windsurf (Devin Desktop)
تنظیمی برای کلید یا آدرس شخصی ندارد. افزونهٔ Cline، Kilo Code، Zoo Code یا Continue را داخلش نصب کنید و آن را وصل کنید (راهنمای VS Code).
Gemini CLI
فقط با API خود گوگل کار می‌کند. Qwen Code را امتحان کنید که از Gemini CLI جدا شده و آدرس سازگار با OpenAI می‌پذیرد، یا OpenCode، Crush و Goose را.

اگر کار نکرد

خطای 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 را جا نیندازید. جدول کدام آدرس را ببینید.
خطا دربارهٔ previous_response_id یا ابزارهای داخلی OpenAI (جست‌وجوی وب، جست‌وجوی فایل، اجرای کد)
بعضی ابزارها بی‌صدا به API Responses می‌روند. FluxCDN آن را دارد، اما بدون حافظه (هر بار کل گفت‌وگو فرستاده می‌شود) و بدون ابزارهایی که روی سرور OpenAI اجرا می‌شوند. ابزار را روی Chat Completions بگذارید: در n8n Use Responses API را خاموش کنید، در Continue useResponsesApi: false، در Vercel AI SDK openai.chat(...) و در LangChain use_responses_api=False.
خطای 429: rate_limit_exceeded یا budget_exceeded
یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره می‌فرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقف‌ها» ببینید.
خطای CORS یا «Network error» در اپ‌های مرورگری
FluxCDN به درخواست مستقیم از مرورگر هم جواب می‌دهد، پس CORS دیگر مانع نیست. اگر هنوز این خطا را می‌بینید، آدرس و کلید را بررسی کنید؛ مرورگر گاهی یک 401 یا 404 را به شکل خطای شبکه نشان می‌دهد. کلید را هیچ‌وقت در صفحه‌ای نگذارید که دیگران باز می‌کنند.
ایجنت ابزاری صدا نمی‌زند یا مدل در فهرست ایجنت نیست
مدلی انتخاب کنید که ابزار (tools) را پشتیبانی کند؛ در صفحهٔ مدل‌ها برچسب Tools دارد. در بعضی ابزارها باید این قابلیت را برای مدل روشن کنید (گام‌های بالا). مسیریاب‌ها برای ایجنت‌ها پیشنهاد نمی‌شوند.
خطای 502، 503، 504 یا 529
سرویس سازندهٔ مدل لحظه‌ای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را می‌کنند. درخواستی که پیش از پاسخ شکست بخورد هزینه‌ای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.

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

  • Embedding نداریم. «پایگاه دانش»، جست‌وجو در فایل‌ها و ایندکس کد در این ابزارها مدل embedding جدا می‌خواهند. بیشترشان یک مدل محلی دارند که کافی است.
  • تصویر و صدا از مسیر Chat Completions ساخته می‌شوند، نه /images یا /audio. دکمه‌های «ساخت تصویر» و «تبدیل متن به گفتار» در این اپ‌ها معمولاً آن مسیرها را صدا می‌زنند و کار نمی‌کنند.
  • تکمیل خودکار حین تایپ (Tab در Cursor، پیشنهادهای کم‌رنگ Copilot، edit predictions در Zed) از FluxCDN استفاده نمی‌کند؛ مسیر /completions را می‌خواهد که نداریم.
  • ابزارهایی که روی سرور سازندهٔ مدل اجرا می‌شوند کار نمی‌کنند: WebSearch در Claude Code، web_search در Codex، و جست‌وجوی فایل و اجرای کد OpenAI. خواندن یک صفحهٔ مشخص (WebFetch در Claude Code) کار می‌کند.
  • API Responses حافظه ندارد: previous_response_id پذیرفته نمی‌شود و هر بار کل گفت‌وگو فرستاده می‌شود (Codex همین کار را می‌کند).