Cherry Studio 如何接入 DeepAI API 中转站：Base URL、API Key 与模型配置教程

如果你正在用 Cherry Studio，但不想在每个模型平台之间反复切换 API Key、Base URL 和模型名称，那么把它接入 DeepAI API 中转站会更省事。DeepAI 当前 API 地址是 https://api.deepai.wang/，底层是 New API，提供 OpenAI 兼容接口，适合 Cherry Studio、LobeChat、Open WebUI、Dify 等客户端统一调用。

一、为什么用 DeepAI 接入 Cherry Studio？

Cherry Studio 是一个本地 AI 客户端，优势是界面清爽、支持多服务商、多模型和本地化使用。但很多新手卡在同一个地方：API Key 填哪里？Base URL 填哪里？模型名称要不要手动添加？为什么 401、404、429 一直报错？

DeepAI API 中转站的价值，是把多个模型入口统一成一个 OpenAI Compatible API 地址。你只需要在 Cherry Studio 里配置一次服务商，就可以围绕同一个 API 地址管理不同模型，减少重复配置和排错成本。

统一入口：Cherry Studio 只需要配置 DeepAI 的 API Key 和 API 地址。
兼容 OpenAI 格式：适合使用 OpenAI 类型的自定义服务商接入。
多线路信息：DeepAI 当前主线路是 https://api.deepai.wang/，另有欧洲线路 https://eu.deepai.wang/。
适合多客户端：DeepAI 后台状态中已经提供 Cherry Studio、Lobe Chat、OpenCat、DeepChat 等客户端入口信息。
便于看消耗：DeepAI 支持使用日志，遇到余额消耗异常时可以核对具体 token 消耗。

二、准备工作：你需要先拿到 DeepAI API Key

开始配置前，请先打开 DeepAI API 中转站：

DeepAI 地址：https://api.deepai.wang/

注册或登录 DeepAI。
进入控制台，找到令牌 / Token / API Key 管理页面。
创建一个新的 API Key。
复制 API Key，后面要填到 Cherry Studio。
确认账户有可用额度，否则请求可能会失败。

建议专门为 Cherry Studio 创建一个独立 Key。这样以后在 DeepAI 后台查看日志时，可以清楚地区分 Cherry Studio 的调用量、模型消耗和报错情况。

三、Cherry Studio 手动接入 DeepAI：推荐配置

Cherry Studio 官方文档中，自定义服务商的基本流程是：打开设置，进入模型服务，添加自定义服务商，选择 OpenAI 类型，然后填写 API Key、API 地址，并手动添加模型 ID。

1. 打开 Cherry Studio 设置

打开 Cherry Studio，点击左下角或侧边栏的设置图标，进入 模型服务 页面。

2. 添加自定义服务商

在模型服务列表中点击添加服务商。服务商名称可以填写：

DeepAI

服务商类型选择：

OpenAI

这是关键，因为 DeepAI 提供的是 OpenAI 兼容接口，Cherry Studio 需要按 OpenAI 类型去请求。

3. 填写 API Key

把你在 DeepAI 控制台创建的 API Key 粘贴到 Cherry Studio 的 API Key 输入框中。复制时注意不要带空格、换行或中文符号。

4. 填写 API 地址 / Base URL

推荐填写：

https://api.deepai.wang/v1

如果 Cherry Studio 当前版本要求填写服务根地址，也可以尝试：

https://api.deepai.wang/

判断标准很简单：如果填 /v1 后可以正常验证和对话，就保持 https://api.deepai.wang/v1；如果客户端自动拼接了 /v1 导致路径重复，再改成根地址。

5. 添加模型 ID

Cherry Studio 通常需要你在模型管理里手动添加模型名称。模型 ID 必须和 DeepAI 后台支持的模型名称一致。常见写法可能类似：

gpt-4o-mini
gpt-4o
deepseek-chat
claude-3-5-sonnet

具体以 DeepAI 控制台展示的模型列表为准。不要凭感觉乱填模型名，否则很容易出现 model not found 或“模型不存在”。

6. 打开服务商开关并测试

保存后，打开 DeepAI 服务商开关。回到聊天界面，选择刚刚添加的 DeepAI 服务商和模型，发送一句简单测试：

你好，请用一句话介绍你自己。

如果可以正常返回，说明 Cherry Studio 已经成功接入 DeepAI API 中转站。

四、DeepAI 的 Cherry Studio 快捷配置入口

DeepAI 当前站点状态中已经包含 Cherry Studio 快捷配置协议，说明它对 Cherry Studio 这类客户端做了适配。登录 DeepAI 后，如果你在控制台看到 Cherry Studio 相关的一键配置入口，可以优先使用一键导入；如果导入失败，再按上面的手动方式配置。

我的建议是：新手优先用一键配置，开发者和需要排错的人用手动配置。手动配置虽然慢一点，但你会更清楚 API Key、Base URL、模型 ID 分别是什么，后面遇到问题也更容易定位。

五、常见报错和解决方法

1. 401 Unauthorized / Invalid token

这通常是 API Key 问题。检查：

API Key 是否复制完整。
Key 前后是否有空格。
Key 是否已经被删除或禁用。
Cherry Studio 是否填错到了别的服务商里。

2. 404 Not Found

大概率是 Base URL 路径错误。优先尝试：

https://api.deepai.wang/v1

如果客户端自动拼接路径，再尝试：

https://api.deepai.wang/

不要把完整接口路径填进去，比如不要手动填成 /v1/chat/completions，否则客户端再次拼接时可能出错。

3. model not found / 模型不存在

这说明 Cherry Studio 里添加的模型 ID 和 DeepAI 后台支持的模型名不一致。解决方法是回到 DeepAI 后台查看模型名称，复制准确的模型 ID，再回到 Cherry Studio 模型管理里修改。

4. 429 Too Many Requests

429 通常和限流、并发或额度策略有关。你可以：

降低 Cherry Studio 的并发请求。
换一个低压力模型测试。
等待一段时间后重试。
到 DeepAI 使用日志里看是否触发了限制。

5. 余额消耗过快

DeepAI 公告里特别提醒过：部分高阶模型单次调用 tokens 消耗较高，例如 gpt-5.5 这类模型可能比普通模型消耗更快。遇到余额下降快，不一定是单价问题，也可能是上下文太长、输出太长或模型本身 token 消耗大。

建议先用中低成本模型做日常聊天和轻量任务，把高阶模型留给代码、复杂推理和重要内容生成。

六、推荐配置表

配置项	推荐填写
服务商名称	DeepAI
服务商类型	OpenAI
API Key	DeepAI 控制台创建的 Key
Base URL	`https://api.deepai.wang/v1`
备用 Base URL	`https://api.deepai.wang/`
模型 ID	以 DeepAI 后台模型列表为准
测试方式	发送一句短问题，确认是否正常回复

七、总结

Cherry Studio 接入 DeepAI 的核心只有三件事：选 OpenAI 类型、填 DeepAI API Key、把 Base URL 配成 https://api.deepai.wang/v1。如果你再把模型 ID 配准确，基本就能稳定使用。

对于经常切换模型的人来说，DeepAI API 中转站最大的价值不是“多一个地址”，而是把多个模型和多个客户端统一管理。后续无论你使用 Cherry Studio、LobeChat、Dify 还是 Open WebUI，都可以围绕同一个 API 网关来配置、统计和排错。