首页 / AI工具 / Codex++ 中使用 DeepSeek API 报 404 怎么解决?
AI工具

Codex++ 中使用 DeepSeek API 报 404 怎么解决?

Codex++ 中使用 DeepSeek API 报 404 怎么解决?

Codex++ 配置 DeepSeek 时遇到 404 错误,是很多用户都会踩到的“坑”。本文从错误原因、解决方法到最佳配置实践,带你一次性解决这个问题。

404 错误为什么会出现?

Codex++ 早期版本默认使用 OpenAI 的 Responses API(端点为 /v1/responses),而 DeepSeek 目前仅支持标准的 Chat Completions API(端点为 /v1/chat/completions)。当 Codex++ 直接请求 DeepSeek 不支持的路径时,服务器会返回 404 Not Found。

简单来说,就是地址不对、协议不兼容导致的。

快速解决:修改 Base URL 和协议

  1. 进入 Codex++ 的「供应商配置」页面。
  2. 将 Base URL 填写为:https://api.deepseek.com
  3. 上游协议选择 Chat Completions(不要选 Responses)。
  4. 填入你在 DeepSeek 平台创建的 API Key,保存后即可生效。

修改完成后,重启 Codex++,发送测试指令即可验证是否成功。

获取 DeepSeek API Key

  1. 访问 DeepSeek 开放平台
  2. 登录后进入「API Keys」页面,点击「创建 API Key」。
  3. 命名后生成密钥,立即复制保存(页面关闭后将无法再次查看)。

推荐配置:双模型共存(DeepSeek + 七牛云)

如果你希望同时使用 DeepSeek 官方模型和七牛云 AI(新用户免费 300 万 token),可在 ~/.codex/config.toml 中添加以下配置:

model_providers.deepseek
name = "DeepSeek"
base_url = "https://api.deepseek.com/v1"
env_key = "DEEPSEEK_API_KEY"
wire_api = "chat"

model_providers.qiniu
name = "七牛云 AI"
base_url = "https://api.qiniu.com/v1"
env_key = "QINIU_API_KEY"
wire_api = "chat"

配置完成后,可在 Codex++ 中自由切换模型,互不冲突。

常见错误及处理

错误提示 原因 解决方法
404 Not Found 协议或地址错误 改用 Chat Completions + 正确 Base URL
401 Unauthorized API Key 无效 检查 Key 是否完整、正确
402 Insufficient Balance 余额不足 登录 DeepSeek 平台充值
连接失败 网络或代理问题 检查网络、关闭代理后重试

总结

Codex++ 接入 DeepSeek 报 404 的核心原因是接口协议不匹配。只要把 Base URL 改为 https://api.deepseek.com,协议选 Chat Completions,并正确填写 API Key,即可快速解决。配置双模型后还能享受更多免费额度,建议新手直接一步到位。

分享到: 微博