Trae 接入指南
Trae 支持添加自定义 OpenAI 兼容模型服务。配置 PotatoAPI 的接口地址与密钥后，即可通过同一份 PotatoAPI 额度调用聊天和代码助手能力。
配置目标
在 Trae 中添加 PotatoAPI 作为自定义 OpenAI 兼容服务商，并先用一条简短消息完成连通性测试。
配置前准备
先准备好下面这些信息：
| 配置项 | 获取位置 |
|---|---|
| Base URL | 本页固定地址：https://www.potatoai.cc/v1 |
| API Key | 在 PotatoAPI 控制台创建。 |
| Model Name | 从 PotatoAPI 控制台完整复制模型名称。 |
| 额度 | 确认账号或令牌仍有可用额度。 |
完整配置步骤
1. 进入模型配置页面
打开 Trae 设置，进入 AI / Models / Model Provider 或自定义模型配置区域。
2. 添加自定义服务商
服务商类型选择 OpenAI Compatible 或 Custom OpenAI Endpoint。
3. 填写接口地址
默认填写 Base URL。如果 Trae 要求完整对话接口路径，则使用第二个地址。
text
https://www.potatoai.cc/v1text
https://www.potatoai.cc/v1/chat/completions4. 填入 API 密钥
粘贴你在 PotatoAPI 控制台创建的专属 API Key。注意不要复制到前后空格。
5. 填写模型名称
模型名称必须和 PotatoAPI 控制台模型列表完全一致。大小写、连字符、点号和版本后缀都不能有差异。
模型名必须精确匹配
只要模型名有细微差异，Trae 就可能提示模型不存在。
6. 保存并测试
保存配置后，打开聊天面板或代码助手，发送一条简短消息验证是否连通。
填写参数对照表
| 配置项 | 填写内容 |
|---|---|
| API Format | OpenAI Compatible |
| Base URL | https://www.potatoai.cc/v1 |
| API Key | 你的 PotatoAPI 密钥 |
| Model Name | PotatoAPI 控制台展示的模型全名 |
使用建议
如果同时启用 Trae 内置模型与 PotatoAPI 自定义模型，建议给中转模型设置区分度更高的显示名称：
- PotatoAPI GPT-4o
- PotatoAPI Claude 3.5 Sonnet
这样在切换模型时更不容易选错服务商。
常见问题
请求报错 401
- 核对 API Key 是否复制完整。
- 删除密钥前后的多余空格。
- 确认密钥未被禁用，且额度未耗尽。
模型不存在
- 严格复制 PotatoAPI 控制台展示的模型名称。
- 检查当前令牌分组是否开放该模型权限。
- 确认没有把展示名称误填成实际模型名。
接口连接失败
- 确认 Base URL 填写为
https://www.potatoai.cc/v1。 - 不要漏掉
/v1。 - 保存设置后重启 Trae，再重新测试。