文档首页
从创建 API 密钥开始，连接模型并在常用工具中稳定使用 Toodoo AI。
欢迎使用 Toodoo AI。Toodoo AI 是一个统一的模型 API 入口：你只需要在平台创建 API 密钥，就可以通过 OpenAI 兼容接口、Anthropic Messages 接口，或常见编程工具调用当前分组中可用的模型。
这份文档按“先成功调用，再接入工具，最后管理用量”的顺序组织。第一次使用时不需要一次读完所有页面，先完成下面的 5 分钟流程即可。
5 分钟发出第一个请求
创建密钥、查询完整模型 ID，并完成一次最小 API 调用。
常见工具接入攻略
用方格入口选择 CLI、桌面客户端或 SDK 的专属配置指南。
平台功能
理解分组、API 密钥、日志和账号安全各自负责什么。
第三方接入
将 Toodoo AI 接入 CC Switch、Claude Code、Codex CLI、OpenCode 或桌面客户端。
错误码与排障
按地址、权限、模型、额度和日志逐层定位问题。
按任务选择入口
下面的卡片会直接跳到不同 Root 下的具体页面，适合已经知道当前目标、希望少走一步的用户。
选择模型与密钥
先选择想用的模型和协议，再选择或创建匹配密钥；引导显示完整模型 ID。
创建与管理 API 密钥
为每个工具设置独立密钥、额度、有效期、模型限制和 IP 白名单。
查看调用与用量
按时间、模型和密钥核对请求是否到达平台，以及状态和消耗。
保护账号与凭据
区分登录账号和 API 密钥，处理通行密钥、共享设备与异常访问。
一键配置多个编程工具
从 API 密钥页导入 CC Switch，或手动管理 Claude、Codex 和其他工具。
配置 Claude Code
使用 Anthropic Messages 兼容入口在终端中运行 Claude Code。
配置桌面客户端
在 Cherry Studio 中添加 Toodoo AI 服务商，开始桌面对话。
接入自己的服务
用 OpenAI SDK 在服务端调用 Chat Completions 兼容接口。
遇到错误先排查
按状态码、地址、权限、模型、额度和日志逐层缩小问题范围。
你将完成的四件事
1. 创建一枚独立密钥
在 API 密钥 页面为当前工具创建密钥。建议按“工具 + 设备”命名，例如 Codex-办公室电脑，这样停用或排查时不会影响其他接入。
2. 确认分组与模型
分组决定密钥能够访问的模型范围及对应计费配置。完整模型 ID 以 GET /v1/models 或控制台当前列表为准，不要把显示名称自行改短。
3. 使用正确的协议地址
OpenAI 兼容工具通常使用 https://toodooai.com/v1；Anthropic SDK、Claude Code 等使用 https://toodooai.com。工具如果会自动拼接路径，请检查最终请求地址，避免重复出现 /v1。
4. 用日志确认调用
配置完成后先发送短消息，再打开日志功能核对时间、模型、状态和用量。只有日志和客户端结果都正常，才建议开始长上下文或批量任务。
地址速查
| 使用场景 | Base URL 或端点 | 说明 |
|---|---|---|
| OpenAI 兼容 SDK / 客户端 | https://toodooai.com/v1 | SDK 会在 Base URL 后补充 /chat/completions 等路径。 |
| Anthropic SDK / Claude Code | https://toodooai.com | 不要手动填写完整的 /v1/messages，除非工具明确要求。 |
| 查询模型 | https://toodooai.com/v1/models | 使用返回结果中的完整 id。 |
| OpenAI Chat Completions | https://toodooai.com/v1/chat/completions | 适合直接使用 HTTP 客户端做最小验证。 |
按你的目标继续
- 只想先验证平台：阅读 5 分钟发出第一个请求。
- 想配置多个编程工具：阅读 CC Switch。
- 想直接在终端使用：选择 Claude Code、Codex CLI 或 OpenCode。
- 想写进自己的服务：选择 OpenAI SDK 或 Anthropic SDK。
- 遇到调用失败：先执行最小请求，再按错误码与排障检查。
模型、价格、限额和具体能力可能随平台配置变化；以控制台当前展示和实际请求结果为准。