助手
TRAE 智能问答助手
你好,我是 TRAE 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
TRAE IDE 里最热门的 Skill 是哪些?
如何创建自定义智能体?
如何配置 Rules?
文档反馈
产品介绍
产品计费
企业管理
通用设置
用量管理
安全设置
个人设置
API 参考
问题排查
相关协议

模型

你可以为企业配置全局生效的模型设置。

适用客户端

  • TRAE IDE
  • TRAE 插件
  • TRAE CLI
  • TRAE Work 桌面版与网页版

使用限制

在企业版 TRAE IDE、TRAE 插件和 TRAE CLI 中,企业成员可以使用所有已启用的系统内置模型和企业内置模型。

在企业版 TRAE Work 中,成员可用的模型如下:

模式

任务类型

可用模型

Work 云端 TRAE Auto Model、TRAE Auto Model 可调度的系统内置模型(GLM-5-Turbo、GLM-5、MiniMax-M2.7、Kimi-K2.5)。

本地

TRAE Auto Model、TRAE Auto Model 可调度的系统内置模型(GLM-5-Turbo、GLM-5、MiniMax-M2.7、Kimi-K2.5)、企业内置模型、成员自定义模型。

Code 云端 TRAE Auto Model、系统内置模型。

本地

TRAE Auto Model、系统内置模型、企业内置模型、成员自定义模型。

TRAE Auto Model 的说明参考关于 TRAE Auto Model

系统内置模型

系统内置模型列表

TRAE 企业版提供的系统内置模型如下:

  • Doubao-Seed-2.1-Pro
  • Doubao-Seed-2.1-Turbo
  • Doubao-Seed-2.0-Code
  • Doubao-Seed-Code(系统预设的默认模型,可修改)
  • GLM-5.2
  • GLM-5.1
  • GLM-5V-Turbo
  • GLM-5
  • GLM-4.7
  • MiniMax-M3
  • MiniMax-M2.7
  • Qwen3.7-Plus
  • Qwen3-Coder-Next
  • Kimi-K2.7-Code
  • Kimi-K2.6
  • Kimi-K2.5
  • DeepSeek-V4-Pro
  • DeepSeek-V4-Flash
  • DeepSeek-V3.2
  • GLM-5-Turbo(此模型仅由 TRAE Work 的 TRAE Auto Model 在 Work 模式下调用)

启用/禁用系统内置模型

你可以启用/禁用系统内置模型。默认模型无法被禁用。

  1. 登录 TRAE 企业版控制台
  2. 前往 企业配置 > 模型
  3. 系统内置模型 部分,启用/禁用模型。

企业内置模型

添加企业内置模型

添加自定义模型并将其启用后,企业内所有成员均可在 TRAE 企业版客户端内使用该模型。

使用以下步骤,为你的企业添加自定义模型:

  1. 登录 TRAE 企业版控制台
  2. 前往 企业配置 > 模型
  3. 企业内置模型 部分右上角,点击 添加模型 按钮。
  4. 添加模型 窗口中,完成以下操作:
    1. 选择模型提供商。
    2. 若你选择的模型提供商为 自定义,选择具体的模型并填入 URL。

      提示

      URL 需符合 Chat Completions 协议规范,并填写为 API 的基础路径(Base Path)。基础路径指的是接口的统一前缀,不包含具体的功能端点(如 /chat/completions)。

      例如,如果模型完整的请求 URL 是 https://example.com/v1/ai/chat/completion,那么你应填写的 URL 为 https://example.com/v1/ai/

    3. 填入模型的 API Key。
    4. (可选) 在 高级设置 处,按需配置以下字段:

      字段

      描述

      自定义请求地址

      若请求该模型提供商需要经过其他服务,可在此处填入自定义请求地址;若为空,系统将默认使用该模型提供商的官方请求地址。

      提示:自定义请求地址同样需遵循上述对 URL 的要求。

      上下文窗口-输入 限制模型一次请求可以接收的最大 Token 数量。
      上下文窗口-输出 限制模型一次响应可以生成的最大 Token 数量。
      工具调用轮次 设置模型在一次任务中可以调用工具的最大次数。
      支持图片输入 开启后,允许用户在与该模型交互时输入图片。
    5. 点击 保存 按钮。

验证 Anthropic 模型的可用性

Anthropic 的模型不支持通过浏览器直接发起请求来验证可用性,你需要在本地终端使用 curl 来测试 API Key。使用以下脚本:

curl 'https://api.anthropic.com/v1/models' \
-H 'x-api-key: {{你的 apikey}}' \
-H 'anthropic-version: 2023-06-01'

设置默认模型

您可以将任何系统内置或企业内置的模型设置为企业默认模型。一旦设定,该默认模型便无法被禁用或删除。

  1. 登录 TRAE 企业版控制台
  2. 前往 企业配置 > 模型
  3. 默认模型 部分,设置一个企业默认模型。

管理成员的自定义模型权限

为企业成员开启自定义模型权限后,他们可以在 TRAE IDE 内自行添加自定义模型并使用。

使用以下步骤,为你的企业成员开启或关闭自定义模型权限:

  1. 登录 TRAE 企业版控制台
  2. 前往 企业配置 > 模型
  3. 成员自定义模型 部分,打开或关闭 是否允许成员在 TRAE IDE、TRAE 插件、TRAE Work 桌面端添加自定义模型 开关。

在模型调用中传递用户标识

模型调用配置 处,你可以按需打开 模型调用用户标识 开关。

开启后,当企业自定义模型通过 OpenAI 的 chat/completions 协议发起请求时,系统会在请求 Header 中增加 X-Trae-User-Email 字段。该字段的值为当前发起请求用户的企业邮箱,用于帮助模型服务识别调用用户。

模型用量管理

配置用量限额

你可以为 TRAE 内置模型和企业内置模型配置用量限额。当实际用量达到设定的限额时,系统会限制企业或成员继续使用 AI 功能或模型,并向超级管理员和管理员发送邮件通知。限额配置支持动态修改。

TRAE 企业版支持配置以下两类用量限额:

  • 企业整体限额:企业所有成员的累计用量达到限额后,所有成员将无法继续使用 AI 功能。若配置的是模型级限额,达到限额后,所有成员将无法继续使用对应模型。
  • 人均限额:单个成员的累计用量达到限额后,该成员将无法继续使用 AI 功能。若配置的是模型级限额,达到限额后,该成员将无法继续使用对应模型。
  • 成员单独限额(仅超额会话限额):当指定成员的超额会话用量达到限额后,该成员将无法继续使用 AI 功能。

详情参考配置用量限额

查看用量

开通按量付费后,TRAE 会记录企业在套餐所赠送的 Token 额度外所消耗的、需额外付费的 Token 数。

在用量统计看板中,你可以查看模型总消耗 Token 数、模型输入总 Token 数、模型输出总 Token 数。

  1. 登录 火山引擎 TRAE 控制台
  2. 从左侧导航栏中,选择 用量统计
  3. 按需设置筛选条件,包括模型、数据周期和时间维度。
    看板中将显示对应数据。

启用 Max 模式:

在 AI 对话输入框右下角,点击模型名称,然后打开菜单中的 Max Mode 开关。

关于 TRAE Auto Model

TRAE Auto Model 是 TRAE 提供的模型调度能力,会根据当前模式、任务类型和模型启用状态自动选择最合适的模型。

模式

任务类型

可调用模型

无可调用模型的原因与解决方案

Work

云端

仅支持 4 个固定系统内置模型:GLM-5-Turbo、GLM-5、MiniMax-M2.7、Kimi-K2.5。

原因:这 4 个系统内置模型均被禁用。

解决方案:至少启用这四个模型中的一个。

本地

Code

云端

所有系统内置模型。

原因:所有系统内置模型均被禁用。

解决方案:至少启用一个系统内置模型。

本地

所有系统内置模型,以及某个被设置为默认模型的企业内置模型。

-

注意

为确保 TRAE Auto Model 能正常调用模型,建议至少启用以下系统内置模型中的一个:GLM-5-Turbo、GLM-5、MiniMax-M2.7 或 Kimi-K2.5。

如果 TRAE Auto Model 可调用的模型均被禁用,对话过程中系统将提示 “Auto 模式支持模型已全部被禁用,请联系管理员”。出现该提示时,请联系管理员启用至少一个 TRAE Auto Model 可调用的系统内置模型。