Skip to content

CC Switch · API Key Mode ​

在 CC Switch v4.0.25 中配置固定功能 Header、远程模型目录和图片开关,使用 Codex 内置图片工具。

开始前准备

令牌需同时有 gpt-6.1-sol 文本模型与对应图片模型权限。先完成基础接入。主模型始终为 GPT 文本模型;API Key 填入 CC Switch 表单,本站 Header 不替代认证。

1. 添加图片供应商 ​

先在 FQHX 令牌设置准备固定为 plus池 的令牌,再在 Codex 的直连页添加独立配置,例如 FQHX · plus池 · API Key Mode。API Key 填入这枚 plus池 令牌,地址使用本站 /v1,协议选择 Responses。

供应商名称和 Header 不会改变令牌分组。 正价纯pro号池 用户请选择技能生图。

2. 编辑供应商配置 ​

打开供应商编辑框,将下面的字段合并到当前配置中。保留已有 MCP、权限等个人设置,避免重复创建同名 TOML 表。

toml
model_provider = "custom"
model = "gpt-6.1-sol"

[model_providers.custom]
name = "FQHX"
base_url = "https://newapi.fq-hx.com/v1"
wire_api = "responses"
model_catalog_url = "https://docs-ai.fq-hx.com/downloads/codex-image-models.json"
supports_websockets = false
http_headers = { "x-openai-actor-authorization" = "local-image-extension" }

[features]
image_generation = true
api_key_model_discovery = true
CC Switch v4.0.25:API Key Mode 的固定功能 Header、provider 远程目录与 features 开关
按编号合并 Header、远程目录和功能开关;上方 API Key 单独保存
配置位置内容与用途
表单 API Key实际 plus池 令牌,由 CC Switch 写入 provider
model_providers.custom当前供应商的地址、协议、model_catalog_url 与 http_headers
features全局 image_generation、api_key_model_discovery,影响其他供应商

local-image-extension 是本站固定标记,不是令牌,不要替换为自己的 API Key。此配置针对本站兼容服务,不承诺其他中转服务接受同一 Header。

3. 排除目录与认证混用 ​

移除实际生效配置及 profile 中的 model_catalog_json,避免它覆盖远程目录。若 CC Switch 模型映射重新生成本地目录,按目录冲突说明处理;需要保留映射时可使用不依赖该目录的技能方式。

本页由 CC Switch 保存供应商令牌,不额外加入手动版的 env_key 或 auth.json 配置;保留官方登录时,让 CC Switch 处理 requires_openai_auth。已有 FQHX_BASE_URL、FQHX_MODEL 等技能覆盖变量只影响技能调用,不是本页内置工具开关。

4. 保存、切换和生成 ​

保存后切换到图片供应商,完全退出并重新打开 Codex。CLI 以普通 codex 启动,避免旧的 profile 覆盖当前 provider。

在 Codex 对话框中输入:

text
$imagegen 生成一张森林中的白狐插画,无文字,保存为 output/imagegen/fox.png。

编辑时在 Codex 中附图并说明:

text
$imagegen 编辑附图:只将背景改为浅蓝色,保留角色外观、表情、构图和画风,另存为 output/imagegen/avatar-blue.png,不覆盖原图。

内置工具通常先保存到 Codex 配置目录的 generated_images,再按提示词保存到目标位置。请求会消耗额度;查看实际文件路径和图片内容判断完成状态。

5. 系统目录与问题排查 ​

默认配置为 %USERPROFILE%\.codex\config.toml,内置图片目录为 %USERPROFILE%\.codex\generated_images\。在文件资源管理器地址栏打开对应路径。设置 CODEX_HOME 或 WSL 后,以实际执行环境为准。

使用遇到问题时展开
现象优先检查
没有内置图片工具图片开关、模型目录、文本主模型与客户端版本,重启后再看
切回图片供应商后配置丢失Header 是否写在当前 custom provider,是否通过供应商编辑框保存
仍使用本地目录检查模型映射、model_catalog_json 和 profile 是否重新覆盖
文本成功但图片失败固定 plus池,核对图片模型权限及服务端能力

基础请求格式统一见首页 HTTP 模块。此页的设置与截图不替代实际生图能力验证。

本站提供 FQHX 接入说明;模型能力与审核规则以上游平台最新规定为准。