Skip to content

Codex 图片生成:API Key Mode ​

启用 Codex 内置图片工具,直接用自然语言生成图片或编辑附图。

开始前准备

令牌需同时有 gpt-6.1-sol 文本模型与 gpt-image-2 图片模型权限。先完成 Codex 基础配置,再按本页步骤添加独立的图片配置。

1. 确认分组与图片权限 ​

在 FQHX 令牌设置固定选择 plus池。本方式不用于 default 或正价纯pro号池;这两个池未提供所需的 Images 入口。图片生成和编辑会消耗额度。

主对话仍使用 Responses 和 GPT 文本主模型,内置图片工具分别调用 Images 生成与编辑接口。电脑上无需安装 fqhx-imagegen 技能。

2. 准备图片配置文件 ​

模型目录统一从本站固定网址读取,不再需要下载或手动更新 JSON 文件。本站每天自动从 NewAPI 同步 GPT 文本/编程主模型并匹配对应元数据,成功检查后发布到同一网址;未来新增 GPT 也按此流程纳入。客户端刷新目录后获得新内容,已打开的会话不保证即时切换,更新配置后请重启 Codex。

本次远程目录配置使用 Codex CLI 0.167.1 验证。新建 image.config.toml,启动时通过 --profile image 选择。文件与用户级 config.toml 放在同一目录;它作为覆盖层读取,不是项目中的 .codex/config.toml。旧版本不识别远程目录时先升级。已有同名文件时先备份。

默认放置位置:

  • 图片配置:%USERPROFILE%\.codex\image.config.toml
  • 内置工具生成目录:%USERPROFILE%\.codex\generated_images\

在文件资源管理器地址栏粘贴 %USERPROFILE%\.codex。用记事本新建 image.config.toml,保存类型选择“所有文件”,使用 UTF-8,确认文件名没有多余的 .txt。

显式设置 CODEX_HOME 时,配置和内置工具生成目录改到该目录下,远程目录网址保持不变。在 WSL、容器或远程主机运行时,配置、技能、Node.js(技能方式)及环境变量必须在实际执行 Codex 的环境中可用;WSL 内按 Linux 目录配置。

3. 复制并修改配置 ​

将以下内容写入 image.config.toml。FQHX_API_KEY 必须保存 plus池 令牌。按基础配置设置环境变量;如果原来保存的是 pro池 或 default 令牌,先换成用于本模式的 plus池 令牌,并重开终端/Codex。无需另配官方 API Key。

基础配置与本页共用 FQHX_API_KEY 时,会使用同一池的令牌。希望同时保留 pro池 文本配置与 plus池 图片配置时,为图片令牌使用单独的环境变量名称,并将下面的 env_key 改为该名称,避免覆盖日常文本配置使用的令牌。

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

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

[features]
image_generation = true
api_key_model_discovery = true

local-image-extension 是固定功能标记,不是 API Key,不要替换为令牌。model_catalog_url 与 http_headers 放在实际使用的 provider 下;两个功能开关放在 [features] 下。已有这些表时合并字段,不重复粘贴同名表。

模型目录与已有配置的合并说明

如果以前配置过 model_catalog_json,请从实际生效的配置或 profile 中移除;本地目录优先级更高,会阻止远程读取。旧 JSON 可以作为备份保留,无需再手动更新。

远程目录地址固定为 codex-image-models.json,更新信息列出维护时间、已验证客户端版本、模型名单和来源。名单由本站 NewAPI /v1/models 同步并匹配 Codex 元数据,不固定在当前几个模型;图片、音频、视频及其他平台不进入主模型目录。它不代表你的令牌能调用全部模型。gpt-6.1-sol 的 use_responses_lite=false 由站点维护,不在 TOML 根层级另加同名字段。普通 /v1/models 返回结果不能原样替代它;同步失败会保留已发布版本。

客户端读取此网址时会携带当前 provider 的认证信息,只使用本站提供的可信地址。若希望直接修改日常 config.toml,合并上述字段、保留其他个人配置后以普通 codex 启动;独立配置则使用下一步命令。

此 Header 的具体作用依据本站兼容服务配置和本机验证记录;OpenAI 官方文档说明的是通用 provider Header、模型目录和 profile 配置,不保证所有中转服务都支持这个固定标记。

4. 启动并生成图片 ​

退出旧会话,在项目目录启动:

text
codex --profile image

在 Codex 对话框中输入以下内容;不要在 PowerShell 中直接执行以 $ 开头的技能提示词:

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

5. 编辑图片与保存结果 ​

附图编辑时可先从项目目录启动带图片的会话(路径含空格时保留引号):

text
codex --profile image --image "./input/avatar.png"

然后输入:

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

内置工具先保存到配置目录下的 generated_images/;提示词指定项目路径后,Codex 再将图片保存到目标位置。以返回的实际文件路径和图片内容判断是否成功,单纯的文字确认不代表完成生图。

使用遇到问题时展开
现象检查项
没有内置 image_gen 工具是否选择 image profile、Header 所在 provider、远程目录地址、图片功能开关;修改后重启
仍使用旧模型目录移除生效配置里的 model_catalog_json,确认启用 api_key_model_discovery 后重启
文本正常,图片返回模型或接口错误是否固定 plus池,是否同时具有文本和图片模型权限
配置变更后无效检查 CODEX_HOME、实际 profile,以及是否编辑了另一个环境的文件
图片未出现在项目中查看实际保存路径,并在提示词中指定目标文件名

基础接口排查使用首页 HTTP 验证模块。

兼容范围与资料

本机已有生成、附图编辑和保存记录基于 Codex CLI 0.167.0。固定 Header 的作用依据本站兼容服务及本机验证,不是所有中转服务通用的图片开关。

plus池 的账号配置由 Sub2API 管理。只有明确需要账号 OAuth 的接入场景,才参考Sub2API 授权信息教程并联系管理员;本页图片配置仍使用 FQHX 令牌。

官方资料:高级配置、配置参考、图片生成与编辑。

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