# TRAE TRAE是一款AI原生集成开发环境（AI IDE），深度整合AI大模型与开发流程，实现从代码生成到项目部署的全流程自动化。TRAE支持接入MaaS模型API，从而提供更多可选择的模型。本文主要介绍如何配置MaaS模型API。 #### 前提条件 - **已订阅MaaS Token Plan个人版套餐** 。具体操作请参见[快速开始](https://support.huaweicloud.com/Token-plan-maas/tokenplan-maas-0001.html#ZH-CN_TOPIC_0000002583633128__section1953014219367)。 #### 约束限制 该功能仅支持"西南-贵阳一"区域。 #### 步骤一：安装TRAE 在[TRAE官网](https://www.trae.cn/download)下载并安装对应操作系统的版本。 #### 步骤二：接入MaaS模型API 1. 选择"个人用户"入口登录后，单击左下角用户名，单击"设置"。 图1设置 ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002805018735.png "点击放大") 2. 进入设置页面，在左侧导航栏，选择"模型"，在模型管理页面单击"添加模型"。 3. 在"添加模型"页面，单击"自定义模型"，进入"自定义模型"页面，如下图所示： 图2自定义模型页面 ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002805098849.png "点击放大") 4. 在自定义模型页面，参考下表配置。 表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 | 必填。 从[模型列表](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 | | 模型展示名称 | 选填。 可自定义模型名称。 | token-plan-V4.1-flash | | 高级配置 | 选填。可设置思考模式、采样参数、上下文长度等。 | - | 图3配置示例 ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002776925922.png "点击放大") 5. 单击"添加模型"，连通性测试通过之后，表示模型添加成功。 #### 步骤三：使用TRAE 1. 在TRAE主页面左侧导航栏，选择"新建任务"，进入对话框，在对话框下方的"自定义模型"区域选择[步骤二：接入MaaS模型API]配置的模型，如下图所示： 图4选择模型 ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002776765786.png "点击放大") 2. 在对话框进行对话，体验模型，如下图所示： 图5对话示例 ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002776924050.png "点击放大") 3. （可选）可在选择模型弹窗下方，单击"添加模型"，添加更多模型。 ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002806125327.png "点击放大") #### 常见报错 表2常见报错排查 | 报错 | 原因 | 解决方法 | |:---|:---|:---| | 404 The API does not exist | Base URL路径不完整。 | - 当打开了完整URL的开关时，补全/chat/completions（OpenAI）或/v1/messages（Anthropic） 后缀。 - 当关闭了完整URL的开关时，不要带/chat/completions（OpenAI）或 /v1/messages（Anthropic） 后缀。 | | Invalid authorization header | API Key错误或不完整。 | 检查Key是否完整复制、有无空格。 | | Network error | 地址不可达或端口错误。 | 检查防火墙、内网地址是否可访问。 | | Invalid model | 模型ID拼写错误。 | 核对大小写、多余空格。 | | Invalid request because you do not have access to it. | 模型未在MaaS开通。 | 在MaaS控制台开通对应预置服务。 |