更新时间:2026-10-12 GMT+08:00
分享

TRAE

TRAE是一款AI原生集成开发环境(AI IDE),深度整合AI大模型与开发流程,实现从代码生成到项目部署的全流程自动化。TRAE支持接入MaaS模型API,从而提供更多可选择的模型。本文主要介绍如何配置MaaS模型API。

前提条件

计费说明

在调用MaaS模型服务时,将根据实际使用的Tokens数量进行计费。计费详情请参见MaaS文本生成模型。

约束限制

该功能仅支持“西南-贵阳一”区域。

步骤一:安装TRAE

在TRAE官网下载并安装对应操作系统的版本。

步骤二:接入MaaS模型API

  1. 选择“个人用户”入口登录后,单击左下角用户名,单击“设置”。

    图1 设置

  2. 进入设置页面,在左侧导航栏,选择“模型”,在模型管理页面单击“添加模型”。
  3. 在“添加模型”页面,单击“自定义模型”,进入“自定义模型”页面,如下图所示:

    图2 自定义模型页面

  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

    必填。

    从模型列表中的“模型参数”中获取。

    deepseek-v4.1-flash

    API密钥

    必填。

    可使用已有的API Key,如果没有可获取API Key。

    gA4ocs*****Tc-Kz4AQ

    模型展示名称

    选填。

    可自定义模型名称。

    maas-deepseek-v4.1-flash

    高级配置

    选填。可设置思考模式、采样参数、上下文长度等。

    -

    图3 配置示例

  5. 单击“添加模型”,连通性测试通过之后,表示模型添加成功。

步骤三:使用TRAE

  1. 在TRAE主页面左侧导航栏,选择“新建任务”,进入对话框,在对话框下方的“自定义模型”区域选择步骤二:接入MaaS模型API配置的模型,如下图所示:

    图4 选择模型

  2. 在对话框进行对话,体验模型,如下图所示:

    图5 对话示例

  3. (可选)可在选择模型弹窗下方,单击“添加模型”,添加更多模型。

常见报错

表2 常见报错排查

报错

原因

解决方法

404

Base URL 路径不完整。当打开了完整URL的开关时,需要完整路径。

补全 /chat/completions(OpenAI)或 /messages(Anthropic) 后缀。

401 Unauthorized

API Key 错误或不完整。

检查 Key 是否完整复制、有无空格。

Connection refused

地址不可达或端口错误。

检查防火墙、内网地址是否可访问。

模型无法识别

模型 ID 拼写错误。

核对大小写、多余空格。

相关文档