image_detail is invalid：Codex StepFun 截图请求失败

Quick fix

升级 CC Switch 至 v3.20.4；它会将工具截图的 detail: "original" 改为 StepFun 可接受的 "auto"。

Symptom

报错原文复制

CC Switch local proxy failed while handling Codex endpoint /responses. Provider: StepFun; model: step-5-preview; upstream_status: HTTP 400; cause: url invalid. url: . msg: image_detail is invalid

Cause

在 CC Switch 3.20.3 中，Codex 截图工具产生的图像会经由 Responses 到 Chat Completions 的转换路径传给 StepFun。该路径将 `detail: "original"` 原样传递，而 StepFun 的 `step-5-preview` 拒绝该值，返回 `image_detail is invalid`。直接粘贴到用户消息中的图片走的是另一条路径，因此不会出现同一问题。

维护者确认该问题已由 v3.20.4 修复：工具返回图片的 `detail: "original"` 会改写为 `"auto"`，同时使用 Chat 转换的供应商不再在生成的 Codex catalog 中声明支持 `original`。

Fix

1. 1

   将 CC Switch 从 3.20.3 升级至 v3.20.4。

2. 2

   升级后重新切换一次 StepFun 的 Codex provider，使 CC Switch 重写 Codex 配置及模型 catalog。

3. 3

   若当前会话历史中已有截图，可直接再次请求；修复会将其中工具返回图片的 `detail: "original"` 改写为 `"auto"`。

Affected Versions

ToolCodex

Version3.20.3（受影响）；v3.20.4 已修复

PlatformsWindows

Source Issues

本页汇总自 1 个真实 issue

• #7555[Bug] StepFun + Codex: screenshot requests fail with 400 image_detail is invalid - detail:"original" passed through by the Responses->Chat conversion (same class as #6495)

FAQ

升级到 v3.20.4 后，已经包含截图的会话还需要重新开始吗？

不需要。维护者说明修复会改写会话历史中工具返回图片的 `detail: "original"`，因此可直接再次请求。

如果升级到 v3.20.4 后仍然发生该问题，应提供什么信息？

请重新打开该 issue，并附上代理日志行。

相关问题

400 MissingParameter: input.type原帖尚未提供可验证的解法；报告者直连测试确认补齐 "type": "message" 可返回 200，但代理转换补丁仍是建议。1 issues mergedCodex 图片经代理后请求 400：base64 膨胀或 detail 无效若图片历史导致上下文超限，升级到 v3.19.0；若报 detail original 无效，关闭对应模型的 supports_image_detail_original。3 issues mergedAuth conflict退出 Claude 官方登录、清理冲突的 ANTHROPIC_* 环境变量，并将 ~/.claude.json 的 hasCompletedOnboarding 设为 true 后重启终端。6 issues merged