外观
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
| 配置位置 | 内容与用途 |
|---|---|
| 表单 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 后,以实际执行环境为准。
默认配置为 ~/.codex/config.toml,内置图片目录为 ~/.codex/generated_images/。macOS 用 Finder“前往文件夹”,Linux 用文件管理器显示隐藏目录。显式设置 CODEX_HOME 时改用该目录。
使用遇到问题时展开
| 现象 | 优先检查 |
|---|---|
| 没有内置图片工具 | 图片开关、模型目录、文本主模型与客户端版本,重启后再看 |
| 切回图片供应商后配置丢失 | Header 是否写在当前 custom provider,是否通过供应商编辑框保存 |
| 仍使用本地目录 | 检查模型映射、model_catalog_json 和 profile 是否重新覆盖 |
| 文本成功但图片失败 | 固定 plus池,核对图片模型权限及服务端能力 |
基础请求格式统一见首页 HTTP 模块。此页的设置与截图不替代实际生图能力验证。