Codex App 自定义中转站图片不显示？原因与修复方法一次说清

问题现象：生图成功，但 App 里看不到图片

新版 Codex App 在接入自定义中转站后，常见一个很典型的问题：

• 生成图片流程显示成功
• 本地或后端也能拿到结果
• 但 App 页面里就是不显示图片

很多人第一反应会怀疑是中转站转发失败，实际上，问题往往不在服务端，而在客户端是否启用了生图工具。

核心原因：requires_openai_auth = false 让 Codex 关闭了本地生图能力

当自定义 Provider 设置了 requires_openai_auth = false 时，Codex 默认会认为当前环境不需要启用 OpenAI 认证相关能力。

这会带来一个直接影响：

• Codex 不会自动启用本地 image_gen 生图工具
• 图片虽然可能已经生成，但不会进入 App 的正常展示流程
• 最终表现就是“有结果、没图片”

也就是说，这不是简单的渲染问题，而是客户端功能开关没有打开。

解决方法：在 config.toml 里补上请求头

要让 Codex 正常启用生图工具，需要在 config.toml 中添加下面这段配置：

http_headers = { "x-openai-actor-authorization" = "任意非空值" }

这条配置的关键点只有两个：

• 请求头必须存在
• 值必须是非空字符串

Codex 只检查这个请求头是否存在，并不会解析它的具体内容。所以这里不需要填写真实敏感信息，只要是任意非空值即可。

配置后会发生什么？

加上这个请求头之后，Codex 的行为会恢复正常：

• 自动启用生图工具
• 生成的图片会保存到本地
• 图片会在 App 中正常展示

如果之前一直是“生成成功但不显示”，通常补上这项配置后就能立刻恢复。

为什么不能只靠中转站服务端解决

有些人会想，既然图片已经生成了，能不能直接让中转站服务端处理展示问题。

实际上不行，因为这属于 Codex 客户端内部的功能判断：

• 是否启用 image_gen
• 是否保存本地图片
• 是否把图片展示到 App 界面

这些都不是中转站单方面能完全替代的。服务端可以转发请求，但客户端是否进入对应流程，仍然取决于它自己的判断条件。

排查建议：出现问题时先看这几项

如果 Codex App 生图后不显示，可以按下面顺序检查：

1. config.toml 是否已正确配置
2. http_headers 是否写在有效位置
3. x-openai-actor-authorization 是否为空
4. 自定义 Provider 是否设置了 requires_openai_auth = false
5. App 是否已重新加载配置或重启

只要配置正确，通常就能恢复正常展示。

简单总结

Codex App 使用自定义中转站时，图片不显示的关键原因，通常是 requires_openai_auth = false 导致本地生图工具没有启用。

最直接的修复方式，就是在 config.toml 中加入：

http_headers = { "x-openai-actor-authorization" = "任意非空值" }

这会让 Codex 识别到必要请求头，从而启用 image_gen，并把图片正常保存和展示出来。