TRAE 添加自定义模型接入免费 API：硅基流动预设 + OpenAI 兼容自定义配置教程

准备

• 已安装 TRAE（trae.cn）
• 模型平台的 API Key（硅基流动、阿里云百炼、火山方舟等）

步骤

1. 01

   打开模型管理面板

   按 TRAE 文档：在 IDE 窗口或 Agent 窗口中，前往 设置 → 模型，点 添加模型 按钮，弹出「添加模型」窗口。

2. 02

   方式一：选预设的服务商（以硅基流动为例）

   服务商列表里有硅基流动这类预设时最省事（SiliconFlow 文档）：

   • 服务商 选「硅基流动」；部分服务商还要选配置方式（按量计费 / Coding Plan 等），用免费额度选按量计费；
   • 模型 从预置列表里选，想用列表外的模型就点 使用其他模型，填准确的模型 ID；
   • API 密钥 粘贴 Key，可点「获取 API 密钥」跳转到平台创建。
3. 03

   方式二：「自定义模型」接入任意兼容平台

   服务商列表里没有的平台，选 自定义模型，填写：

   • API 格式：大多数国内平台选 OpenAI Chat Completions 格式；只提供 Anthropic 接口的选 Anthropic Messages 格式；
   • 自定义请求地址：关闭「完整 URL」开关时填 Base URL（TRAE 会自动拼接路径），打开时填完整地址；
   • 模型 ID、模型展示名称、API 密钥。

   示例（Base URL 取自各平台官方文档）：

   • 阿里云百炼（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1
   • 火山方舟：https://ark.cn-beijing.volces.com/api/v3
   • 硅基流动：https://api.siliconflow.cn/v1
4. 04

   （可选）高级配置：选对模型系列

   TRAE 为部分模型系列优化了 Prompt 和超参。文档的推荐速查表：DeepSeek-4 系列用 OpenAI Chat Completions 格式 + 「DeepSeek-4 系列」；GLM-5、Kimi 系列在个人版可选「默认」（GLM-5 / Kimi 系列选项仅企业版可用）。上下文窗口、工具调用轮数留空则用 TRAE 默认值。

5. 05

   添加并验证

   点 添加模型，TRAE 会调用服务商接口检测 Key：成功则加入模型列表；失败会显示错误信息和服务商返回的日志，按日志排查。之后在对话输入框右下角点当前模型名即可切换到它。

注意事项

• 用的是谁的额度：自定义模型按你填的平台计费，消耗的是你在该平台的免费额度或余额。
• 管理模型：在模型列表里可编辑、删除，或用开关禁用（禁用后不出现在对话框的模型列表里，但配置保留）。
• 企业版：成员能否添加自定义模型，取决于管理员是否在企业版控制台打开了相应开关。
• 百炼新人免费额度只适用于北京地域，地址和 Key 都要选北京。

常见问题

相关优惠

• 新人 · 阿里云百炼新人免费额度每个模型 100 万 Tokens（70+ 模型，总额超 7000 万），90 天有效
• 新人 · 火山引擎火山方舟新用户免费推理额度每个模型 50 万 tokens（以控制台显示为准）
• 额度 · 火山引擎豆包大模型送 50 万 tokens注册送 50 万 tokens

信息来源

• TRAE 文档 · 内置模型 & 自定义模型docs.trae.cn/ide_models
• SiliconFlow · TRAEdocs.siliconflow.cn/cn/usercases/use-siliconcloud-in-trae
• 阿里云百炼 · 获取与配置 API Keyhelp.aliyun.com/zh/model-studio/get-api-key
• 火山方舟 · Base URL 及鉴权docs.volcengine.com/docs/ark/base-url-and-authentication

最后核实日期：2026-10-09 · 政策可能随时调整，请以官方页面为准