# TRAE TRAE是一款AI原生集成开发环境（AI IDE），深度整合AI大模型与开发流程，实现从代码生成到项目部署的全流程自动化。TRAE支持接入MaaS模型API，从而提供更多可选择的模型。本文主要介绍如何配置MaaS模型API。 #### 前提条件 - 已注册华为云账号，并进行实名认证。具体操作，请参见[注册华为账号并开通华为云](https://support.huaweicloud.com/usermanual-account/account_id_001.html)和[实名认证](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0071343161.html)。 - 已开通预置服务，或已创建接入点。具体操作，请参见[开通预置服务](https://support.huaweicloud.com/model-call-maas/model-call-052.html#section4)或[创建自定义接入点](https://support.huaweicloud.com/model-call-maas/model-call-048.html#section3)。 #### 计费说明 在调用MaaS模型服务时，将根据实际使用的Tokens数量进行计费。计费详情请参见[MaaS文本生成模型](https://support.huaweicloud.com/price-maas/price-maas-0002.html)。 #### 约束限制 该功能仅支持"西南-贵阳一"区域。 #### 步骤一：安装TRAE 在[TRAE官网](https://www.trae.cn/download)下载并安装对应操作系统的版本。 #### 步骤二：接入MaaS模型API 1. 选择"个人用户"入口登录后，单击左下角用户名，单击"设置"。 图1设置 ![](https://support.huaweicloud.com/access-tools-maas/figure/zh-cn_image_0000002757623806.png "点击放大") 2. 进入设置页面，在左侧导航栏，选择"模型"，在模型管理页面单击"添加模型"。 3. 在"添加模型"页面，单击"自定义模型"，进入"自定义模型"页面，如下图所示： 图2自定义模型页面 ![](https://support.huaweicloud.com/access-tools-maas/figure/zh-cn_image_0000002757785754.png "点击放大") 4. 在自定义模型页面，参考下表配置。 表1自定义模型配置 | 参数 | 说明 | 示例 | |:---|:---|:---| | API格式 | 必填。 - OpenAI Chat Completions 格式 - Anthropic Messages 格式 | 选择OpenAI Chat Completions 格式 | | 自定义请求地址 | 必填。 **完整URL开关关闭时，URL不带/chat/completions（OpenAI）或 /messages（Anthropic）。** - OpenAI Chat Completions 格式。完整路径如下： - https://api.modelarts-maas.com/v2/chat/completions - https://api.modelarts-maas.com/openai/v1/chat/completions - Anthropic Messages 格式。完整路径如下： https://api.modelarts-maas.com/anthropic/v1/messages | https://api.modelarts-maas.com/v2 | | 模型ID | 必填。 从[模型列表](https://support.huaweicloud.com/model-list-maas/model_list_0001.html)中的"模型参数"中获取。 | deepseek-v4.1-flash | | API密钥 | 必填。 可使用已有的API Key，如果没有可[获取API Key](https://console.huaweicloud.com/modelarts/#/model-studio/authmanage)。 | gA4ocs\*\*\*\*\*Tc-Kz4AQ | | 模型展示名称 | 选填。 可自定义模型名称。 | maas-deepseek-v4.1-flash | | 高级配置 | 选填。可设置思考模式、采样参数、上下文长度等。 | - | 图3配置示例 ![](https://support.huaweicloud.com/access-tools-maas/figure/zh-cn_image_0000002757656246.png "点击放大") 5. 单击"添加模型"，连通性测试通过之后，表示模型添加成功。 #### 步骤三：使用TRAE 1. 在TRAE主页面左侧导航栏，选择"新建任务"，进入对话框，在对话框下方的"自定义模型"区域选择[步骤二：接入MaaS模型API]配置的模型，如下图所示： 图4选择模型 ![](https://support.huaweicloud.com/access-tools-maas/figure/zh-cn_image_0000002787227173.png "点击放大") 2. 在对话框进行对话，体验模型，如下图所示： 图5对话示例 ![](https://support.huaweicloud.com/access-tools-maas/figure/zh-cn_image_0000002757656904.png "点击放大") 3. （可选）可在选择模型弹窗下方，单击"添加模型"，添加更多模型。 ![](https://support.huaweicloud.com/access-tools-maas/figure/zh-cn_image_0000002787228881.png "点击放大") #### 常见报错 表2常见报错排查 | 报错 | 原因 | 解决方法 | |:---|:---|:---| | 404 | Base URL 路径不完整。当打开了完整URL的开关时，需要完整路径。 | 补全 /chat/completions（OpenAI）或 /messages（Anthropic） 后缀。 | | 401 Unauthorized | API Key 错误或不完整。 | 检查 Key 是否完整复制、有无空格。 | | Connection refused | 地址不可达或端口错误。 | 检查防火墙、内网地址是否可访问。 | | 模型无法识别 | 模型 ID 拼写错误。 | 核对大小写、多余空格。 |