Cherry Studio 接入 AINN API

启动 Cherry Studio，进入“设置”→“模型服务”，找到内置的“New API”服务商。一个 New API 服务商可以承载 OpenAI Chat 等兼容协议，不需要为 Chat Completions 另建一个自定义服务商。

在“API 密钥”中填写 AINN API 令牌，在“API 地址”中填写 AINN API 根地址：

• API 密钥：填写控制台创建的完整令牌，不要带 Bearer 前缀
• API 地址：填写根地址，不要粘贴 /v1/chat/completions 等完整接口路径
• New API 服务商按所选协议处理版本路径，本教程推荐填写根地址；SDK 中的 Base URL 则通常包含 /v1

https://api.ainn.cc

在 New API 服务商设置中点击“获取模型列表”。在模型管理列表中，把需要使用的模型添加到 Cherry Studio 的模型列表；如果自动获取不到，也可以根据模型广场信息手动添加。

• 模型 ID：填写模型广场显示的准确模型标识，这是实际请求使用的值
• 模型名称：填写便于自己识别的显示名称，可与模型 ID 相同
• 模型用途选择“对话”；如果需要选择端点类型或对话协议，选择 OpenAI Chat／Chat Completions
• 只把支持 Chat Completions 的模型用于本教程；Responses、Anthropic Messages 等协议需要另行确认模型与渠道支持

保存配置后，打开 New API 服务商右上角的启用开关，在对话页面选择刚添加的模型，发送一句简短消息，例如“回复 OK”。先验证连通性，再逐步增加请求量。

• 收到回复后，进入 AINN API 使用日志核对模型、时间和消耗
• Cherry Studio 中的模型分组只是客户端显示和管理方式，不会改变 AINN 令牌的分组权限
• 未指定请求级路由时，渠道选择使用令牌的智能路由模式；模型后缀或 provider.sort 可覆盖令牌设置

如果检测或对话失败，先核对下面几项，再查看调用日志中的错误信息。

• 401：重新复制完整 API 令牌，确认没有误加 Bearer 或空格
• 404 或地址不存在：API 地址填写 https://api.ainn.cc，并检查模型选择的协议是否为 Chat Completions
• 出现 /v1/v1：恢复根地址并检查额外的协议地址配置；当前版本通常能识别已有的 /v1
• 模型不可用：从模型广场重新复制 Model ID，并确认模型当前可用和令牌有访问权限
• 模型不出现在选择器：确认模型已经加入列表，且 New API 服务商的启用开关已打开
• 余额不足：前往钱包充值或联系客服申请体验额度
• 获取模型列表失败：可以手动添加模型；如果实际对话也失败，再检查密钥、网络和接口地址