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。

如果服务商在列表里，直接选更方便。比如服务商选「MiniMax CN」→ 模型选「MiniMax-M3」→ 开启多模态 → API密钥填入 → 模型ID自动设为MiniMax-M3，不用手动改。或者服务商选「OpenAI」→ 模型ID填deepseek-v4-flash → 请求地址填https://api.deepseek.com/chat/completions → API密钥填入。

验证并启用模型

填完参数后，点击「添加模型」按钮。Trae会立即向你填的请求地址发起一次轻量探测，检查Key有效性与接口连通性。如果显示绿色「✅ 添加成功」，说明配置无误，可以松一口气。如果弹出红色报错，别慌，重点核对三件事：API密钥是否复制完整（有没有多出空格或漏掉字符）、请求地址是否拼写错误（多一个字母少一个斜杠都不行）、模型ID是否与服务商文档完全一致（大小写敏感）。

验证通过后，回到对话窗口，从模型下拉菜单中选择你刚添加的模型名称，就可以开始愉快地调用了。整个过程熟练的话两分钟就能搞定，但第一次配置时建议逐项核对，毕竟一步错就全白费。