Trae API Key 配置教程：4 步接入自定义模型

Trae 接入外部模型的入口在「设置中心 → 模型 → 添加模型 → 自定义配置」，只需填 4 项：API 格式、自定义请求地址、模型 ID、API Key。测试通过就能在对话里切换使用，全程 5 分钟。本文按 Trae 现行版本流程写，并附 DeepSeek、通义千问、Kimi 三家的官方 OpenAI 兼容地址与报错排查。模型接口均来自 DeepSeek 开放平台文档、Moonshot 开放平台 等官方来源，配置前建议再核对一遍官方页。

本文你能拿到什么

• 4 步配置流程，每步的预期结果和常见卡点
• 国内主流模型的请求地址速查表（含本地 Ollama）
• 401、404、429 与模型不显示的排查表
• 与「内测版」「第三方安装包」营销内容无关的官方正规路径

一、什么时候需要配置 API Key

Trae 内置了豆包、DeepSeek、GLM 等常用模型，直接切换就能用，不需要任何配置。需要手动配置 API Key 的场景主要有三类：

• 想用内置列表之外的模型，比如通义千问、Kimi、MiniMax。
• 手里已经有某个平台的 API 额度，想复用，不重复买 Trae 内置额度。
• 接本地模型服务，比如 Ollama 或自建网关。

如果你还不了解 Trae 本身，可以先读 Trae 是什么？字节 AI IDE 最新形态与免费额度解读，确认它适不适合你的开发场景。

二、准备：先去模型服务商拿到 API Key

配置前，先从模型服务商的控制台申请 API Key。下面是三家常选模型的入口：

三个平台的 Key 都只显示一次或需要手动复制，拿到后立刻保存好。申请流程大同小异，想对照 DeepSeek 的具体操作，可以看 DeepSeek V4.1 Flash API Key 配置：3步跑通。

三、4 步配置流程

第 1 步：打开设置中心，进入模型管理

打开 Trae，点击左上角的设置图标（齿轮形状），在左侧菜单找到「模型」或「模型管理」。

预期结果：能看到已内置的模型列表，以及「添加模型」按钮。

常见卡点：部分旧版本把入口放在「Trae AI → 模型管理」下，路径叫法略有差异。如果找不到「添加模型」按钮，先检查版本，升级到最新版再试。

第 2 步：点击添加模型，选择「自定义配置」

点击「添加模型」，在弹出的窗口里选择「自定义配置」，不要选预置服务商。

预期结果：出现可自由编辑的请求地址、模型 ID 等输入框。

常见卡点：选了预置服务商后，地址会被模板锁定，填什么都无效。记住自定义配置才是手动填四项的地方。

第 3 步：填写四项参数

按下面的说明逐项填写：

1. API 格式：选择 OpenAI Chat Completions（接入 DeepSeek、通义、Kimi 等国内模型都用这个）。
2. 自定义请求地址：填服务商的完整 OpenAI 兼容端点，从上一节的表格里复制，不要手改。
3. 模型 ID：填你打算用的模型标识，必须和平台声明完全一致，大小写敏感。
4. API Key：粘贴刚才从服务商控制台复制的密钥。

请求地址是最容易出错的一项：Trae 要求填写完整接口路径，要写到 /v1/chat/completions 这一层。只填域名或只填 /v1，测试时通常会报 404。

第 4 步：测试并保存，切到对话窗口使用

填写完成后点击「测试」或「添加模型」。Trae 会向服务商发一个请求来验证密钥是否有效：

• 测试通过：模型进入列表，去对话窗口顶部的模型下拉框切换到它即可使用。
• 测试失败：弹窗会展示服务商返回的错误日志，按本文第五节的排查表处理。

四、国内主流模型请求地址速查表

除了前三家，下面这些也常被接进 Trae：

统一规律：地址格式都是「域名 + 版本号 + /chat/completions」。接 Ollama 时模型 ID 必须与 ollama list 输出的名称一字不差。

五、常见配置报错排查

更多 Trae 使用中的问题，可以参考 Trae 常见报错怎么解决？6 类高频问题排查。