外观
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/config.toml - 认证文件:
~/.codex/auth.json
macOS 用 Finder 的“前往 → 前往文件夹”打开 ~/.codex;Linux 用文件管理器显示主目录中的隐藏文件夹。目录不存在时手动创建,用纯文本编辑器保存为 UTF-8。
设置了 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_url | Responses 的 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:配置参考、远程模型目录、认证与凭据存储。本次验证目录读取,不将其作为内置图片生成或编辑成功的证明。