TRAE
TRAE是一款AI原生集成开发环境(AI IDE),深度整合AI大模型与开发流程,实现从代码生成到项目部署的全流程自动化。TRAE支持接入MaaS模型API,从而提供更多可选择的模型。本文主要介绍如何配置MaaS模型API。
前提条件
- 已订阅MaaS Token Plan个人版套餐。具体操作请参见快速开始。
约束限制
该功能仅支持“西南-贵阳一”区域。
步骤一:安装TRAE
在TRAE官网下载并安装对应操作系统的版本。
步骤二:接入MaaS模型API
- 选择“个人用户”入口登录后,单击左下角用户名,单击“设置”。 图1 设置
- 进入设置页面,在左侧导航栏,选择,在模型管理页面单击“添加模型”。
- 在“添加模型”页面,单击“自定义模型”,进入“自定义模型”页面,如下图所示: 图2 自定义模型页面
- 在自定义模型页面,参考下表配置。
表1 自定义模型配置 参数
说明
示例
API格式
必填。
- OpenAI Chat Completions 格式
- Anthropic Messages 格式
选择OpenAI Chat Completions 格式
自定义请求地址
必填。
完整URL开关关闭时,URL不带/chat/completions(OpenAI)或/v1/messages(Anthropic)。
- OpenAI Chat Completions格式:https://api.modelarts-maas.com/plan/v2
- Anthropic Messages格式:https://api.modelarts-maas.com/plan/anthropic
https://api.modelarts-maas.com/plan/v2
模型ID
必填。
从模型列表中的“模型参数”中获取。
deepseek-v4.1-flash
API密钥
必填。
可使用已有的API Key,如果没有可获取API Key。
gA4ocs*****Tc-Kz4AQ
模型展示名称
选填。
可自定义模型名称。
token-plan-V4.1-flash
高级配置
选填。可设置思考模式、采样参数、上下文长度等。
-
图3 配置示例
- 单击“添加模型”,连通性测试通过之后,表示模型添加成功。
步骤三:使用TRAE
- 在TRAE主页面左侧导航栏,选择,进入对话框,在对话框下方的“自定义模型”区域选择步骤二:接入MaaS模型API配置的模型,如下图所示: 图4 选择模型
- 在对话框进行对话,体验模型,如下图所示: 图5 对话示例
- (可选)可在选择模型弹窗下方,单击“添加模型”,添加更多模型。

常见报错
| 报错 | 原因 | 解决方法 |
|---|---|---|
| 404 The API does not exist | Base URL路径不完整。 |
|
| Invalid authorization header | API Key错误或不完整。 | 检查Key是否完整复制、有无空格。 |
| Network error | 地址不可达或端口错误。 | 检查防火墙、内网地址是否可访问。 |
| Invalid model | 模型ID拼写错误。 | 核对大小写、多余空格。 |
| Invalid request because you do not have access to it. | 模型未在MaaS开通。 | 在MaaS控制台开通对应预置服务。 |