Cherry Studio

当前状态：待复验。以下是 Cherry Studio 自定义服务商的准备性指引，界面名称会随语言和版本变化，不构成连通性、模型发现或扩展能力承诺。

前置条件

• 创建可撤销 API Key，仅在本机受保护的凭据位置录入。
• 从模型目录确认模型 ID，不使用客户端缓存或别名推测。
• 确认网络可访问平台，并阅读 Cherry Studio 的自定义服务商说明。

入口与计费方式

项目	本页范围
协议与入口	OpenAI 兼容通用余额：https://tokenfactory.cn/api/v1
鉴权	控制台 API Key
权益	通用余额；不覆盖 Coding Plan

准确配置

1. 打开设置中的“模型服务 / Model Services”或自定义服务商入口，选择 OpenAI 或当前版本所称的 OpenAI 兼容类型。
2. 填写本地名称、上表 API 地址、API Key 与原始模型 ID；主机和路径分开填写时，以当前版本字段提示为准。
3. 保存并显式启用该服务商，避免回退为默认项。

验证

在非生产会话发送不含敏感信息的最小非流式请求，确认会话实际选中该服务商和模型。

故障排查

• 检查服务商是否启用、模型是否已添加。
• 鉴权失败时检查 Key 是否撤销或被引号、空白污染。
• 模型不可用时回到模型目录核对原始 ID；余额、限额和超时按错误处理处理。

安全提示

不要把 Key 放入项目配置、截图或问题描述。出现部分流内容后不应无条件重发，按流式与重试处理。

更新信息

本页保持待复验。未来真实复验后仅在本页补充测试版本、验证日期、适用入口和已知限制。