帮助中心

欢迎使用 Fluxion AI。本页面说明购买与兑换、API Key、接口类型，以及 CC Switch、Claude Code、Claude Desktop、Codex、Codex++、Cursor 和 Cherry Studio 的接入方法。

1. 购买与支付说明
2. 如何兑换兑换码
3. 如何创建 API Key
4. 套餐、分组与接口类型说明
5. OpenAI 兼容接口配置
6. Anthropic / Claude 兼容接口配置
7. 导入到 CC Switch
8. 导入到 Claude Code
9. 导入到 Claude Desktop
10. 导入到 Codex
11. 导入到 Codex++
12. 导入到 Cursor
13. 导入到 Cherry Studio
14. 常见问题
15. 使用安全建议
16. 联系支持
17. xAI / Grok 兼容接口配置
18. Nanobanana 接口使用

1. 购买与支付说明

本站目前支持两种购买方式：站内在线支付和卡网兑换码支付。

推荐优先使用站内支付完成购买。如果站内支付暂时失败、无法完成付款，或者你希望查看卡网是否有优惠活动，也可以通过卡网购买兑换码后回到本站兑换。卡网兑换码购买入口会长期有效。

站内支付流程：

登录本站。
进入“订阅”或“购买套餐”页面。
选择需要购买的套餐。
按页面提示完成站内支付。
支付成功后，对应套餐、余额或权益会自动生效。

卡网兑换码购买链接：

点击前往购买兑换码

卡网兑换码购买流程：

点击上方购买链接，进入兑换码购买页面。
根据需要选择对应商品。
确认商品名称、金额、优惠信息和发货内容。
完成支付。
支付成功后，卡密平台会自动发货兑换码。
复制收到的兑换码。
回到本站，在“兑换码”页面输入兑换码并完成兑换。

注意事项：

站内支付和兑换码支付都可以用于开通服务或获得对应权益。
卡网有时会提供优惠活动，购买前可以自行对比站内价格和卡网价格。
如果站内支付失败，可以改用卡网购买兑换码，购买入口长期有效。
请在卡网购买前确认商品名称、金额、优惠信息和发货内容。
兑换码为自动发货，请妥善保存购买后收到的兑换码。
如支付成功后未收到兑换码，请先在卡密平台订单页面查询发货信息。
如兑换码无法使用，请联系本站管理员并提供订单信息和兑换码。

2. 如何兑换兑换码

兑换码用于开通套餐、充值余额或获得对应服务权益。具体权益以兑换码对应商品说明为准。

兑换步骤：

登录本站。
进入左侧菜单中的“兑换码”页面。
在输入框中粘贴购买后收到的兑换码。
点击兑换。
兑换成功后，对应套餐、余额或权益会自动生效。

兑换时请注意：

请完整复制兑换码，避免多复制空格或遗漏字符。
每个兑换码通常只能使用一次。
如果提示兑换码无效、已使用或已过期，请核对购买记录。
如确认兑换码正确但无法兑换，请联系管理员处理。

3. 如何创建 API Key

API Key 是你调用本站 API 服务的凭证。请妥善保存，不要公开分享。

创建步骤：

登录本站。
进入左侧菜单中的“API 密钥”页面。
点击创建 API Key。
根据需要填写名称。
选择可用分组。
创建后复制 API Key 并保存到安全位置。

重要提醒：

API Key 通常只会完整显示一次，请创建后立即复制保存。
不要把 API Key 发送给他人或公开发布。
如果怀疑 API Key 泄露，请立即删除旧 Key 并重新创建。
不同 API Key 可以绑定不同分组，实际可用模型以 Key 所属分组为准。
不同分组对应不同的模型接口类型：Anthropic / OpenAI。

4. 套餐、分组与接口类型说明

Fluxion AI 中的套餐、分组、模型和接口类型是关联的。使用前请先确认你的套餐对应哪个分组，以及该分组应该使用哪一种接口格式。

4.1 套餐与分组的关系

不同套餐会对应不同的 API 分组。你创建 API Key 时，需要选择与你当前套餐匹配的分组。

一般规则如下：

套餐类型	推荐分组	主要模型	标准接口类型
GPT 套餐	GPT 分组	GPT / OpenAI 系模型	OpenAI 兼容接口
Claude 套餐	Claude 分组	Claude 系模型	Anthropic / Claude 兼容接口
全模型套餐	全模型分组	GPT + Claude 模型	以全模型分组说明为准，通常使用 Anthropic / Claude 兼容接口

如果 API Key 选择了错误分组，可能会出现以下问题：

请求模型不支持。
提示无可用账号。
客户端接口格式不匹配。
请求可以认证成功，但模型调用失败。

4.2 分组与接口类型的关系

不同分组对应的标准接口不同，调用方式也不同。

GPT 分组

GPT 分组通常使用 OpenAI 兼容接口。

text

Base URL: https://fluxionai.space/v1
认证方式: Authorization: Bearer 你的用户APIKey
常用接口: /v1/chat/completions
适用模型: gpt-5.6系列、gpt-6 等 GPT / OpenAI 系模型

Claude 分组

Claude 分组通常使用 Anthropic / Claude 兼容接口。

text

Base URL: https://fluxionai.space
认证方式: x-api-key: 你的用户APIKey
常用接口: /v1/messages
适用模型: claude-sonnet-5、claude-opus-4-8 等 Claude 系模型

全模型分组

全模型分组用于同时支持多个模型系列。请根据你购买的全模型套餐说明使用对应接口。

当前建议：

请求 Claude 模型时，使用 Anthropic / Claude 兼容接口。
请求 GPT 模型时，优先按该分组页面或公告中说明的接口类型配置。
如果你的全模型 API Key 被配置为 Anthropic / Claude 兼容分组，那么即使请求 GPT 模型，也应使用 Anthropic / Claude 兼容接口。

4.3 常用模型名称

请在客户端中准确填写模型名称。模型名称区分字符，建议直接复制使用。

GPT / OpenAI 系模型示例：

text

gpt-5.6-sol
gpt-6-astra

Claude 系模型示例：

text

claude-sonnet-5
claude-opus-4-8

具体可用模型以你的套餐、分组和 API Key 权限为准。

你也可以在登录后的“模型广场”页面查询当前可用模型名称。渠道状态中会按厂商显示状态卡，例如 GPT 和 Claude。点击对应厂商的状态卡后，可以查看该厂商下具体模型的状态和模型调用名称。配置客户端时，请复制这里显示的完整模型名称。

如不确定自己应该使用哪个模型，请先查看套餐说明，或联系管理员确认。

5. OpenAI 兼容接口配置

如果你使用的是 OpenAI 兼容客户端，例如支持 OpenAI API 格式的聊天工具、开发框架或 SDK，可以使用 OpenAI 兼容接口。

基础配置：

text

Base URL: https://fluxionai.space/v1
API Key: 你的用户 API Key

常见填写方式：

text

API 地址 / Base URL: https://fluxionai.space/v1
密钥 / API Key: 你的用户 API Key
模型 / Model: 你套餐支持的 GPT 模型

示例模型：

text

gpt-5.6-sol
gpt-6-astra

具体可用模型以你的套餐、分组和 API Key 权限为准。

OpenAI Chat Completions 示例

bash

curl https://fluxionai.space/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的用户APIKey" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {
        "role": "user",
        "content": "你好，请简单介绍一下你自己。"
      }
    ]
  }'

OpenAI Images / gpt-image-2 调用示例

gpt-image-2 是图像生成模型，不使用 /v1/chat/completions 聊天接口。调用该模型时，请使用 OpenAI Images 兼容接口。

基础配置：

text

Base URL: https://fluxionai.space/v1
接口路径: /v1/images/generations
认证方式: Authorization: Bearer 你的用户APIKey
模型名称: gpt-image-2

curl 示例：

bash

curl https://fluxionai.space/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的用户APIKey" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫坐在未来城市的窗边，赛博朋克风格",
    "size": "1024x1024",
    "n": 1,
    "response_format": "b64_json"
  }'

如果你的客户端支持 OpenAI Images API，请选择图片生成 / Images / Image Generation 类型，而不是普通聊天模型类型。

关于渠道监控中的 gpt-image-2 状态：

渠道监控当前主要使用文本聊天接口检测模型可用性。
gpt-image-2 需要通过图片生成接口调用，因此监控中的检测结果不能准确代表该模型是否可用。
请以实际调用 /v1/images/generations 的结果为准。

如果客户端要求填写完整接口地址，通常填写：

text

https://fluxionai.space/v1

不要重复填写成：

text

https://fluxionai.space/v1/v1

6. Anthropic / Claude 兼容接口配置

如果你使用的是 Anthropic / Claude 兼容客户端，例如 Claude Code 或支持 Anthropic API 格式的工具，可以使用 Anthropic 兼容接口。

基础配置：

text

Base URL: https://fluxionai.space
API Key: 你的用户 API Key

常见填写方式：

text

API 地址 / Base URL: https://fluxionai.space
密钥 / API Key: 你的用户 API Key
模型 / Model: 你套餐支持的 Claude 模型

示例模型：

text

claude-sonnet-5
claude-opus-4-8

具体可用模型以你的套餐、分组和 API Key 权限为准。

Anthropic Messages 示例

bash

curl https://fluxionai.space/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: 你的用户APIKey" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "你好，请简单介绍一下你自己。"
      }
    ]
  }'

请注意：

OpenAI 兼容接口通常使用 Authorization: Bearer API_KEY。
Anthropic 兼容接口通常使用 x-api-key: API_KEY。
不同客户端字段名称可能不同，但核心配置是 Base URL、API Key 和 Model。

7. 导入到 CC Switch

CC Switch 是一个跨平台的 AI CLI 配置管理工具，可用于集中管理 Claude Code、Codex、Gemini CLI、OpenCode 等工具的模型提供商（Provider）配置。它把 Base URL、API Key、模型名称等信息统一保存，让你在多个 CLI 工具或多套 Provider 之间一键切换，避免反复修改环境变量或配置文件。

下载安装

CC Switch 是开源项目，源码托管在 GitHub：farion1231/cc-switch。

打开 Releases 页面。
根据自己的操作系统选择安装包：macOS 选择 .dmg，Windows 选择 .msi，Linux 选择 .AppImage 或 .deb；具体以发布页提供的文件为准。
下载后按系统正常方式安装，并至少打开一次 CC Switch，方便后续一键导入识别到本机已安装。

一键导入

若 Fluxion AI 控制台的「API 密钥」页面显示「CC Switch」按钮，可通过一键导入添加 Provider；若没有该入口，请使用下方的手动配置方式。

确认本机已经安装并打开过 CC Switch。
打开 Fluxion AI 控制台，进入「API 密钥」页面。
找到要给 CC Switch 使用的 Key，点击该行右侧的「导入到CCS」。

浏览器或系统询问是否允许打开 CC Switch 时，确认打开。
在导入确认窗口核对供应商名称、官网地址、API 端点和 Key，确认后导入。

上图为 Fluxion AI 配置核对示意，并非实际操作截图；按钮和布局以当前 CC Switch 版本为准。

⚠️ 警告
一键导入会把当前 API Key 写入本机 CC Switch 配置。请只在自己的电脑上操作，不要在共享电脑或远程临时环境中导入，也不要分享包含真实 Key 的截图。

手动添加 Provider

以下为 Claude Code 对应的 Provider 配置。在 CC Switch 中选择 Claude Code / Claude 应用，添加供应商并选择自定义配置，填写：

字段	填写内容
预设供应商	自定义配置
供应商名称	`Fluxion AI`
官方链接	`https://fluxionai.space`
API Key	在 Fluxion AI 创建的 Key
API 请求地址	`https://fluxionai.space`（不要勾选「完整 URL」）

保存后启用该供应商，重新打开 Claude Code。模型名称以 Fluxion AI 控制台对应分组可用的模型为准。

此处填写的是根地址，不要自行添加 /v1/messages。Codex 等其他客户端的协议和路径请参照后续对应章节，不要直接套用 Claude Code 配置。

GPT 模型与 Codex 配置

上面的根地址配置只适用于 Claude Code 接入 Claude 模型。通过 CC Switch 使用 GPT 模型或 Codex 时，应根据客户端和分组切换接口类型：

使用场景	接口类型	Base URL
Claude Code 接入 Claude 模型	Anthropic / Claude 兼容	`https://fluxionai.space`
Claude Code 接入 GPT 模型	OpenAI 兼容或 Responses	`https://fluxionai.space/v1`
Codex 接入 GPT 分组	Responses	`https://fluxionai.space/v1`
Codex 接入全模型或 Anthropic 分组	Responses 转换入口	`https://fluxionai.space/v1`

Claude Code 通过 CC Switch 接入 GPT 模型时，需要先在「设置 → 路由 → 本地路由」中显示并开启本地路由总开关，同时为 Claude 启用路由。遇到配置正确但请求仍失败时，可以关闭再重新开启本地路由。

Codex 使用完整 URL 模式时，请填写 https://fluxionai.space/v1/responses 并开启本地路由；未开启完整 URL 时，只填写到 /v1，由客户端自动拼接 /responses。两种方式不要混用。

8. 导入到 Claude Code

⚠️ 警告：推荐使用 CC Switch 来管理和切换 Claude Code 的 Provider 配置，无需手动改环境变量或配置文件。

Claude Code 使用 Anthropic 相关配置项。通过 Fluxion AI 接入时，使用控制台「使用密钥」弹窗展示的 Claude Code 配置。

💡 提示：如果你同时使用 Claude 官方订阅和 Fluxion AI API Key，建议把两套配置放在不同终端配置或 CC Switch Profile 中，避免环境变量互相覆盖。

从控制台复制配置

在 Fluxion AI 控制台进入「API 密钥」页面，找到要用于 Claude Code 的 Key，点击右侧「使用密钥」。弹窗中选择 Claude Code，再根据你的系统选择 macOS / Linux、Windows CMD 或 PowerShell。

这里展示的配置会自动带入当前 Key。文档中的示例会用 [YOUR_API_KEY] 代替真实 Key。

临时环境变量方式

如果你只是临时测试，可以在当前终端中运行：

bash

export ANTHROPIC_BASE_URL="https://fluxionai.space"
export ANTHROPIC_AUTH_TOKEN="[YOUR_API_KEY]"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

这种方式只对当前终端会话生效。关闭终端后，环境变量会失效。

如果你的系统或当前 Claude Code 版本要求使用 ANTHROPIC_API_KEY，也可以按控制台说明改为：

bash

export ANTHROPIC_BASE_URL="https://fluxionai.space"
export ANTHROPIC_API_KEY="[YOUR_API_KEY]"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

两种认证变量不要同时混用。优先复制控制台「使用密钥」弹窗给出的版本。

写入 Claude Code 配置

如果你希望长期使用，可以把环境变量写入 ~/.claude/settings.json：

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://fluxionai.space",
    "ANTHROPIC_AUTH_TOKEN": "[YOUR_API_KEY]",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

保存后重新启动 Claude Code，让新配置生效。

指定模型

如果 Claude Code 需要显式指定模型，请使用控制台中 Claude/Anthropic 接入方式对应的模型名称。

bash

claude --model your-claude-compatible-model

模型名称要和控制台保持完全一致。

写入 Shell 配置

如果你更习惯通过 Shell 环境变量管理，也可以把配置写入 ~/.zshrc 或 ~/.bashrc：

bash

export ANTHROPIC_BASE_URL="https://fluxionai.space"
export ANTHROPIC_AUTH_TOKEN="[YOUR_API_KEY]"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

保存后执行：

bash

source ~/.zshrc

然后重新运行：

bash

claude

注意事项

Claude Code 会读取当前终端环境变量。切换 Provider 后，请重新打开终端或确认变量已经更新。如果你用 CC Switch 管理配置，也要确认当前 Profile 已切换到 Fluxion AI。

Base URL 请填写控制台给出的根地址，不要自行拼接完整接口路径，例如 /v1/messages。

⚠️ 警告：不要把 API Key 写入项目仓库中的 .env、README 或截图。Claude Code 会在当前终端环境中读取变量，配置完成后也要注意不要把 Key 暴露给其他项目。

常见排查

问题	处理方式
认证失败	确认 `ANTHROPIC_AUTH_TOKEN` 或 `ANTHROPIC_API_KEY` 只启用一种
地址错误	Base URL 使用控制台展示的根地址，不要拼接完整接口路径
仍走官方服务	重新打开终端，检查是否存在旧的环境变量
模型不可用	换用控制台可用的 Claude 兼容模型名称
VS Code 中不生效	关闭并重新打开 VS Code，确认扩展读取到新的 Claude Code 配置

9. 导入到 Claude Desktop

Claude Desktop 支持配置第三方 Provider。通过 Fluxion AI 接入后，Claude Desktop 会使用你在控制台创建的 API Key，通过 Fluxion AI 网关访问模型服务。

ℹ️ 说明：这一页适用于 Claude Desktop 的第三方 Provider / Gateway 配置流程。Claude Code 的环境变量配置请查看导入到 Claude Code。

前置准备

开始之前，请先准备好下面几项：

项目	说明
Claude Desktop	已安装并至少打开过一次
API Key	在 Fluxion AI 控制台创建的 Key，建议单独命名为 `claude-desktop`
Gateway base URL	`https://fluxionai.space`

如果控制台「使用密钥」弹窗中展示了专门用于 Claude/Anthropic 的地址，请优先使用控制台展示的地址。

下载 Claude Desktop

如果你还没有安装 Claude Desktop，可以先打开官方文档下载安装：

Claude Desktop 下载

官方页面可能显示 “Claude Code on desktop”等名称；请以当前下载页面和安装后的 Claude 桌面应用界面为准。

macOS 配置流程

启用开发者模式

打开 Claude Desktop 客户端。
点击顶部菜单栏的 Help（帮助），依次选择 Troubleshooting → Enable Developer Mode。
在确认对话框中点击 Enable。Claude Desktop 会自动重启。

配置第三方 Provider

重启后进入欢迎界面，先不要登录。保持 Claude Desktop 处于选中状态，此时顶部菜单栏会出现 Developer。
点击 Developer → Configure Third-Party Inference，打开配置面板。
填写 Fluxion AI 的网关信息。

配置项	填写内容
Gateway base URL	`https://fluxionai.space`
Gateway API key	Fluxion AI 控制台创建的 API Key

点击右下角的 Apply locally。
在弹出的确认框中选择 Relaunch now 重启应用。
重启后点击 Continue with gateway，进入 Claude Desktop 主界面。

界面说明

进入主界面后，可以使用下面的快捷键切换视图：

快捷键	功能
`Command + 1`	Cowork 界面，默认视图
`Command + 2`	编码界面

Windows 配置流程

Windows 端的配置逻辑与 macOS 基本一致，主要区别是打开开发者菜单的方式不同。

启用开发者模式

打开 Claude Desktop，进入欢迎界面的邮箱输入页面。
按 Tab 键切换焦点，直到左上角的菜单图标被选中。
按 Enter 键打开菜单。
选择 Developer → Configure third-party inference。

配置接口信息

填写 Fluxion AI 的 Gateway 地址和 API Key，然后点击 Apply locally，按提示重启生效。

配置项	填写内容
Gateway base URL	`https://fluxionai.space`
Gateway API key	Fluxion AI 控制台创建的 API Key

常见问题

问题	处理方式
配置后无法连接	检查 Gateway URL 是否以 `https://` 开头，API Key 是否完整有效
配置后没有变化	确认点击了 Apply locally，并完全退出后重新打开 Claude Desktop
提示认证失败	回到 Fluxion AI 控制台重新复制 API Key，确认没有多余空格
请求没有出现在使用记录里	确认当前 Claude Desktop 选择的是 Fluxion AI Gateway，而不是官方登录或其他 Provider

10. 导入到 Codex

⚠️ 警告：推荐使用 CC Switch 来管理和切换 Codex 的 Provider 配置，无需手动改环境变量或配置文件。
ℹ️ 说明：这一页针对官方 Codex CLI（命令行）。如果你用的是 Codex 桌面客户端搭配第三方增强工具 Codex++，请改看导入到 Codex++。

Codex CLI 可以通过配置文件添加自定义模型提供商。适合把 Fluxion AI 作为一个独立 Provider 保存下来，之后在 Codex 中直接选择使用。

ℹ️ 说明：Codex 的配置文件适合长期使用。如果只是临时测试，也可以先只设置环境变量，再用命令行参数指定模型。

准备信息

字段	填写内容
Provider ID	`fluxion`
Provider Name	`Fluxion AI`
Base URL	GPT 分组使用 `https://fluxionai.space/v1`；全模型或 Anthropic 分组使用 `https://fluxionai.space/v1`
API Key 环境变量	`FLUXION_API_KEY`
Model	控制台模型列表中的模型名称

先在 Fluxion AI 控制台进入「API 密钥」页面，创建或选择一个专门给 Codex 使用的 Key。建议名称中带上 codex，后续排查消耗时更清楚。

配置 API Key

先在终端中设置 API Key：

bash

export FLUXION_API_KEY="[YOUR_API_KEY]"

如需长期使用，可以写入 ~/.zshrc 或 ~/.bashrc。

如果你写入了 Shell 配置文件，保存后记得执行：

bash

source ~/.zshrc

确认当前终端能读取到变量：

bash

test -n "$FLUXION_API_KEY" && printf "API Key 已设置\n"

看到“API Key 已设置”即可，无需输出真实 Key。不要把完整 Key 发到公开聊天或 issue 中。

配置 Codex Provider

先确认 API Key 所属分组，再选择对应的 Base URL：

API Key 分组	Base URL	Codex 最终请求
GPT 分组	`https://fluxionai.space/v1`	`https://fluxionai.space/v1/responses`
全模型或 Anthropic 分组	`https://fluxionai.space/v1`	`https://fluxionai.space/v1/responses`

下面以 GPT 分组为例。编辑 ~/.codex/config.toml，加入：

toml

model = "your-model-name"
model_provider = "fluxion"

[model_providers.fluxion]
name = "Fluxion AI"
base_url = "https://fluxionai.space/v1"
env_key = "FLUXION_API_KEY"
wire_api = "responses"

把 your-model-name 替换为 Fluxion AI 控制台展示的模型名称。

配置说明

配置项	说明
`model_provider`	当前默认使用的 Provider ID
`base_url`	Fluxion AI 的 OpenAI 兼容地址
`env_key`	Codex 从哪个环境变量读取 API Key
`wire_api`	Codex 使用的接口形态，以当前 Codex 版本支持为准

💡 提示：如果你的 Codex 版本配置字段与示例略有不同，请保留同样的核心信息：Provider ID、Base URL、环境变量名和模型名称。升级 Codex 后，也建议回头确认一次配置文件格式。

如果使用全模型或 Anthropic 分组，只把示例中的 base_url 改为：

启动

bash

codex

如果需要临时切换模型，可以在 Codex 启动参数或会话内按 Codex 的模型选择方式切换。第一次启动时，建议先发一个轻量请求，例如让模型输出当前配置的模型名或一句简短说明，确认 Provider 已经生效。

验证请求走到 Fluxion AI

可以从两边验证：

位置	看什么
Codex 终端	是否能正常返回，是否出现认证或模型不存在错误
Fluxion AI 使用记录	是否出现刚才这次 Codex 请求

如果 Fluxion AI 使用记录中没有请求，通常说明 Codex 没有启用 fluxion Provider，或者当前终端没有读到 FLUXION_API_KEY。

常见问题与排查

如果报认证错误，先确认当前终端中能读到环境变量：

bash

test -n "$FLUXION_API_KEY" && printf "API Key 已设置\n"

如果是升级 Codex 到 0.149.0 及以上版本后才出现 401 或 API_KEY_REQUIRED，通常不是 Key 的问题：新版不再允许自定义 Provider 在未开启 requires_openai_auth 时自动继承 ~/.codex/auth.json 里的鉴权。本页使用的 env_key 属于显式鉴权，不受这次变更影响；如果你之前的配置没有 env_key、只靠 auth.json 里的 OPENAI_API_KEY 生效，可以改用本页配置，或在 [model_providers.fluxion] 中加上 requires_openai_auth = true 并把 Key 保留在 auth.json（形如 {"OPENAI_API_KEY": "[YOUR_API_KEY]"}，此时 env_key 会被忽略）。修改后重启 Codex 生效。

如果报模型不存在，确认 model 字段与控制台模型名称完全一致。

如果报网络或接口格式错误，重点检查 base_url 是否只填写到当前分组对应的 /v1 或 /vip/v1，不要写成 /v1/chat/completions 或 /v1/responses。

💡 提示：如果你经常切换多个 Provider，可以把 Fluxion AI 配置交给 CC Switch 管理，减少手动编辑 ~/.codex/config.toml 的次数。需要配置多个模型时，可以在模型映射中设置。

11. 导入到 Codex++

⚠️ 警告：Codex++（CodexPlusPlus）是一个第三方的 Codex 桌面客户端增强工具，不是 OpenAI 官方 Codex。如果你要配置的是官方 Codex CLI（命令行、手改 ~/.codex/config.toml），请改看导入到 Codex。两者名字相近但用途不同，请勿混淆。

Codex++ 通过一个外部启动器拉起 Codex 桌面客户端，并注入增强功能，本身不修改 Codex 的安装文件。接入 Fluxion AI 走的是它的「供应商配置」功能：你在管理工具的图形界面里把 Fluxion AI 添加为一个供应商，它会替你把配置写进 Codex，之后用 Codex++ 入口启动即可。

前置准备

项目	说明
Codex 桌面客户端	已安装并至少打开过一次（Codex++ 是它的外部启动器，不是替代品）
Codex++	从 GitHub Releases 下载安装，装完会有 `Codex++`（静默启动）和 `Codex++ 管理工具`（控制面板）两个入口
API Key	Fluxion AI 控制台创建的 Key，建议名称带 `codex`，后续排查消耗时更清楚

先在 Fluxion AI 控制台进入「API 密钥」页面，创建或选择一个专门给 Codex 使用的 Key，复制备用。不要把完整 Key 发到公开聊天或 issue 中。

下载安装 Codex++

Codex++ 是开源项目，源码托管在 GitHub：BigPizzaV3/CodexPlusPlus。

打开 Releases 页面。
在最新版本的资源列表中，根据自己的操作系统选择对应的安装包：

Windows：CodexPlusPlus-*-windows-x64-setup.exe
macOS Intel：CodexPlusPlus-*-macos-x64.dmg
macOS Apple Silicon：CodexPlusPlus-*-macos-arm64.dmg

按系统正常方式安装。安装后会出现两个入口：Codex++（静默启动，只负责启动 Codex 并注入增强）和 Codex++ 管理工具（控制面板）。
至少打开一次 Codex++ 管理工具，方便后续配置。

添加 Fluxion AI 供应商

打开 Codex++ 管理工具，点击左侧的「供应商配置」。

📝 注意：确认顶部的「启用供应商配置切换」处于勾选状态（默认开启）。关闭时，下面的「使用」按钮不可用，配置只会被保存、不会写入 Codex。

1. 添加供应商

点击「添加供应商」。

2. 从模板创建并填写

点击「从预设模板创建」，选择官方的「OpenAI Official」，然后按下表填写：

配置项	填写内容
名称	`Fluxion AI`（这条供应商的显示名，方便你自己识别）
接入模式	纯 API
配置模型	留空，不用写
Base URL	`https://fluxionai.space`
Key	Fluxion AI 控制台创建的 API Key
上游协议	Responses API

ℹ️ 说明：表单里的「Codex 目标 / 启用目标功能」是 Codex 自带的「长期目标模式」开关（对应 features.goals），和接入 Fluxion AI 无关，保持默认即可。

填好后，在「模型列表」处点击「从上游获取」拉取 Fluxion AI 提供的模型，再点击左上角的「保存」。

测试并启用

回到供应商列表，找到刚添加的 Fluxion AI，点击右侧的「测试」按钮（发送 hi 测试）。弹窗中出现 HTTP 200 字样即表示配置可用。
点击左侧的「使用」按钮，把 Codex 切换到 Fluxion AI 配置——Codex++ 会据此写入 ~/.codex/config.toml。
启动 Codex++（不要用原版 Codex 启动）即可。第一次使用时，建议先发一个轻量请求，确认已经生效。

ℹ️ 说明：启用后，Codex++ 会自动在 ~/.codex/config.toml 写入一条 model_provider（由 Codex++ 自动管理，不同版本可能是 custom 等内部标识符）。这个名字只是配置文件里的内部标识符，不需要也不建议手动改成 fluxion——决定请求走到 Fluxion AI 的是 Base URL 和 API Key，而不是这个名字，手动改名在下次切换时还会被覆盖。想要好认的名字，把上一步的「名称」填成 Fluxion AI 即可。

验证请求走到 Fluxion AI

可以从两边验证：

位置	看什么
Codex 界面	是否能正常返回，是否出现认证或模型不存在错误
Fluxion AI 使用记录	是否出现刚才这次请求

如果 Fluxion AI 使用记录中没有请求，通常说明 Codex 没有切换到 Fluxion AI 供应商，或者没有用 Codex++ 入口启动。

常见问题与排查

问题	处理方式
「使用」按钮点不动、是灰色的	确认顶部「启用供应商配置切换」已勾选
提示认证失败	回到 Fluxion AI 控制台重新复制 API Key，确认没有多余空格
报模型不存在	重新「从上游获取」模型列表，确认选用的模型名与控制台一致
请求没有出现在使用记录里	确认是用 `Codex++` 入口启动，且当前「使用中」的是 `Fluxion AI` 供应商，而不是官方登录或其他配置

12. 导入到 Cursor

Cursor 支持在设置中填写自定义 API Key。不同版本的设置项名称可能略有差异，请以当前版本界面为准。

先准备 API Key

在 Fluxion AI 控制台创建一个专门给 Cursor 使用的 API Key。建议名称写成 cursor-desktop、cursor-work 这类能看出来源的名字，后续在使用记录里更容易定位。

Cursor 通常走 OpenAI 兼容配置，因此需要准备三项信息：

字段	填写内容
API Key	Fluxion AI 控制台创建的 Key
Base URL	`https://fluxionai.space/v1`
Model	控制台模型列表中的模型名称

配置步骤

打开 Cursor 设置。
进入 Models 或 API Keys 相关页面。
找到 OpenAI API Key、自定义 OpenAI 兼容配置，或 Override OpenAI Base URL 之类的设置项。
API Key 填写 Fluxion AI 控制台创建的 Key。
Base URL 或 Override OpenAI Base URL 填写：

text

https://fluxionai.space/v1

如果界面允许手动添加模型，填写 Fluxion AI 控制台展示的模型名称。
保存后点击 Verify，或新建一次聊天测试。

模型名称

如果 Cursor 允许手动添加模型，请填写 Fluxion AI 控制台展示的模型名称。

如果当前 Cursor 版本不支持自定义 Base URL，则无法直接指向 Fluxion AI 网关。可以改用 Codex、Claude Code、Cherry Studio，或等待 Cursor 版本支持对应配置项。

测试方式

保存配置后，建议先做一次很轻量的测试：

text

请只回复一句话：Cursor 已连接。

如果能正常回复，再开始使用 Composer、Chat 或 Agent。测试失败时，不要连续重试大任务，先检查 Key、Base URL 和模型名称。

注意事项

Cursor 的自定义 API Key 通常只覆盖部分标准聊天模型能力。Tab Completion、内置模型、部分 Agent 能力可能仍然走 Cursor 自带服务。

如果 Verify 失败，请确认：

检查项	说明
Base URL	只填到 `/v1`，不要填完整接口路径
API Key	没有多余空格或换行
模型	使用控制台存在且可用的模型
余额	当前账户余额或套餐仍可用
设置作用范围	确认当前功能确实使用自定义 OpenAI Provider，而不是 Cursor 内置模型

13. 导入到 Cherry Studio

Cherry Studio 支持添加自定义模型服务。通过 OpenAI 兼容方式，可以把 Fluxion AI 配置为一个新的 Provider。

准备 API Key

先在 Fluxion AI 控制台创建一个 Cherry Studio 专用 Key。图形化客户端通常会长期保存 Key，因此不建议和命令行工具共用同一个 Key。

需要准备的信息如下：

字段	填写内容
Provider 名称	`Fluxion AI`
API Key	Fluxion AI 控制台创建的 Key
API 地址	`https://fluxionai.space/v1`
模型名称	控制台模型列表中的模型名称

添加 Provider

打开 Cherry Studio。
进入设置中的「模型服务」或 Provider 管理页面。
新增一个 OpenAI 兼容 Provider。
名称填写 Fluxion AI。
API Key 填写 Fluxion AI 控制台创建的 Key。
API 地址填写：

text

https://fluxionai.space/v1

保存配置。

保存后，如果 Cherry Studio 提供「检查」或「测试连接」按钮，建议先点一次。能正常拉取模型列表或返回成功提示，再继续添加模型。

添加模型

如果 Cherry Studio 没有自动拉取模型列表，可以手动添加控制台展示的模型名称。

建议先添加一个最常用的模型进行测试，确认能正常对话后，再补充其他模型。模型名称要完整复制，大小写、横线、日期后缀都不要改。

测试连接

在 Cherry Studio 中新建对话，选择 Fluxion AI Provider 和对应模型，发送一条简短消息：

text

你好，请用一句话介绍你自己。

如果模型正常回复，说明配置成功。

使用建议

如果你会在 Cherry Studio 里保存多个 Provider，建议把 Fluxion AI 的模型名称和官方模型名称区分开，避免选错服务。也可以只先添加常用模型，等确认稳定后再补全其他模型。

排查建议

如果连接失败，请检查 API 地址是否只填写到 /v1，不要填写 /chat/completions 或其他完整接口路径。

问题	处理方式
认证失败	重新复制 API Key，确认没有多余空格
连接超时	换网络或稍后重试，并查看 Fluxion AI 服务状态
模型不可用	使用控制台模型列表中的完整模型名
能拉模型但不能聊天	检查当前对话是否选择了 `Fluxion AI` Provider

14. 常见问题

14.1 为什么请求提示无可用账号？

可能原因：

当前模型暂时没有可用上游账号。
你请求的模型不在当前分组支持范围内。
上游账号繁忙或达到并发上限。
当前服务正在维护或调整。

建议处理：

检查模型名称是否填写正确。
尝试更换同套餐支持的其他模型。
稍后重试。
如持续失败，请联系管理员。

14.2 为什么提示模型不支持？

可能原因：

当前 API Key 所属分组不支持该模型。
模型名称填写错误。
你的套餐不包含该模型。

建议处理：

到 API Keys 页面确认 Key 所属分组。
到套餐说明或公告中查看支持模型。
检查模型名称是否有拼写错误。

14.3 为什么提示认证失败？

可能原因：

API Key 填错。
Header 格式错误。
使用了错误的接口格式。

建议处理：

OpenAI 兼容接口使用 Authorization: Bearer 你的用户APIKey。
Anthropic 兼容接口使用 x-api-key: 你的用户APIKey。
确认 API Key 没有多复制空格或换行。

14.4 为什么余额或额度被扣除？

本站会根据模型调用产生的 token 用量、模型价格和套餐规则计算费用。每次请求完成后，系统会记录用量日志，并根据实际使用情况扣除余额或额度。

你可以在“用量记录”页面查看请求时间、模型、token 用量和扣费情况。

14.5 站内支付失败怎么办？

如果站内支付暂时失败、无法完成付款，或支付后权益没有自动到账，请先稍后刷新页面并查看订单状态。

如果仍无法完成站内支付，可以改用卡网购买兑换码。卡网购买入口长期有效，有时也会有优惠活动。

卡网购买链接：

点击前往购买兑换码

14.6 为什么购买兑换码后没有收到？

请先在卡密平台订单页面查询发货状态。

如果确认支付成功但没有收到兑换码，请联系管理员，并提供订单号、支付时间和购买商品信息。

14.7 兑换码无法兑换怎么办？

请检查：

兑换码是否复制完整。
是否多复制了空格或换行。
兑换码是否已经使用过。
兑换码是否已过期。
兑换码是否适用于当前账号或当前服务。

如仍无法兑换，请联系管理员处理。

15. 使用安全建议

为了保护你的账号和额度，请注意：

不要公开分享 API Key。
不要把 API Key 写入公开仓库。
不要在截图、视频或日志中暴露 API Key。
定期检查用量记录。
如果发现异常用量，请立即删除相关 API Key 并联系管理员。
给不同应用创建不同 API Key，方便单独管理和撤销。

16. 联系支持

如果你遇到以下问题，可以联系本站管理员：

兑换码购买或兑换问题。
API Key 创建或使用问题。
模型调用失败。
订阅、余额或扣费异常。
账号登录或安全问题。

联系时建议提供：

你的账号邮箱。
问题发生时间。
使用的模型名称。
错误提示截图或文本。
相关订单号或兑换码信息。

管理员联系方式：

客服 QQ：3198026614
售后一群：1076140277
邮箱：[email protected]

如需了解个人信息相关事项，请参阅隐私政策中的“联系我们”。

请不要在公开场合发送完整 API Key。

17. xAI / Grok 兼容接口配置

Grok（xAI）使用 OpenAI 兼容接口，配置方式与第 5 节相同，仅模型名称不同。

基础配置：

text

Base URL: https://fluxionai.space/v1
API Key: 你的用户 API Key
模型 / Model: 你套餐支持的 Grok 模型

示例模型：

text

grok-4.5
grok-4.3

具体可用模型以你的套餐、分组和 API Key 权限为准。

Grok Chat Completions 示例

bash

curl https://fluxionai.space/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的用户APIKey" \
  -d '{
    "model": "grok-4.5",
    "messages": [
      {
        "role": "user",
        "content": "你好，请简单介绍一下你自己。"
      }
    ]
  }'

图像模型（如 grok-imagine）请使用 OpenAI Images 接口 /v1/images/generations，调用方式与第 5 节图像示例相同。

18. Nanobanana 接口使用

Nanobanana 走 Gemini 端口。

生图端点：

用途	请求地址
生成内容（非流式）	`https://fluxionai.space/v1beta/models/nano-banana:generateContent`
生成内容（流式）	`https://fluxionai.space/v1beta/models/nano-banana:streamGenerateContent?alt=sse`
计算 token	`https://fluxionai.space/v1beta/models/nano-banana:countTokens`

请求时使用在 Fluxion AI 控制台创建的 API Key。流式生成端点通过 SSE 返回数据，客户端需要保持 SSE 连接并逐段处理返回内容。

帮助中心 ​

目录 ​

1. 购买与支付说明 ​

2. 如何兑换兑换码 ​

3. 如何创建 API Key ​

4. 套餐、分组与接口类型说明 ​

4.1 套餐与分组的关系 ​

4.2 分组与接口类型的关系 ​

GPT 分组 ​

Claude 分组 ​

全模型分组 ​

4.3 常用模型名称 ​

5. OpenAI 兼容接口配置 ​

OpenAI Chat Completions 示例 ​

OpenAI Images / gpt-image-2 调用示例 ​

6. Anthropic / Claude 兼容接口配置 ​

Anthropic Messages 示例 ​

7. 导入到 CC Switch ​

下载安装 ​

一键导入 ​

手动添加 Provider ​

GPT 模型与 Codex 配置 ​

8. 导入到 Claude Code ​

从控制台复制配置 ​

临时环境变量方式 ​

写入 Claude Code 配置 ​

指定模型 ​

写入 Shell 配置 ​

注意事项 ​

常见排查 ​

9. 导入到 Claude Desktop ​

前置准备 ​

下载 Claude Desktop ​

macOS 配置流程 ​

界面说明 ​

Windows 配置流程 ​

常见问题 ​

相关资源 ​

10. 导入到 Codex ​

准备信息 ​

配置 API Key ​

配置 Codex Provider ​

启动 ​

验证请求走到 Fluxion AI ​

常见问题与排查 ​

11. 导入到 Codex++ ​

前置准备 ​

下载安装 Codex++ ​

添加 Fluxion AI 供应商 ​

测试并启用 ​

验证请求走到 Fluxion AI ​

常见问题与排查 ​

相关资源 ​

12. 导入到 Cursor ​

先准备 API Key ​

配置步骤 ​

模型名称 ​

测试方式 ​

注意事项 ​

13. 导入到 Cherry Studio ​

准备 API Key ​

添加 Provider ​

添加模型 ​

测试连接 ​

使用建议 ​

排查建议 ​

14. 常见问题 ​

14.1 为什么请求提示无可用账号？ ​

14.2 为什么提示模型不支持？ ​

14.3 为什么提示认证失败？ ​

14.4 为什么余额或额度被扣除？ ​

14.5 站内支付失败怎么办？ ​

14.6 为什么购买兑换码后没有收到？ ​

14.7 兑换码无法兑换怎么办？ ​

15. 使用安全建议 ​

16. 联系支持 ​

17. xAI / Grok 兼容接口配置 ​

Grok Chat Completions 示例 ​

18. Nanobanana 接口使用 ​

帮助中心

目录

1. 购买与支付说明

2. 如何兑换兑换码

3. 如何创建 API Key

4. 套餐、分组与接口类型说明

4.1 套餐与分组的关系

4.2 分组与接口类型的关系

GPT 分组

Claude 分组

全模型分组

4.3 常用模型名称

5. OpenAI 兼容接口配置

OpenAI Chat Completions 示例

OpenAI Images / gpt-image-2 调用示例

6. Anthropic / Claude 兼容接口配置

Anthropic Messages 示例

7. 导入到 CC Switch

下载安装

一键导入

手动添加 Provider

GPT 模型与 Codex 配置

8. 导入到 Claude Code

从控制台复制配置

临时环境变量方式

写入 Claude Code 配置

指定模型

写入 Shell 配置

注意事项

常见排查

9. 导入到 Claude Desktop

前置准备

下载 Claude Desktop

macOS 配置流程

界面说明

Windows 配置流程

常见问题

相关资源

10. 导入到 Codex

准备信息

配置 API Key

配置 Codex Provider

启动

验证请求走到 Fluxion AI

常见问题与排查

11. 导入到 Codex++

前置准备

下载安装 Codex++

添加 Fluxion AI 供应商

测试并启用

验证请求走到 Fluxion AI

常见问题与排查

相关资源

12. 导入到 Cursor

先准备 API Key

配置步骤

模型名称

测试方式

注意事项

13. 导入到 Cherry Studio

准备 API Key

添加 Provider

添加模型

测试连接

使用建议

排查建议

14. 常见问题

14.1 为什么请求提示无可用账号？

14.2 为什么提示模型不支持？

14.3 为什么提示认证失败？

14.4 为什么余额或额度被扣除？

14.5 站内支付失败怎么办？

14.6 为什么购买兑换码后没有收到？

14.7 兑换码无法兑换怎么办？

15. 使用安全建议

16. 联系支持

17. xAI / Grok 兼容接口配置

Grok Chat Completions 示例

18. Nanobanana 接口使用