溪溪小店文档站

切换主题

Codex 使用 Image 2 生图与网页搜索配置 ​

本站已经支持 Image 2 生图。在 Codex 中使用时，是否需要修改配置取决于当前的登录方式。

本文配置不只用于生图。完成配置后，Codex 的 Image 2 生图和网页搜索能力都会获得支持，无需分别配置。

是否需要配置 ​

当前情况是否需要额外配置
已经登录 ChatGPT/GPT 账号，并且模型请求使用本站不需要，直接使用即可
没有自己的 ChatGPT/GPT 账号需要按照本文修改 config.toml

如果你属于第二种情况，请继续完成下面的配置。

打开正确的配置文件 ​

需要修改的是 Codex 的用户级配置文件：

text
~/.codex/config.toml

Windows 中通常位于：

text
C:\Users\你的用户名\.codex\config.toml

也可以在 Codex 中打开 Settings → Configuration → Open config.toml。

不要修改项目配置

请勿将 Provider 配置写入项目目录中的 .codex/config.toml。Codex 的模型 Provider 和认证配置应放在用户级 ~/.codex/config.toml 中。

确认当前 Provider 名称 ​

打开 config.toml 后，先找到这一行：

toml
model_provider = "xxx"

这里的 xxx 只是示例。你的文件中可能是其他名称，例如：

toml
model_provider = "xxcd"

记住当前名称，后面的 [model_providers.xxx] 必须使用完全相同的 Provider 名称。

当前配置后续应修改的配置段
model_provider = "xxx"[model_providers.xxx]
model_provider = "xxcd"[model_providers.xxcd]
model_provider = "proxy"[model_providers.proxy]

不要照抄 xxx

除非你的 model_provider 本来就叫 xxx，否则必须将示例中的 xxx 替换为你当前使用的 Provider 名称。

添加生图配置 ​

找到现有的 Provider 配置段，例如：

toml
[model_providers.xxx]

在这个配置段中加入：

toml
requires_openai_auth = false

然后添加 Codex 生图功能所需的认证请求头：

toml
[model_providers.xxx.http_headers]
"x-openai-actor-authorization" = "local-image-extension"

合并后的结构如下。原有的 name、base_url、wire_api 等配置请继续保留：

toml
model_provider = "xxx"

[model_providers.xxx]
# 保留你原有的 Provider 配置
requires_openai_auth = false

[model_providers.xxx.http_headers]
"x-openai-actor-authorization" = "local-image-extension"

这两项配置的作用是：

配置项作用
requires_openai_auth = false当前自定义 Provider 不依赖 OpenAI 账号登录认证
x-openai-actor-authorizationCodex 使用的认证请求头，local-image-extension 可同时支持生图与网页搜索能力

一次配置，两种能力

该认证请求头同时适用于 Image 2 生图和网页搜索。配置并重启 Codex 后，两项能力都会生效。

不要重复声明 Provider

如果文件中已经存在 [model_providers.xxx]，请直接在原配置段中加入 requires_openai_auth = false，不要再创建第二个同名配置段，否则 TOML 会因为重复定义而无法解析。

已有 http_headers 时怎么处理 ​

如果 Provider 已经使用内联方式配置了请求头，例如：

toml
http_headers = { "X-Existing-Header" = "value" }

请将 Codex 生图认证请求头合并进去：

toml
http_headers = { "X-Existing-Header" = "value", "x-openai-actor-authorization" = "local-image-extension" }

此时不要再添加 [model_providers.xxx.http_headers]，两种写法选择一种即可。

重启 Codex ​

保存 config.toml 后，完全退出并重新启动 Codex，使新的 Provider 配置和请求头生效。

重启后，可以新建任务并分别测试生图和网页搜索。

测试生图：

text
生成一张可爱的横版插画，画面中是一名程序员在使用 AI 编写代码。

测试网页搜索：

text
搜索并整理今天的 AI 行业新闻，附上信息来源。

如果能够正常返回图片并执行网页搜索，说明配置已经生效。

常见问题 ​

修改后仍然无法生图 ​

依次检查：

  1. 是否修改了用户级 ~/.codex/config.toml。
  2. [model_providers.xxx] 中的名称是否与 model_provider = "xxx" 完全一致。
  3. requires_openai_auth 是否设置为 false。
  4. 请求头名称和值是否完整，且使用英文引号。
  5. 保存配置后是否完全重启了 Codex。

Codex 启动时提示配置错误 ​

通常是 TOML 格式或重复配置段导致的。请检查：

  • 是否重复写了两个 [model_providers.xxx]。
  • 是否同时使用了内联 http_headers 和 [model_providers.xxx.http_headers]。
  • 引号、等号和表名是否完整。

已登录 GPT 账号还需要添加吗 ​

如果你已经登录 ChatGPT/GPT 账号，并且当前模型调用已经正常使用本站，则无需额外添加本文配置。

参考资料 ​