messages.content.type 参数非法，取值范围 ['text']：Codex

Quick fix

更新到 v3.20.2 并重新导入智谱 GLM 预设；要在 Codex 中传图，请选择支持视觉的模型。

Symptom

报错原文复制

CC Switch local proxy failed while handling Codex endpoint /responses. Provider: Zhipu GLM; model: glm-5.1; upstream_status: HTTP 400; cause: messages.content.type 参数非法，取值范围 ['text']

Cause

Codex 通过 `/responses` 发送图片时，智谱 Chat 端点会收到它不接受的图片 content part，并返回 `messages.content.type` 400。GLM 纯文本模型（包括 issue 中提到的 glm-5.1、glm-5.2、glm-5.3）没有视觉能力，因此不能直接处理图片。早期 issue 的修复包括选择 Chat Completions 上游格式，以及启用图片整流器；维护者后来说明 v3.17.0 已补齐 glm-5.2 的纯文本能力识别和图片剥离兜底。对于 glm-5.3，v3.20.2 将预设改为官方 Responses 端点并标记为纯文本；重新导入预设后，附图时应提示模型不支持图片，而不是中途 400。

Fix

1. 1

   将 CC Switch 更新到 v3.20.2 或更高版本，并重新导入「Zhipu GLM」预设；存量卡不会自动更新端点。

2. 2

   如果仍使用旧版配置，在 Codex 的智谱 GLM 供应商设置中将「上游格式」选为 Chat Completions；对于 glm-5.2 图片报错，维护者还建议开启设置里的整流器。

3. 3

   需要在 Codex 中发送图片时，改用支持视觉的型号。维护者指出可在供应商卡片中手动添加视觉型号并勾选图片模态；预设本身不含 glm-5.3v。

Affected Versions

ToolCodex

Version3.16.2、3.16.3、3.16.4、3.19.1、3.20.1（报告版本）

Platforms未知

Source Issues

本页汇总自 6 个真实 issue

• #4107在codex中，使用CCswitch切换国内模型（使用本地路由），重启后，如果发送的内容中含有图片，则报错
• #4173[Bug] Codex 走 Responses API 时图片未转换，第三方 provider（智谱等）报 content.type 非法
• #4554[Bug] Zhipu GLM provider returns HTTP 400 on Codex /responses endpoint — messages.content.type
• #4792CC Switch local proxy failed while handling Codex endpoint /responses. Provider: Zhipu GLM5.2; model: glm-5.2; upstream_status: HTTP 400; cause: messages.content.type 参数非法，取值范围 ['text']
• #6151CC Switch local proxy failed while handling Codex endpoint /responses. Provider: Zhipu GLM; model: glm-5.2; upstream_status: HTTP 400; cause: messages.content.type 参数非法，取值范围 ['text']
• #7142CC Switch local proxy failed while handling Codex endpoint /responses. Provider: Zhipu GLM; model: glm-5.3; upstream_status: HTTP 400; cause: messages.content.type 参数非法，取值范围 ['text']

FAQ

升级后仍出现这个错误怎么办？

确认已重新导入更新后的智谱 GLM 预设；旧卡片不会自动更新端点。若仍能复现，issue 维护者建议附上脱敏请求日志。

开启整流器后还是报错怎么办？

有用户反馈开启整流器后仍报错；维护者随后说明 v3.17.0 已把 glm-5.2 纳入纯文本模型能力表并补齐图片剥离与媒体失败兜底。升级后若原始图片场景仍复现，请附上脱敏请求日志。

智谱 GLM 能在 Codex 里处理图片吗？

issue 中提到的 glm-5.1、glm-5.2、glm-5.3 被维护者说明为纯文本模型。要传图，请选择支持视觉的型号；维护者指出可手动添加型号并勾选图片模态。

相关问题

401 Unauthorized升级到 cc-switch 4.0.x；或手动清空 ~/.codex/auth.json 中残留的第三方 OPENAI_API_KEY 后重启 Codex，重新走 ChatGPT OAuth 登录。2 issues mergedapi failed deserialize json body into按错误类型回退 Claude Code、升级 cc-switch、关闭本地代理或停止发送不支持的字段。8 issues merged在线更新时卡死无响应 CC Switch在 FlClash TUN 模式下 CC Switch 在线更新会卡死，请切换为系统代理模式或手动下载覆盖安装。2 issues merged