Cherry Studio · 客户端
Cherry Studio 接入 Tikway：自定义 API、模型 ID 与连接排查
更新日期：
桌面客户端适合快速检查模型回答，但连接测试不等于所有功能可用。本文介绍通过 OpenAI 兼容 Chat Completions 配置 Tikway 的方法；菜单名称随 Cherry Studio 版本变化，以当前版本设置页为准。
1. 准备 Key 和模型
从控制台获取 Tikway API Key，在模型目录选择支持 OpenAI 协议、Chat Completions 端点的文本模型，并复制完整 ID。先做文本测试，之后再增加图片、工具或其他参数。
2. 添加自定义服务商
在客户端设置的模型服务或服务商区域，添加支持自定义地址的 OpenAI 兼容服务商，名称可填 Tikway。不要选只能使用官方登录的服务商类型。
| 设置项 | 填写方向 |
|---|---|
| 服务商类型 | 支持自定义地址的 OpenAI 兼容类型 |
| API Key | 你自己的 Tikway API Key |
| 基础地址 | 以 https://api.tikway.ai/v1 为起点，按当前客户端的拼接规则核对 |
| 模型 ID | 原样复制 Tikway 目录中的完整 ID |
| 最终文本请求路径 | https://api.tikway.ai/v1/chat/completions |
不同客户端版本可能自动增加 /v1 或提供“完整地址”模式。判断标准是最终路径，避免 /v1/v1/chat/completions 和重复 /chat/completions。若能够查看网络请求，只记录去掉认证信息后的 URL、状态与错误字段。
如果客户端支持获取模型列表，可以先尝试，再核对目录；无法获取列表不等于文本接口不可用，可在允许手动添加模型的版本中输入正确 ID。
3. 完成一条最小请求
启用刚添加的服务商和模型，开始新对话，发送“只回复 OK”。确认返回为模型内容，再去 Tikway 调用记录核对时间、模型和费用。连接测试和普通对话可能采用不同请求，二者都需要检查。
语音、图片和工具调用应选择支持相应能力的模型另行验证。本文没有提供所有版本或所有插件的兼容性保证。
4. 常见失败的检查顺序
401： 检查是否粘贴了错误平台的 Key、空白或旧凭据；参考鉴权排查。
404 或模型不存在： 先核对最终路径，再核对模型 ID 与协议，不能只改显示名称。
浏览器官网能打开但桌面请求超时： 检查桌面进程的网络与代理配置。官网域名和 API 域名不同，能访问首页不证明 API 连接成功。
流式一直等待或中途停止： 查看是否收到终止事件，参考流式中断排查。
5. 费用与使用记录
对话历史可能每轮重新计入输入，实际 Token 用量要看响应 usage 和调用记录。用费用计算器做普通文本预算；图片、缓存和其他收费项需要单独核对。