Cherry Studio 适合把多个 AI 模型、AI Agent 和本地工具放到同一个桌面客户端里管理。对使用 DeepAI API 中转站 的开发者来说，它的核心配置通常只有三项：Base URL、API Key 和模型 ID。但一旦同时涉及 OpenAI-compatible、Anthropic Messages、Claude Code 或本地 API Service，路径拼接就很容易踩坑。
GitHub Issue 背景：为什么会出现 /v1/v1/messages
在 Cherry Studio 的 GitHub 仓库中，有一个已经关闭并标记为 completed 的问题：API Service 的 Anthropic Messages 端点在转发 POST /v1/messages 时，可能把上游地址拼成 /v1/v1/messages，最终导致 404。Issue 中给出的复现路径很典型：用户在 Cherry Studio 里启用 API Service，配置 OpenAI-compatible 或 new-api 类型的上游，然后用 Anthropic Messages 格式访问本地 /v1/messages。
这个问题的关键不在模型本身，而在客户端和 SDK 对 Base URL 的理解不同：有的 OpenAI SDK 会把 baseURL 当成完整前缀，然后只追加 /chat/completions；而 Anthropic SDK 往往会在内部继续追加 /v1/messages。如果你传进去的基础地址已经带了 /v1，就可能出现重复路径。
DeepAI API 中转站里 Base URL 应该怎么理解
使用 DeepAI API 中转站时，先判断你当前工具调用的是哪一种协议。大多数聊天客户端、代码助手和工作流平台使用 OpenAI-compatible 接口，这类场景通常把 Base URL 设置为：
https://api.deepai.wang/v1
然后客户端会在这个基础上请求 /models、/chat/completions 或图片生成接口。不要把完整的 /chat/completions 填进 Base URL，也不要在模型名、Key 或代理配置里重复写路径。
但如果你使用的是 Anthropic Messages 风格接口，例如某些 Claude Code、API Service、Anthropic SDK 或兼容层，它们可能期望你填写的是“不带版本号的根地址”，再由 SDK 自己追加 /v1/messages。这时就要特别留意工具文档里的字段说明：它到底要的是 OpenAI-compatible Base URL，还是 Anthropic Base URL。
Cherry Studio 接入 DeepAI 的推荐配置流程
- 打开 Cherry Studio 的模型服务商设置，新建或编辑 OpenAI-compatible Provider。
- Base URL 填写
https://api.deepai.wang/v1，API Key 填写 DeepAI 后台生成的密钥。 - 手动添加一个确认可用的模型 ID，先用最短提示词测试普通聊天。
- 普通聊天可用后，再开启流式输出、Agent、MCP、文件解析或 API Service。
- 如果使用 Anthropic Messages 兼容路径，单独检查该字段是否需要去掉末尾的
/v1。
这个顺序很重要。先确认最小聊天链路能跑通，再逐步打开高级能力。否则一旦报错，很难判断问题来自 Key、模型、Base URL、客户端缓存，还是工具调用链。
遇到 404 时的排查清单
- 看请求路径：如果日志里出现
/v1/v1/messages，优先怀疑版本路径被重复拼接。 - 区分接口类型：
/chat/completions是 OpenAI-compatible 常见聊天路径，/messages多见于 Anthropic Messages。 - 不要混填字段：OpenAI-compatible Base URL 和 Anthropic Base URL 不一定能使用同一种写法。
- 用最小请求测试：先只测模型列表或一句简单对话，不要直接运行复杂 Agent。
- 检查客户端版本：GitHub Issue 已关闭，但旧版本客户端或相似兼容层仍可能保留同类问题。
401、403、429 不要和 404 混在一起排查
很多接入问题看起来都是“不能调用模型”，但错误码背后的方向不同。404 重点看地址和模型 ID；401 通常看 API Key 是否有效；403 可能是模型权限或安全策略；429 则多半和额度、频率或并发有关。DeepAI API 中转站的优势之一，是可以把多模型调用统一到一个入口，再通过后台日志和额度设置快速定位问题。
为什么中转站用户更应该关注路径拼接
API 中转站常常同时对接 OpenAI、Claude、Gemini、DeepSeek、Qwen 等模型，也会兼容不同客户端的请求格式。客户端越多，Base URL 约定越容易不一致。Cherry Studio、Dify、n8n、Open WebUI、LobeChat、Claude Code 这些工具都支持自定义端点，但它们对 /v1、/models、/chat/completions、/messages 的拼接规则并不完全相同。
所以，给团队写接入文档时不要只写“填入中转站地址”。更建议明确写成两类：OpenAI-compatible 工具通常填 https://api.deepai.wang/v1；如果工具明确是 Anthropic Messages SDK 或 Claude 兼容端点，则按该工具说明检查是否需要根地址。这样可以避免同一个 Key 在不同客户端里出现一边能用、一边 404 的情况。
建议的日志记录方式
排查 Cherry Studio 或其他 AI Agent 客户端时，建议记录四项信息：客户端版本、Provider 类型、实际请求路径、返回状态码。不要在日志里保存完整 API Key，只保留 Key 的前后少量字符用于区分即可。对于团队或商业站点，把这些信息和 DeepAI API 中转站后台调用日志对照起来，通常能很快定位是客户端配置问题，还是上游模型服务问题。
参考资料
- Cherry Studio GitHub 仓库
- Cherry Studio Issue #14808：/v1/messages 被转发成 /v1/v1/messages
- DeepAI API 中转站教程导航
- OpenAI Compatible API 教程合集
总结
Cherry Studio 接入 DeepAI API 中转站时，普通 OpenAI-compatible 聊天通常使用 https://api.deepai.wang/v1 作为 Base URL；但涉及 Anthropic Messages、Claude Code 或 API Service 时，要确认 SDK 是否会自动追加 /v1/messages。一旦日志里看到 /v1/v1/messages，就不要继续换模型或换 Key，而应先修正 Base URL 的层级。把路径规则讲清楚，能显著减少 AI Agent 接入中的 404、重复配置和团队协作成本。
