算力猫
← 返回教程列表

接入软件

Trae

在 Trae(国内版 / 国际版)里添加一个自定义模型,走我们的接入地址。

约 6 分钟适合:用 Trae 写代码的开发者

开始之前

  • 已安装 Trae 并登录(国内版或国际版都可以)
  • 一把 Key,以及从模型广场复制的模型名

步骤 1 · STEP 0x01

打开模型设置并添加模型

设置 → 模型
1
添加模型
2

模型来源

自定义模型
示意图,以软件当前版本界面为准

在 IDE 窗口或 Agent 窗口里进入「设置 → 模型」,点「添加模型」。来源不要选 TRAE 预设的服务商(那些只能填该厂商自己的 Key),选最下面的「自定义模型」。

去创建 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)。