接入软件
Trae
在 Trae(国内版 / 国际版)里添加一个自定义模型,走我们的接入地址。
约 6 分钟适合:用 Trae 写代码的开发者
开始之前
- 已安装 Trae 并登录(国内版或国际版都可以)
- 一把 Key,以及从模型广场复制的模型名
步骤 1 · STEP 0x01
打开模型设置并添加模型
设置 → 模型
1
添加模型
2
模型来源
自定义模型
在 IDE 窗口或 Agent 窗口里进入「设置 → 模型」,点「添加模型」。来源不要选 TRAE 预设的服务商(那些只能填该厂商自己的 Key),选最下面的「自定义模型」。
步骤 2 · STEP 0x02
选 API 格式、填地址和 Key
添加模型 → 自定义模型
1
API 格式
OpenAI Chat Completions 格式
2
完整 URL
关
3
自定义请求地址
https://api.suanlimao.shop/v1
4
模型 ID
<模型名>
5
模型展示名称
随便取
6
API 密钥
<你的 Key>
7
添加
- API 格式选「OpenAI Chat Completions 格式」。要用 Claude 系列模型也可以选「Anthropic Messages 格式」,这时地址填不带 /v1 的
https://api.suanlimao.shop。 - 「完整 URL」开关保持关闭,地址填
https://api.suanlimao.shop/v1,TRAE 会按所选格式自己补上 /chat/completions。如果你打开了这个开关,就要填完整路径https://api.suanlimao.shop/v1/chat/completions。 - 模型 ID 填从模型广场复制的名字;展示名称随意。
- 点「添加」时 TRAE 会用这把 Key 真实调用一次来验证,失败会把服务端返回的错误和日志显示出来。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。
步骤 3 · STEP 0x03
按需调整高级配置,然后在对话里选它
自定义模型 → 高级配置
1
模型系列
默认(或与你所选模型最接近的一项)
2
上下文窗口(Token)
按模型广场里该模型的参数
3
图片输入支持
按模型能力
4
对话框里的模型选择
你刚添加的模型
- 高级配置里的上下文窗口、工具调用轮数、图片输入等按模型广场的参数填;不确定就先用默认值。
- 回到对话框,在模型选择里切到这个模型,发一句话测试。
国内版与国际版的预设服务商列表、「模型系列」选项不完全一样(有的只对企业版开放),自定义模型这条路两边都支持。界面措辞以你手里的版本为准。
✓ 怎么确认成功了
- 对话能用你添加的模型回答。
- 控制台「用量」页出现这次请求。
常见问题
添加时报错、显示一段服务端返回的日志?
看日志里的状态码:401 是 Key 不对或没复制全;404 多半是模型 ID 写错,或者「完整 URL」开着却只填了 https://api.suanlimao.shop/v1;402 是余额不足。
选 Anthropic Messages 格式时填什么地址?
「完整 URL」关闭时填不带 /v1 的根地址 https://api.suanlimao.shop;打开时填 https://api.suanlimao.shop/v1/messages。
想用 Responses 接口?
Trae 的自定义模型目前只有 Chat Completions 和 Anthropic Messages 两种格式,没有 Responses;要用 Responses 接口可以看 Codex 或 OpenCode 的教程。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。