UniRoute
使用指南

TRAE 自定义 API 接入指南

在 TRAE 国际版中配置 UniRoute 的 Anthropic Messages、自定义模型与手动模型选择。

TRAE 接入 · 按量 API

在 trae.ai 国际版中添加 UniRoute 的 Claude 自定义模型。配置匹配的 API 协议与地址，再在聊天中选中模型。

适合：使用 TRAE 国际版 IDE 或 Agent 窗口的开发者。

开始配置获取 API Key

快速配置

登录后可一键创建 Key 并自动填入 登录

按字段复制并粘贴到客户端设置中。

API Format

text
Anthropic Messages

Custom Request URL

text
https://api.uniroute.app

API Key

text
YOUR_UNIROUTE_API_KEY

Model ID

text
claude-sonnet-5-5

Display Name

text
UniRoute Sonnet

Full URL

text
关闭

配置步骤

1. 添加自定义模型

打开 Settings → Models，点击 Add Model，选择 Custom Model。

2. 设置协议与地址

将 API Format 设为 Anthropic Messages，关闭 Full URL，在 Custom Request URL 填入 https://api.uniroute.app。TRAE 会追加 /v1/messages。

3. 填写模型与密钥

在 Model ID 中填入 claude-sonnet-5-5，在 API Key 中粘贴密钥，Display Name 填 UniRoute Sonnet。保留 Advanced Settings 默认值，包括 Model Series → Default，点击 Add Model。

4. 选中自定义模型

打开聊天输入框右下角的模型菜单，关闭 Auto Mode，选中 UniRoute Sonnet。

Auto Mode 选择内置模型；使用自定义模型时保持关闭。

这几个变量分别做什么

字段用途
API FormatAnthropic Messages 使用 Claude 的 Messages 协议。
Custom Request URL / Full URL关闭 Full URL 时填写根地址，由 TRAE 追加协议路径。
Model ID实际发送给 API 的精确模型标识。
API Key用于 UniRoute 请求认证。
Display Name客户端菜单中的名称，不改变实际请求模型。
Advanced Settings首次文字连接保留模型系列、上下文、工具轮次和采样参数默认值。

选择模型

Claude Sonnet 5.5

claude-sonnet-5-5

日常编程、代码审查与迭代实现。

Claude Opus 5.5

claude-opus-5-5

复杂架构讨论与疑难调试，继续使用 Anthropic Messages。

怎么确认已经切过来了

发送一句测试：请只回复：你好

打开 用量日志，查看模型、请求状态与扣费。测试会产生实际 API 费用。

新建聊天并确认选中 UniRoute Sonnet，查看流式回复，再到用量日志核对模型。

切回原配置 / 恢复备份

在聊天中选回原模型。需要删除接入时，在 Settings → Models 中只删除 UniRoute 自定义模型。

还没安装？

从 trae.ai 下载国际版，安装后打开 Settings → Models。

常见问题

可以直接填写完整 Messages 地址吗？

可以。开启 Full URL，在 Custom Request URL 中填入 https://api.uniroute.app/v1/messages。

可以使用 OpenAI 兼容模型吗？

单独添加一个自定义模型，将 API Format 设为 OpenAI Chat Completions，关闭 Full URL，Custom Request URL 填 https://api.uniroute.app/v1，Model ID 可填 deepseek-v4-flash。

在哪里修改模型显示名称？

在 Settings → Models 中编辑 Display Name；Model ID 仍是发送给 UniRoute 的精确标识。

常见错误

聊天仍使用内置模型

Auto Mode 已开启，或没有选中自定义模型。

关闭 Auto Mode，选中 UniRoute Sonnet。

404 / 接口地址错误

Full URL 与 Custom Request URL 的填写方式不匹配。

Anthropic Messages 关闭 Full URL，地址填 https://api.uniroute.app。

401 / 添加模型失败

供应商验证请求无法通过密钥认证。

粘贴完整有效的 UniRoute Key，并在控制台检查权限与钱包。

菜单中找不到自定义模型

该模型在 Models 中被停用。

打开 Settings → Models 启用模型，再到聊天窗口选择。

参考资料

TRAE 自定义模型设置 · TRAE Auto Mode 说明

相关链接

全部集成 · 管理 API Key · 协议与地址 · 模型价格 · 用量记录