Trae Work

先在统一配置引导中选择模型和协议，再选择或创建匹配密钥。引导会提供可复制配置和填写说明。

添加模型

在模型设置中添加自定义模型。该功能的可用范围受客户端版本、运行环境及组织设置影响；如果没有入口，先核对官方说明。

选择与目标模型匹配的 OpenAI Chat Completions API 格式，启用 完整 URL 后填写：

https://toodooai.com/v1/chat/completions

填入 Toodoo AI 密钥、完整模型 ID 和便于识别的展示名称。完整 URL 开关控制是否由客户端补全路径。Trae Work 官方模型说明

保存并验证

点击添加后检查连接测试结果，在新任务中选择该模型。先用短文本任务确认可用，再逐步尝试文件和工具能力。

参数设置

上下文窗口、图片输入和思考模式必须符合目标模型的真实能力；不确定时保留工具默认设置。遇到 400 错误，检查高级参数是否被模型支持。

配置顺序

1. 先准备平台信息

创建 Trae Work 专用 API 密钥，确认分组和模型权限，并从 GET /v1/models 复制完整模型 ID。

2. 再填写完整 URL

如果启用了“完整 URL”，填写 https://toodooai.com/v1/chat/completions；如果关闭该选项并使用 Base URL，填写 https://toodooai.com/v1。两种模式只能选一种。

3. 最后验证任务

先运行短文本任务，再验证代码、文件和工具能力。每次修改模型或高级参数后重新测试，不要把上一次连接测试当作所有能力都已验证。

常见问题

• 404：完整 URL 开关和地址格式不匹配，常见原因是 /v1 被客户端重复拼接。
• 401：重新复制密钥，确认没有混入引号或空格，并检查密钥仍处于启用状态。
• 400：先关闭图片、思考模式或其他高级选项，再确认模型实际支持范围。
• 请求无日志：检查 Trae Work 使用的不是旧配置，并核对代理和网络连接。

排障时保留客户端版本、发生时间、状态码和脱敏错误，避免提交密钥和完整任务内容。Trae Work 官方模型说明中的入口可能随版本调整。