玩转 TRAE 模型：从内置切换到自定义接入
TRAE 内置多款主流模型，你可以根据实际任务灵活切换使用。除内置模型外，TRAE 还支持接入自定义模型。
内置模型
TRAE 当前提供以下内置模型：
①Doubao-Seed-2.1-Pro/Doubao-Seed-2.1-Turbo/Doubao-Seed-Code;
②MiniMax-M3/MiniMax-M2.7;
③GLM-5.2/GLM-5.1/GLM-5;
④DeepSeek-V4-Pro/DeepSeek-V4-Flash;
⑤Kimi-K2.7-Code/Kimi-K2.6;
⑥Qwen3.7-Plus/Qwen3.6-Plus;
(以前的是Doubao-Seed-2.0-Code/Doubao-Seed-1.8/Doubao-Seed-Code/MiniMax-M3/MiniMax-M2.7/MiniMax-M2.5/GLM-5.1/GLM-5V-Turbo/GLM-5/DeepSeek-V4-Pro/DeepSeek-V4-Flash/Kimi-K2.6/Kimi-K2.5/Qwen3.6-Plus/Qwen3.5-Plus)
切换模型
在 AI 对话输入框的右下角，点击当前模型名称，打开模型列表，然后选择你想使用的模型。各个模型的能力不同，你可以将鼠标悬浮至模型名称上，然后查看该模型支持的能力。
添加自定义模型
如果内置模型无法满足需求，你可以添加自定义模型。可用的模型来源如下：
模型服务商：从 TRAE 预设的模型服务商和模型列表中选择，按界面提示填写 API 密钥即可添加。
自定义配置：通过配置 API 格式、请求地址、模型 ID 和鉴权信息，接入 TRAE 未预设的模型。
添加 TRAE 预设模型服务商的模型
前往 设置 > 模型，进入模型管理面板。
点击 添加模型 按钮，打开 添加模型 窗口。
选择 模型服务商 选项（该选项通常会默认选中）。
选择模型服务商。
选择模型，支持以下方式：
从列表中选择 TRAE 为该服务商预置的模型（均为默认版本）。
如需使用其他模型或指定版本，点击 使用其他模型，并填写对应的模型 ID。
填写该模型鉴权所需的 API 密钥。
（可选）展开 高级配置 表单，按需设置以下参数：
模型展示名称：设置模型在列表中的展示名称。若不设置，将默认展示模型 ID。
上下文窗口：设置该模型单次请求可接收的最大 Token 数，以及单次响应可生成的最大 Token 数。
工具调用轮次：设置模型在单次任务中可调用工具的最大次数。
点击 添加模型 按钮。
TRAE 将调用服务商的接口来检测 API 密钥是否有效：
若连接成功，该模型将被添加到模型列表。
若连接失败，窗口中将展示错误信息和服务商返回的日志，你可以根据这些信息排查问题。
通过自定义配置添加模型
前往 设置 > 模型，进入模型管理面板。
点击 添加模型 按钮，打开 添加模型 窗口。
选择 自定义配置 选项。
设置模型的 API 格式。
填写自定义请求地址。你可以根据请求地址格式选择以下方式：
方式一：打开 完整 URL 开关，然后填写完整地址。
方式二：关闭 完整 URL 开关，然后填写基础地址。
输入模型 ID。
设置 多模态 开关。该开关默认开启；关闭后，对话输入框左下角将不再显示 添加图片 图标，使用该模型时将无法上传图片作为输入。
填写该模型鉴权所需的 API 密钥。
（可选）展开 高级配置 列表，按需设置以下参数：
模型系列：TRAE 为特定模型系列优化了 Prompt 和超参，未选择时使用默认配置。
模型展示名称：设置模型在列表中的展示名称。若不设置，将默认展示模型 ID。
上下文窗口：设置单次请求可接收的最大 Token 数，以及单次响应可生成的最大 Token 数。
工具调用轮次：设置模型在单次任务中可调用工具的最大次数。
点击 添加模型 按钮。
TRAE 将调用服务商的接口来检测 API 密钥是否有效：
若连接成功，该模型将被添加到模型列表。
若连接失败，窗口中将展示错误信息和服务商返回的日志，你可以根据这些信息排查问题。
管理自定义模型
添加自定义模型后，你可以在模型列表中编辑、删除、启用或禁用该模型。
编辑模型：点击 编辑 图标，然后修改模型的高级配置。
删除模型：点击 删除 图标，然后在弹窗中二次确认。删除后，当前模型将被从列表里移除，不可被继续使用。
启用/禁用模型：启用后，自定义模型会出现在对话框的模型选择列表中；禁用后，模型将保留在模型管理面板，但不会出现在对话框的模型选择列表中。