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

TRAE

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

前提条件

  • 已订阅MaaS Token Plan个人版套餐。具体操作请参见快速开始。

约束限制

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

步骤一:安装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)或/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 配置示例

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

步骤三:使用TRAE

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

    图4 选择模型

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

    图5 对话示例

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

常见报错

表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控制台开通对应预置服务。

相关文档