404 Not Found: CC Switch proxy failed /responses - Codex

Quick fix

DeepSeek 不支持 Responses API，请使用内置预设走 Chat Completions 路由；若因图片报错需修改模型目录移除 image 模态。

Symptom

报错原文复制

unexpected status 404 Not Found: CC Switch local proxy failed while handling Codex endpoint /responses. Provider: DeepSeek; model: deepseek-v4-pro; upstream_status: HTTP 404; cause: 上游错误 (404):, url: http://127.0.0.1:15721/v1/responses

Cause

本集群包含多种 HTTP 404 变体。最常见的是 DeepSeek 官方端点不支持 Codex 的 `/responses` 接口，直接请求会返回 404。此外还有其他变体：若报错 `No endpoints found that support image input`，是因为 DeepSeek 为纯文本模型，但模型目录配置误包含 `image` 模态，导致整流器未剥离图片；若为 `/v1/models` 返回 404 且模型列表为空，是 Codex 桌面端限制，需保留官方登录态；若为第三方网关（如 OpenCode Go）404，需手动补全 `/v1` 路径；若为 MiMo 用量查询 404，则是因厂商未开放该 API。

Fix

1. 1

   针对 DeepSeek `/responses` 404，请勿直接填写官方 API 地址，改用 CC Switch 内置的 DeepSeek 预设，使其走 Chat Completions 路由接管。

2. 2

   针对图片输入导致的 `No endpoints found that support image input` 404，需修正模型目录配置，移除不支持的 image 模态。

   // ~/.codex/cc-switch-model-catalog.json
   {
     "input_modalities": ["text"]
   }

3. 3

   针对 `/v1/models` 404 导致模型列表为空，需在 Codex 桌面端先登录官方 ChatGPT 账号，并在 CC Switch 中开启「切换第三方时保留官方登录」，随后重启 Codex。

4. 4

   针对 OpenCode Go 等第三方网关 404，请在 CC Switch 的 endpoint 配置中手动补全 `/v1` 后缀（如 `https://opencode.ai/zen/go/v1`）。

Affected Versions

ToolCodex

Version3.14.1 - 3.19.1

PlatformsWindowsmacOS

Source Issues

本页汇总自 5 个真实 issue

• #3230[Bug] Xiaomi MiMo provider 用量查询失败 - /user/balance 返回 404
• #3528Codex OpenCode Go endpoint does not append /v1 automatically
• #3692Codex 模型列表为空，codex程序主动删除deepseek模型显示
• #3859MAC上 Openai 切换到 deepseek 有问题
• #6176[BUG] DeepSeek 模型收到图片导致 OpenRouter 404，整流器未剥离图片

FAQ

为什么切换到 DeepSeek 后，Codex 桌面端不显示第三方模型，且 `/v1/models` 返回 404？

这是 Codex 桌面端的限制，未登录官方账号时会强制回落。请先登录一次官方 ChatGPT 账号，并在 CC Switch 开启「切换第三方时保留官方登录」，重启后即可恢复显示。

使用 OpenRouter 接入 DeepSeek 时，发送图片后后续所有请求都报 404 怎么解决？

这是因为 `cc-switch-model-catalog.json` 中模型的 `input_modalities` 错误包含了 `image`，导致整流器未剥离图片。请手动将该字段改为 `["text"]`。

配置 OpenCode Go 等自定义网关时，请求 `/chat/completions` 返回 404 怎么办？

CC Switch 不会自动为所有自定义网关追加 `/v1`。请在配置 endpoint 时手动填写完整的 API root，例如 `https://opencode.ai/zen/go/v1`。

配置 Xiaomi MiMo 后，点击用量查询返回 404 怎么办？

MiMo 官方暂未开放余额查询 API，CC Switch 默认生成的查询路径会返回 404。建议忽略此报错或在配置中禁用用量查询功能。

相关问题

通用配置勾选会不生效，还会被之前的配置覆盖 Codex CC Switch升级到 CC Switch v3.17.0 及以上可修复 Codex 通用配置合并失效；若仍被旧快照覆盖，先切到其他供应商再切回以触发自愈。21 issues mergedInvalid schema for function升级 cc-switch 至 v3.18.0+，修复 Codex 工具参数缺失 type: object 导致的上游 400 报错。5 issues mergedunexpected status 401 Unauthorized - Codex手动修改 Codex 的 config.toml，添加 model_provider 声明及对应的 provider 配置段，或升级 cc-switch 至最新版。2 issues merged