Skip to content

Codex 图片生成:兼容模式 ​

使用 config.toml 配置 Responses 和远程模型目录,用同目录的 auth.json 保存本站令牌。此方式与 API Key Mode、技能生图并列;本站推荐使用技能生图。

开始前准备

准备有权限的 plus池 令牌,主模型使用 gpt-6.1-sol。本模式与 API Key Mode 共用本站固定远程模型目录,无需手动下载 JSON。远程目录读取按 Codex CLI 0.167.1 验证,实际图片能力仍需客户端、服务端与令牌权限共同支持。

1. 准备令牌与两个配置文件 ​

在 FQHX 令牌设置中固定选择有权限的 plus池,确认所需文本与图片模型权限。本模式仅使用 plus池;如果使用正价纯pro号池,请改按技能生图教程配置。

先退出 Codex,备份已有的 config.toml 和 auth.json。模型目录由本站通过固定网址提供,不用下载、复制或手动更新 JSON。

配置完成后,本站每天自动从 NewAPI 同步 GPT 文本/编程主模型,匹配对应元数据并发布到同一远程网址;未来新增 GPT 也按此流程纳入,检查失败时保留旧版。客户端刷新目录后获得新内容,不保证已有会话即时切换;修改配置后重启 Codex。普通 /v1/models 的返回结果提供名单,不能原样替代 Codex 原生目录。

在文件资源管理器地址栏粘贴 %USERPROFILE%\.codex,打开或手动创建该目录:

  • 主配置:%USERPROFILE%\.codex\config.toml
  • 认证文件:%USERPROFILE%\.codex\auth.json

用记事本编辑文件,保存类型选择“所有文件”,使用 UTF-8。确认文件没有多余的 .txt 后缀。%USERPROFILE% 不区分大小写,与 %userprofile% 指向同一用户目录。

设置了 CODEX_HOME 时,两个配置文件都放在该目录下,远程目录网址保持不变。在 WSL、容器或远程环境运行 Codex 时,应在实际执行环境中放置配置。

2. 写入 config.toml ​

两类系统共用以下内容。此方案使用名为 OpenAI 的 provider,主模型和审查模型均为 gpt-6.1-sol。

toml
model_provider = "OpenAI"
model = "gpt-6.1-sol"
review_model = "gpt-6.1-sol"
cli_auth_credentials_store = "file"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://newapi.fq-hx.com/v1"
model_catalog_url = "https://docs-ai.fq-hx.com/downloads/codex-image-models.json"
wire_api = "responses"
requires_openai_auth = true

[features]
image_generation = true
api_key_model_discovery = true
goals = true
关键配置作用
model_provider与 [model_providers.OpenAI] 的名称对应,大小写保持一致
model / review_model本例均为 gpt-6.1-sol,与配套目录匹配;不要替换为 gpt-image-*
base_urlResponses 的 API 基础地址
model_catalog_url位于实际 provider 下,读取本站固定远程目录,无需本地 JSON 文件
api_key_model_discovery = true保持 API Key 的远程模型发现开启
requires_openai_auth = true使用 Codex 的登录凭据来源;本教程在 auth.json 中保存 API Key,本页不另设 provider 显式 API Key
cli_auth_credentials_store = "file"明确采用文件存储,便于使用下一步手动填写的 auth.json;这是在提供的模板上补充的存储设置
image_generation = true显式启用客户端图片功能,仍需服务端和模型支持
goals = true保留模板中的目标功能设置,不是图片生成开关

移除已有的 model_catalog_json。 本地目录优先级更高,会阻止远程读取;检查实际生效的用户配置和 profile。旧 JSON 可作为备份保留,不再需要更新。

远程目录见 codex-image-models.json,维护时间、已验证客户端版本和模型来源见更新信息。名单从本站 NewAPI /v1/models 同步,不限于当前几个模型;只包含 GPT 文本/编程主模型,不包含图片、音频、视频或其他平台,也不代表你的令牌具备所有模型权限。gpt-6.1-sol 的 use_responses_lite=false 由站点维护,不在 TOML 根层级添加同名字段。

读取目录时客户端会携带当前 provider 的认证信息,只使用本站提供的可信目录地址。仅使用账号 OAuth、自定义 Header 或不支持远程目录的旧版本时,不能直接套用本页 API Key 方案。

其余兼容字段按提供的模板保留,是否识别和生效取决于所用 Codex 版本。把这份配置作为独立方案使用,已有同名表时合并字段,避免重复粘贴整段配置。

3. 写入 auth.json ​

将同一服务对应的本站 plus池 令牌填入 OPENAI_API_KEY 的值:

json
{
  "OPENAI_API_KEY": "sk-替换为你的本站plus池令牌"
}

不能保留空字符串,也不要填写环境变量名称或占位符。这里的 OPENAI_API_KEY 是认证文件的字段名,值使用本站提供的令牌;无需为此额外申请官方 API Key。

此处不填写 Sub2API 管理接口 JWT、账号 access token 或 refresh token。已有 ChatGPT 登录信息时,先妥善备份再切换,避免把不同认证方案的内容混写到同一个文件中。

auth.json 会在本机保存明文凭据,不要上传仓库、共享工作区、工单或技能压缩包。切换回原方案时,恢复相应的配置和认证来源。

4. 重启 Codex 并使用图片功能 ​

保存两个配置文件,确认远程目录地址位于当前 provider 下,完全退出旧会话,在项目目录重新启动:

text
codex

进入 Codex 对话框,输入图片提示词,例如:

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

本模式的图片工具与能力由客户端及服务端兼容配置提供;本地目录加载或文字对话成功不等于图片功能一定可用。生成后查看 Codex 返回的实际文件路径和图片内容,图片调用会消耗额度。

5. 与另外两种方式如何选择 ​

方式支持分组主要操作
本页兼容模式仅 plus池编辑 config.toml 和 auth.json,读取远程目录,在对话中使用内置图片工具
API Key Mode仅 plus池保存环境变量令牌,配置功能 Header、远程目录与图片开关
技能生图 ☆正价纯pro号池、plus池 均支持复制 fqhx-imagegen 技能,用 $fqhx-imagegen 提示词;教程以 pro池 为例

API Key Mode 和兼容模式共用同一份远程模型目录,但认证配置不同:前者使用 env_key 和指定功能 Header,后者使用 requires_openai_auth=true 与 auth.json。按所选方式使用对应的完整 TOML,不直接把两份配置叠加。技能生图不依赖这份目录。

配置遇到问题时展开
情况优先检查
提示缺少 API Key 或认证失败auth.json 的目录、字段、令牌是否为空,以及是否设置了 file 存储
已保存 Windows 用户环境变量但此模式仍认证失败本页读取 auth.json;本页采用文件认证;不要混用其他供应商的环境变量或内联令牌
找不到模型目录或无法识别检查当前 provider 的 model_catalog_url、客户端版本与目录访问是否正常
仍使用旧目录移除生效配置中的 model_catalog_json,启用 api_key_model_discovery 后重启
文本正常但没有图片工具检查图片开关、远程模型目录和实际 provider,再联系管理员确认入口的图片能力与模型权限
修改后仍使用旧配置检查 CODEX_HOME、当前 profile 和文件位置,并重启客户端

基础请求格式统一见首页 HTTP 模块。

配置与认证字段参考 OpenAI Docs:配置参考、远程模型目录、认证与凭据存储。本次验证目录读取,不将其作为内置图片生成或编辑成功的证明。

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