客户端教程

Cherry Studio 接入星诺 API

星诺 API 提供模型和 API Key，Cherry Studio 是日常对话与模型切换的客户端。按下面步骤配置一次，之后直接在 Cherry Studio 中选择模型使用。

配置前准备

准备好星诺 API 账号、可用余额或套餐额度，以及一个单独为 Cherry Studio 创建的 API Key。

平台提供

提供 API Key、模型名称、用量记录与当前路由。

客户端

负责保存服务商配置、选择模型并发起对话。

配置结果

完成连接测试并启用服务商后，就可以在模型列表中选择星诺 API 的模型。

Cherry Studio 不同版本的按钮位置可能略有变化，但字段名称和配置逻辑一致。

登录控制台，进入“令牌”页面，新建一个供 Cherry Studio 使用的 API Key。不要把完整 Key 发给他人。

在 Cherry Studio 左侧打开“设置”，进入“模型服务”，点击服务商列表下方的“添加”。

服务商名称填写“星诺 API”，提供商类型选择 OpenAI，然后保存。

API Key 填写刚才创建的星诺 API Key。Cherry Studio 会自动拼接 OpenAI 兼容路径，因此 API 地址填写根地址：

https://xingnuoapi.com

点击“管理”尝试获取模型，或手动填写星诺 API 后台当前展示的准确模型名称。只添加准备使用的模型，不要凭宣传名称猜测拼写。

点击 API Key 右侧的检查按钮。检查通过后，打开服务商右上角开关；如果没有启用，模型不会出现在对话页。

返回对话页，选择刚添加的模型，先发送一句简单问题。成功后再导入文件或开始长对话，并在星诺 API 使用日志中核对请求记录。

为什么这里不填 /v1？ Cherry Studio 的 NewAPI/自定义 OpenAI 服务商会自动拼接请求路径。该字段按 Cherry Studio 官方说明填写根地址即可。

先检查配置，不需要反复删除并重建服务商。

确认复制的是“令牌”页面创建的 API Key，不是登录密码；检查 Key 是否完整、有效且没有多余空格。

确认服务商已启用；点击“管理”后还需要把模型加入服务商模型列表。也可以按后台准确模型名手动添加。

核对模型名称、当前可用状态和账户余额。可用模型以星诺 API 后台当前展示为准。

重新选择模型并进行简单测试；随后到使用日志确认请求是否到达。仍失败时记录时间、模型名和错误信息再联系支持。