客户端
Cherry Studio
将 Toodoo AI 添加为模型服务商。
先在统一配置引导中选择模型和协议，再选择或创建匹配密钥。引导会提供可复制配置和填写说明。
添加服务商
在设置中的模型服务页面添加 OpenAI 兼容服务商，名称填写 Toodoo AI，输入独立 API 密钥。
Cherry Studio 会根据地址规则补全接口路径。通常填写服务根地址 https://toodooai.com 即可；以当前界面的完整请求地址预览为准，确认请求最终指向 https://toodooai.com/v1/chat/completions。Cherry Studio 官方服务商设置
添加模型
获取模型列表，或手动添加控制台提供的完整模型 ID，然后启用服务商。显示名称可以便于阅读，实际模型 ID 必须保持不变。
验证对话
新建对话并选择该模型，发送一句问候。若模型列表获取失败，可先用 最小请求 检查地址和密钥。
图片、联网及工具能力需要分别验证，不由“OpenAI 兼容”自动保证。
推荐配置流程
- 在 Toodoo AI 创建 Cherry Studio 专用 API 密钥。
- 在 Cherry Studio 的模型服务商设置中选择 OpenAI 兼容类型。
- 服务地址优先按界面字段要求填写：需要 Base URL 时填写
https://toodooai.com/v1；如果版本会自动补全/v1，则按官方页面提示填写根地址https://toodooai.com。 - 填入 API 密钥，获取模型列表或手动添加当前分组中的完整模型 ID。
- 保存后新建对话，先发送短文本，再测试目标功能。
不要在同一个服务商中混用 OpenAI 和 Anthropic 的路径。Cherry Studio 当前版本的字段名称、自动补全规则和高级参数可能不同，以官方服务商设置为准。
常见问题
| 现象 | 排查方向 |
|---|---|
| 获取模型失败 | 检查 Base URL 是否多了一层 /v1，再用最小请求验证密钥。 |
| 模型可选但无法发送 | 模型可能不支持当前请求格式或分组额度不足，查看日志和 400/403 信息。 |
| 图片或工具失败 | OpenAI 兼容不代表当前模型开通全部能力，需要按模型能力逐项验证。 |
分享 Cherry Studio 配置前，删除 API 密钥、个人地址和会话信息。