Trae 接入 汇飞智能 教程

Trae 是字节跳动推出的 AI 集成开发环境(AI IDE),提供代码补全、多文件编辑、Agent 自主编程等能力。通过接入 汇飞智能,你可以把 Trae 底层的模型替换为 汇飞智能 提供的高性能模型服务。


一、接入前准备(核心 3 要素)

开始前,请先登录 汇飞智能控制台,准备好以下 3 个参数:

配置项填写内容去哪里获取
API Keysk-xxxxxxxxxxxxxxxx登录控制台,在左侧「常规」分组下打开 API 密钥 页创建。纯文本即可,不要带 Bearer 前缀。
Base URLhttps://api.sapis.cn/v1固定地址,无需修改,必须带 /v1。
模型名称例如 deepseek-v4.1-flash打开 模型广场,选好模型后点「复制模型名称」,须与平台展示一字不差。

二、打开模型选项

打开 Trae,点击输入框右下角的模型选择器(默认显示 Auto Mode),在弹出列表的底部点击 添加模型。

打开 Trae 选择添加模型


三、进入「模型」设置页

进入 设置 → 模型 页。此处还没有自定义模型,点击 + 添加模型。

设置 → 模型页


四、选择「自定义模型」服务商

在弹出的服务商列表中,选择 自定义模型。

选择自定义模型服务商


五、填写 汇飞智能 配置

在「自定义模型」表单中按下表填写:

字段填写内容说明
API 格式OpenAI Chat Completions 格式汇飞智能是标准 OpenAI 兼容协议。
自定义请求地址https://api.sapis.cn/v1填完整地址、不要以斜杠结尾;Trae 会自动在末尾补 /chat/completions。
模型 ID如 deepseek-v4.1-flash在汇飞 「模型广场」 复制模型名填入,须一字不差。
模型展示名称同模型名在模型列表中展示的名字;留空则默认使用模型 ID。
API 密钥sk-...在汇飞后台 「API 密钥」页创建 的 Key。

填好后点击 添加模型 保存(高级配置 保持默认即可)。

填写汇飞智能配置


六、选用自定义模型

返回对话页面,点击模型选择器,向下滑动到底部,在「自定义模型」分组下选中刚配置的汇飞模型。

滑动到底部选择自定义模型


七、测试是否配置成功

随意发送一条消息,只要 Trae 能正常回复,就说明接入成功。

发送消息有回复即表示配置成功


八、常见问题(FAQ)

Q1:保存后无法调用?

  • 检查自定义请求地址是否为 https://api.sapis.cn/v1(完整、不带结尾斜杠)。

Q2:报错模型不存在 / 回复异常?

  • 模型 ID 必须与汇飞「模型广场」里的一字不差,复制粘贴填入,不要手动改写。

Q3:模型选择器里找不到刚配置的模型?

  • 要向下滑动到底部,「自定义模型」分组在列表最末尾。
不会配置?联系我们首次免费远程协助配置