本页的 OpenAI-compatible Provider 使用 Chat Completions：Base URL 为
https://api.hilinkup.com/v1，最终请求为 POST /v1/chat/completions。配置前准备
- 安装当前版本的 Cherry Studio。
- 在 HiLinkup 控制台 创建独立 API Key。
- 完成快速开始，确认 API Key 和模型列表可用。
配置值
第一步：打开模型服务设置
1
进入设置
打开 Cherry Studio，点击左下角或应用菜单中的 设置。
2
打开模型服务
在设置侧栏选择 模型服务 或 模型供应商。不同版本的名称可能略有差异。
3
添加自定义供应商
选择添加供应商。如果列表中没有 HiLinkup，选择 OpenAI-compatible 或复制一个允许自定义 API 地址的 OpenAI 供应商。
第二步：填写连接信息
1
命名供应商
将名称设置为
HiLinkup，方便与官方 OpenAI 或其他服务区分。2
粘贴 API Key
填入为 Cherry Studio 单独创建的 HiLinkup API Key。注意不要复制前后空格。
3
填写 API 地址
填写：不要在末尾添加
/chat/completions。4
测试连接
点击 检查、测试 或类似按钮。
显示连接成功，或者客户端能够拉取模型列表，表示 Base URL 和 API Key 正确。
第三步：同步或添加模型
自动获取
如果当前 Cherry Studio 版本支持获取模型，点击 获取模型 或刷新按钮，从 HiLinkup 同步可用模型。手动添加
如果没有自动获取按钮，或列表为空：- 在终端调用
/v1/models。 - 从
data[].id复制完整模型 ID。 - 在 Cherry Studio 中点击 添加模型。
- 将 ID 同时填入模型 ID；显示名称可以按需设置。
- 保存模型。
第四步：开始第一次对话
1
启用供应商
确认 HiLinkup 供应商已开启，并保存设置。
2
新建助手或话题
返回对话页，新建一个空白会话。
3
选择模型
在模型选择器中选择刚添加的 HiLinkup 模型。
4
发送测试消息
输入：
5
核对结果
确认收到非空回复，并在控制台中看到对应请求或用量记录。
第五步：验证模型能力
普通文本成功后，再按需验证其他能力。Cherry Studio 中的模型能力标签会影响客户端发送的请求格式。模型支持图片但客户端未勾选视觉能力时，图片可能不会发送给模型。
推荐设置
- 为 Cherry Studio 使用独立 API Key。
- 默认开启流式响应，出现兼容问题时再单独关闭验证。
- 将并发设置在合理范围，避免多个助手同时触发
429。 - 对高成本模型启用对话确认或用量提醒。
- 不需要的 MCP 工具保持关闭，只给助手最小权限。
常见问题
连接检查失败
连接检查失败
先用相同 API Key 执行本页的
/v1/models cURL 请求。cURL 也失败时，处理账户、密钥或网络问题；cURL 成功时，检查 Cherry Studio 的 API 地址是否重复包含 /v1。模型列表为空
模型列表为空
手动添加
/v1/models 返回的完整 ID。部分版本不会自动同步自定义供应商的模型。提示模型不存在
提示模型不存在
删除手动输入的显示名称，重新复制
data[].id。检查大小写、空格和前后缀。图片上传后模型看不到
图片上传后模型看不到
确认模型支持视觉，并在模型设置中启用图片或视觉能力。新建会话后再次测试，避免旧会话沿用错误能力配置。
工具或 MCP 调用失败
工具或 MCP 调用失败
先关闭工具验证普通对话，再选择明确支持工具调用的模型。检查工具参数是否为合法 JSON，并降低工具数量。
返回 401
返回 401
重新粘贴 API Key，确认没有把引号一起复制。检查该密钥是否被撤销。
返回 429
返回 429
降低并发和自动重试次数，检查账户余额与额度。等待后重新发送单条消息。
响应一直加载
响应一直加载
暂时关闭流式响应并发送短消息。如果非流式正常，更新 Cherry Studio 后再测试流式；同时检查代理和防火墙。
安全说明
Cherry Studio 会在本机保存 Provider 配置。只在可信设备中使用，并启用操作系统登录保护和磁盘加密。 如果设备丢失、配置被导出或截图中出现密钥，请立即在 HiLinkup 控制台撤销该密钥并创建新密钥。其他聊天客户端
配置 Chatbox、LobeChat、Open WebUI 等客户端。
错误排查
按状态码检查认证、模型、限流和上游错误。