Skip to content
CC Switch WikiUnofficial Community Wiki

image_detail is invalid: Codex StepFun Screenshot Request Failure

Quick fix

Upgrade CC Switch to v3.20.4; it changes tool screenshot detail: "original" to the StepFun-accepted "auto".

Symptom

Section titled “Symptom”
Error output
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

Section titled “Cause”

In CC Switch 3.20.3, images generated by the Codex screenshot tool are sent to StepFun through the Responses-to-Chat Completions conversion path. This path passes `detail: "original"` unchanged, but StepFun's `step-5-preview` rejects that value and returns `image_detail is invalid`. Images pasted directly into user messages use a different path, so they do not have the same issue.

The maintainer confirmed this was fixed in v3.20.4: `detail: "original"` for tool-returned images is rewritten to `"auto"`. Providers using Chat conversion also no longer declare support for `original` in the generated Codex catalog.

Fix

Section titled “Fix”

  1. Upgrade CC Switch from 3.20.3 to v3.20.4.

  2. After upgrading, switch the StepFun Codex provider again so CC Switch rewrites the Codex configuration and model catalog.

  3. If the current session history already contains screenshots, request again directly; the fix rewrites `detail: "original"` for tool-returned images to `"auto"`.

Affected Versions

Section titled “Affected Versions”
ToolCodex
Version3.20.3（受影响）；v3.20.4 已修复
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 1 real issues

FAQ

Section titled “FAQ”
After upgrading to v3.20.4, must I restart a session that already contains screenshots?
No. The maintainer stated that the fix rewrites `detail: "original"` for tool-returned images in the session history, so you can request again directly.
What information should I provide if the issue still occurs after upgrading to v3.20.4?
Reopen the issue and attach the proxy log line.
Section titled “Related problems”
400 MissingParameter: input.typeNo verified fix is available. The reporter's direct tests returned 200 with "type": "message", but the proxy patch remains a proposal.1 issues mergedCodex image requests return 400 through proxy: base64 inflation or invalid detailIf image history causes context overflow, upgrade to v3.19.0; if detail original is invalid, disable supports_image_detail_original for the affected model.3 issues mergedAuth conflictLog out of the official Claude login, clear conflicting ANTHROPIC_* variables, set hasCompletedOnboarding to true in ~/.claude.json, and restart the terminal.6 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.