本页内容
Cherry Studio
在 Cherry Studio 添加 HiAPI 自定义服务商，按模型协议分别填三个端点，通过 HiAPI 使用 Claude、GPT、DeepSeek。
Cherry Studio 可以通过自定义服务商接入 HiAPI。一个服务商能同时配 OpenAI、Anthropic、OpenAI Responses 三个端点，分别对应三种协议，模型支持哪种协议就选哪个端点。下面以 claude-opus-5-5、gpt-6-astra、deepseek-v4.1-flash 为例，本教程已在 Cherry Studio 2.1.7 上验证。
1. 准备 HiAPI API Key
按 获取 API Key 准备好 Key，点密钥行旁的复制图标，复制完整的 HiAPI API Key，下面填到 Cherry Studio 里。
2. 选择协议
| 协议 | Cherry Studio 里的端点 | 适合的模型 |
|---|---|---|
| Anthropic Messages | Anthropic 端点 | Claude 系列 |
| OpenAI Chat Completions | OpenAI 端点 | GPT、DeepSeek 等多数模型 |
| OpenAI Responses | OpenAI Responses 端点 | 需要 Responses 特性的模型 |
本页的示例模型都按上表实测过。换其他模型时先按上表选端点，发一条消息试试；报 400 does not support this endpoint 就换另一个端点。
3. 添加服务商
3.1 入口
依次点 设置 → 模型服务 → 添加提供商。
3.2 三个端点都填同一个地址
| 字段 | 填写 |
|---|---|
| 提供商名称 | HiAPI |
| API 密钥 | 你的 HiAPI API Key |
| 端点设置 → OpenAI | https://api.hiapi.ai |
| 端点设置 → Anthropic | https://api.hiapi.ai |
| 更多设置 → OpenAI Responses | https://api.hiapi.ai |
三个端点都填 https://api.hiapi.ai，不带 /v1，Cherry Studio 会自动补全路径。这一点和其他工具不同。
3.3 核对实际请求路径
| 端点 | 应显示 |
|---|---|
| OpenAI | https://api.hiapi.ai/v1/chat/completions |
| Anthropic | https://api.hiapi.ai/v1/messages |
| OpenAI Responses | https://api.hiapi.ai/v1/responses |
不一致时：出现 /v1/v1/... 的改填 https://api.hiapi.ai；缺少 /v1 的改填 https://api.hiapi.ai/v1。
4. 添加模型并指定协议
添加模型名后，点模型的铅笔图标进入 编辑模型，按模型支持的协议选 对话协议，并设置 最大输出 Token。
| 配置项 | 怎么填 |
|---|---|
| 对话协议 | 按模型支持的协议选：Anthropic / OpenAI / OpenAI Responses |
| 最大输出 Token | 必填，建议 8192（不能超过模型上限）；不填会发送空值，报 400 max_tokens: "" |
| 上下文长度 | 按模型填写 |
| 模型能力 | 需要工具调用时勾选 工具 |
4.1 协议选择示例
以下面三个模型为例，先添加模型名：
claude-opus-5-5
gpt-6-astra
deepseek-v4.1-flash
再点模型的铅笔图标 → 编辑模型，对话协议这样选：
| 模型 | Cherry Studio 里选 |
|---|---|
claude-opus-5-5 | Anthropic |
gpt-6-astra | OpenAI（也可选 OpenAI Responses） |
deepseek-v4.1-flash | OpenAI |
5. 验证
改过设置后新建对话再测，旧会话会缓存参数。
5.1 对话
新建对话，分别用配好的模型发送「你好，用一句话介绍你自己。」，能正常回复就说明接入成功。
5.2 工具调用
按 MCP 接入教程 的 Cherry Studio 篇配置 MCP（内置服务器或市场安装），再在 MCP 允许访问的文件夹里新建 tool-call-test.txt，写一行 hello hiapi 并保存，然后发送「只允许调用一次文件读取工具，读取 tool-call-test.txt 的全部内容并原样返回。不要修改文件，不要读取其他文件，不要根据文件名猜测内容。」，出现工具调用并返回 hello hiapi 即可。
6. 常见问题
下面只列 Cherry Studio 特有的问题，401、404、429 等通用报错见 通用报错。
| 报错 | 原因 | 处理 |
|---|---|---|
400 max_tokens: "" | 没设置最大输出 Token | 填 8192 |
max_completion_tokens 超出 64000 | 默认值超过上限 | 调到 64000 以下 |
400 stream: must be true | 检测模型 按钮发的是非流式请求 | 以实际对话为准，保持流式开启 |
net::ERR_NETWORK_CHANGED | 网络或代理抖动 | 重试或关闭代理 |
400 does not support this endpoint | 对话协议和模型不匹配 | Claude 选 Anthropic；gpt-6-astra 选 OpenAI 或 OpenAI Responses |
自定义端点报空 max_tokens | 用了 Claude Agent 运行模式 | 不要用 Claude Agent 模式对接自定义端点 |