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

常见报错
| 报错 | 原因 | 解决方法 |
|---|---|---|
| 404 | Base URL 路径不完整。当打开了完整URL的开关时,需要完整路径。 | 补全 /chat/completions(OpenAI)或 /messages(Anthropic) 后缀。 |
| 401 Unauthorized | API Key 错误或不完整。 | 检查 Key 是否完整复制、有无空格。 |
| Connection refused | 地址不可达或端口错误。 | 检查防火墙、内网地址是否可访问。 |
| 模型无法识别 | 模型 ID 拼写错误。 | 核对大小写、多余空格。 |