客户端示例
Cherry Studio
在 Cherry Studio 中添加 OpenAI 兼容服务商，接入 AsterMesh。
Cherry Studio 是跨平台 AI 桌面客户端，支持多模型对话与自定义服务商。推荐用 OpenAI 协议接入 AsterMesh。
1. 添加服务商
- 打开 Cherry Studio → 设置 → 模型服务
- 添加自定义服务商
- 服务商类型选择 OpenAI（或 OpenAI Compatible）
2. 填写参数
| 字段 | 值 |
|---|---|
| 名称 | AsterMesh（任意） |
| API Key | AsterMesh 控制台创建的 Key |
| API 地址 | https://console.astermesh.cn |
| 模型 ID | 控制台复制的完整模型 ID |
API 地址怎么填
Cherry Studio 会自动拼接 /v1/chat/completions。若上游完整地址是 https://console.astermesh.cn/v1/chat/completions，这里一般只填根地址 https://console.astermesh.cn。
只有在上游路径不是标准路由时，才填写完整 URL，并以 # 结尾，禁止客户端再拼接路径。
3. 添加模型并测试
- 在该服务商下手动添加模型 ID（与控制台一致）
- 回到对话界面，选择该模型
- 发送
ping或一句中文测试
4. Anthropic 协议（可选）
若要走 Claude 原生能力，可再添加一个 Anthropic 类型服务商：
| 字段 | 值 |
|---|---|
| API Key | 同一个 AsterMesh API Key |
| API 地址 | https://console.astermesh.cn（按 Cherry 对 Anthropic 服务商的说明填写，勿重复拼路径） |
具体 Anthropic 路径以 Cherry Studio 服务商文档 为准。
常见问题
- 404：多半是 API 地址多写了
/v1或完整 completions 路径，先改回根域名再试。 - 401：检查 Key，确认没有多余空格。
- 模型不可用：确认已在服务商下添加模型，且 ID 与控制台一致。