跳到正文
FUMODocs

TRAE

TRAE 可以通过自定义模型连接 Fusion 的 Chat Completions 或 Responses API,无需 CC Switch。两种协议均支持 Fusion Max 2.0 的五档思考强度,推荐使用 high。本文面向 TRAE 国内版桌面客户端;国际版、企业版和旧版的界面及可用选项可能不同。

接入参数

获取 API Key →

使用 FUMO Dashboard 的 Key,适用于线上注册与充值的账号。

参数值
Base URLhttps://capi.fumolab.ai/api/fusion/v1
Chat Completions(完整 URL)https://capi.fumolab.ai/api/fusion/v1/chat/completions
Responses(完整 URL)https://capi.fumolab.ai/api/fusion/v1/responses
可用模型 IDfusion-max-2.0、fusion-code-1.0
API 格式OpenAI Chat Completions / Responses
推荐模型fusion-max-2.0
输入窗口 / 输出上限373000 / 131072 tokens
Max 2.0 思考强度支持 low、medium、high、xhigh、max,推荐 high

配置步骤

1. 安装最新版并准备账号

从 TRAE 官方下载页↗安装最新版桌面客户端,并完成 TRAE 账号登录。首次启动时即使跳过登录,也需要登录后才能使用 AI 功能。

按照快速开始创建 FUMO API Key;企业客户请见企业接入指南。FUMO API Key 用于模型接口鉴权,不能代替 TRAE 账号登录。

2. 添加自定义模型

  1. 在 IDE 或 Agent 窗口的账号菜单中打开 设置 → 模型,点击 添加模型。也可以直接从对话的模型菜单进入 添加模型。
  2. 选择 自定义模型。
  3. API 格式按接入方式选择 OpenAI Chat Completions 或 OpenAI Responses API。
  4. 打开 完整 URL 开关,自定义请求地址填写所选协议的完整地址。使用 Chat Completions 时填写:
text
https://capi.fumolab.ai/api/fusion/v1/chat/completions
  1. 模型 ID填写:
text
fusion-max-2.0
  1. 模型展示名称可填写 FUMO · Fusion Max 2.0,API 密钥填写当前接入方式对应的 FUMO Key。

推荐使用完整 URL,避免客户端重复追加路径。如果关闭 完整 URL 开关,则只填写 https://capi.fumolab.ai/api/fusion/v1,由 TRAE 根据所选 API 格式拼接路径。

使用 Responses 时,请新建一条自定义模型配置:

  1. 将 API 格式选择为 OpenAI Responses API。
  2. 打开 完整 URL,填写以下完整请求地址:
text
https://capi.fumolab.ai/api/fusion/v1/responses
  1. 模型 ID 和 API Key 使用相同接入方式下的 Fusion 配置,继续完成下方的上下文、图片输入和保存步骤。

已保存模型的 API 格式和请求地址在编辑时不可修改,切换协议请新建配置。不要保留 OpenAI Chat Completions 格式而只将 URL 改为 /responses。如果关闭 完整 URL,两种格式都只填写 https://capi.fumolab.ai/api/fusion/v1,由 TRAE 按所选格式追加路径。FUMO 不支持 Anthropic Messages,请勿选择该格式或填写 /messages 地址。

3. 设置高级配置

以下上下文、模型能力和思考强度配置用于 Fusion Max 2.0。先选择 API 格式,再配置思考强度,地址和协议需要保持一致。

配置项推荐值
模型系列默认
上下文窗口:输入373000
上下文窗口:输出131072
支持图片输入开启
思考模式:思考强度参数名保留客户端默认配置(Chat Completions:reasoning_effort)
思考模式:思考强度可选值low、medium、high、xhigh、max
工具调用轮数保持客户端默认
Temperature / Top P / Top K留空,使用服务默认值

FUMO 的两种协议都支持 high。在 API 请求中,Chat Completions 使用顶层的 reasoning_effort,Responses 使用嵌套的 reasoning.effort;这是两种请求格式的字段差异,不代表 Responses 只能使用默认强度。客户端配置应与所选 API 格式配套,接口字段详见 Responses API。

Fusion 是独立的模型服务,模型系列选择 默认即可,不需要套用 GPT、Claude 或其他模型系列的预设。373000 是推荐的客户端输入窗口,不代表模型的最大上下文;实际输出也可能短于所设的单次输出上限。

在 思考强度可选值 中逐个输入五档值,每输入一个值后按回车,确认它变为独立标签。这里只声明可用档位,保存后还需要在对话中选择 high。界面自带的 默认无需手动添加;选择 默认时,FUMO 使用服务端默认值 medium。Fusion Max 2.0 不支持关闭思考,请勿选择 关闭。

4. 保存并选择模型

  1. 点击 添加模型。TRAE 会调用接口检测连接;如失败,先按返回的状态码和错误信息排查。
  2. 在模型管理页确认该自定义模型已启用。
  3. 回到对话,在输入框的模型菜单中找到 自定义模型,选择刚添加的 Fusion 模型。确认当前显示的是 Fusion 模型名称。Auto Mode 只使用 TRAE 内置模型。
  4. 再打开模型菜单,将鼠标悬停在 Fusion 模型上,在弹出的模型信息面板中将 思考强度设为 高(high)。两种协议均推荐该档位,声明五档可选值不会自动选中 high。
  5. 先验证普通对话,例如“只回复 17 × 23 的结果”;再在测试项目中验证文件读取和工具调用。

模型添加成功与完整 Agent 工作流通过是两项检查。使用本地测试项目开始验证,再逐步尝试更复杂的任务。

5. 可选:添加 Fusion Code 1.0

重复添加流程,使用相同接口地址,将模型 ID 改为:

text
fusion-code-1.0

确认当前 Key 已授权该模型。Code 1.0 不支持调整思考强度,无需配置思考强度参数名或可选值;其余接口参数和输入 / 输出配置相同。

常见问题

找不到模型设置或无法发送消息

先确认已登录 TRAE 账号,并更新到最新版桌面客户端。本文使用国内版的自定义模型配置流程;企业版如受管理员策略限制,请联系企业管理员。

添加模型返回 404

核对所选 API 格式、完整 URL 开关与地址:开启时填写对应的完整地址 https://capi.fumolab.ai/api/fusion/v1/chat/completions 或 https://capi.fumolab.ai/api/fusion/v1/responses;关闭时只填写 https://capi.fumolab.ai/api/fusion/v1,由客户端追加路径。路径不要重复追加或与协议混用。

返回 401 或 403

检查 Key 是否完整、接入方式是否匹配、模型 ID 是否已授权。详见首次调用排障。

配置了 Fusion,但仍在使用内置模型

在当前对话的模型菜单中选择 Fusion 模型,退出 Auto Mode。还要确认模型管理页中该配置已启用。

看不到 high 等思考强度选项

先核对该配置的 API 格式与接口地址是否匹配。编辑自定义模型,保留所选格式的思考强度参数配置,并逐个输入五档英文值,每个值都按回车确认添加,然后保存。回到模型菜单,悬停在 Fusion 模型上查看思考强度。选项的显示名称可能经过翻译,填写配置时请使用原始英文值,推荐选择 高(high)。

相关资源