Trae怎么填写自定义模型API_Key？

在Trae里调用本地或第三方大模型，这件事儿，说难也不难，但一步走错，模型就完全跑不起来。核心问题往往就出在API Key的填写上——漏填、错填、粘贴不全，对话框直接甩你一脸“Unauthorized”或“Invalid API key”的错误，根本没法用。

所以，要让模型真正跑起来，第一步就是确保API Key填对了。

先确认你已拿到有效的API Key

这一步不能跳过。API Key必须来自你选定的模型服务商后台，而且得满足三个条件：

需要特别留意的是，MiniMax、DeepSeek、Kimi、魔芋AI这些平台，生成Key后通常只显示一次。你要是关掉页面，基本就再也找不回来了。所以，复制之后立刻存到密码管理器或加密文本文件里，这是最稳妥的做法。

如果你还没拿到Key，那就去对应平台的控制台操作吧：

• MiniMax：在「套餐详情」页复制
• DeepSeek：在「API Keys」页新建并复制
• Kimi Code：先进入「Kimi Code控制台」，再点「新建 API Key」
• 魔芋AI：注册后在「我的API」页获取

进入Trae模型配置界面

打开Trae桌面端，不管是国际版还是国内版，操作路径都一样：点击左下角齿轮图标 → 选择「模型」→ 点击右上角「添加模型」。

还有一个更快捷的方式：在任意对话窗口底部，点击模型名称右侧的「+」号，弹出菜单里选「添加模型」，也能直接跳转。

填写自定义模型参数

这里有两种方法，看你的具体需求来选。

服务商选「自定义配置」，模型选「自定义模型」。然后，你需要填三个关键信息：

• 模型ID
  ：必须填服务商要求的准确标识，比如kimi-for-coding、deepseek-v4-pro、mimo-v2.5-pro，大小写和连字符都不能错，哪怕一个字母打错，模型都识别不了。

• API密钥
  ：粘贴你刚保存的完整Key，注意不要带前后空格，否则会报错。

• 自定义请求地址
  ：这个要填对，比如Kimi是https://api.kimi.com/coding，阿里云百炼是https://coding.dashscope.aliyuncs.com/v1/chat/completions，MiMo按量付费是https://api.xiaomimimo.com/v1/chat/completions。

如果服务商本身在Trae的列表里，操作会更简单。比如：

• 服务商选「MiniMax CN」，模型选「MiniMax-M3」，开启多模态，API密钥填入，模型ID会自动设为MiniMax-M3，不用手动改。
• 服务商选「OpenAI」，模型ID填deepseek-v4-flash，请求地址填https://api.deepseek.com/chat/completions，再填入API密钥。

验证并启用模型

配置填好之后，接下来就是验证环节了：

1. 点击「添加模型」按钮。
2. Trae会立刻向你填的请求地址发起一次轻量探测，检查Key的有效性和接口的连通性。
3. 如果显示绿色「✅ 添加成功」，说明配置无误，可以放心使用。
4. 如果弹出红色报错，重点排查三件事：API密钥是否复制完整、请求地址是否拼写错误、模型ID是否与服务商文档完全一致。

验证通过后，回到对话窗口，从模型下拉菜单里选择你刚添加的模型名称，就可以开始使用了。