跳到主要内容

TRAE IDE 配置

本页说明如何在 TRAE IDE 中逐个添加彼源 AI 文本模型，以及如何确认请求确实经过彼源 AI。

TRAE 账号登录和彼源 AI API 令牌是两套凭据：登录 TRAE 后，仍需填写彼源 AI 令牌。

前置条件​

开始前请准备：

项目说明
TRAE IDE已安装、登录并可正常打开 Settings
彼源 AI 令牌sk- 开头，建议在控制台令牌管理中创建 TRAE 专用令牌
模型 ID从模型广场复制；令牌设置了模型限制时，以 GET /v1/models 返回为准
API 格式Claude 系列模型选 Anthropic Messages 格式；其他文本模型选 OpenAI Chat Completions

不要把真实令牌放入截图、项目文件、公开文档或问题反馈中。

推荐配置​

TRAE 的「完整 URL」开关会改变地址含义。下面两种写法二选一，不要混用。

OpenAI Chat Completions​

配置方式完整 URL自定义请求地址实际请求地址
推荐关闭https://api.biyuan.ai/v1https://api.biyuan.ai/v1/chat/completions
备选开启https://api.biyuan.ai/v1/chat/completions直接使用所填地址

Anthropic Messages​

配置方式完整 URL自定义请求地址实际请求地址
推荐关闭https://api.biyuan.aihttps://api.biyuan.ai/v1/messages
备选开启https://api.biyuan.ai/v1/messages直接使用所填地址

:::warning 常见错误

开启「完整 URL」后只填写 https://api.biyuan.ai/v1，TRAE 会直接 POST /v1，不会自动补上聊天路径。彼源 AI 对该路径返回 404（Invalid URL），模型调用不会成功；但 TRAE 侧配置仍可能显示保存成功，应以实际请求结果为准。

:::

添加一个模型​

1. 打开自定义模型设置​

在 TRAE 中进入：

Settings -> Models -> Add Model -> Custom Config

当前版本提供两种自定义 API 格式：

  • OpenAI Chat Completions
  • Anthropic Messages

当前界面没有 OpenAI Responses 自定义格式。

2. 填写地址、模型和令牌​

以 Chat Completions 推荐配置为例：

字段填写内容
API 格式OpenAI Chat Completions
完整 URL关闭
自定义请求地址https://api.biyuan.ai/v1
模型 ID从模型广场复制的完整模型 ID，例如 gpt-5.6-terra
API 密钥彼源 AI 专用令牌（sk- 开头，在控制台令牌管理创建）

3. 选择 Model Series​

高级配置中的 Model Series 会影响 TRAE 发送的参数：

模型族建议起点
GPT-5 系列GPT-5 series
Gemini 3 系列先选 Gemini-3 series；如果对话报错，删除后改用 Default 重新添加
Claude、Grok 或无法确定Default

Model Series 在模型创建后不可编辑。如需更换，应删除该条配置后重新添加。

4. 正确理解「多模态」​

添加自定义模型时，配置面板中的「多模态」开关表示聊天模型可以接收图片等输入。它不表示「一次添加多个模型」，也不会让 TRAE 改为调用图片生成接口。

gpt-image-2 等图片生成模型需要调用 /v1/images/generations，不能通过 TRAE 的自定义聊天模型入口生成图片。

5. 保存并在会话中选择模型​

TRAE 可以同时保存并启用多个自定义模型，但目前需要逐个添加，没有从彼源 AI 一键导入全部模型的入口。

保存后，在聊天窗口：

  1. 关闭 Auto Mode
  2. 打开模型选择器
  3. 选择刚添加的完整模型 ID

Auto Mode 开启时，自定义模型可能不会出现在选择列表中，或者当前请求仍由 TRAE 自动路由。

必须做一次真实验证​

点击 Add Model 只是保存配置，TRAE 不会在保存时发起请求；请按下面步骤发一条消息验证：

  1. 在彼源 AI 控制台确认专用令牌可用，并确认目标模型对该令牌可见
  2. 在 TRAE 中关闭 Auto Mode，明确选择目标模型
  3. 发送最小提示词：只回复 OK
  4. 确认会话中出现模型回复，而不是仅显示任务完成或服务信息
  5. 回到彼源 AI 控制台，打开「使用日志」，能看到刚才这条请求（模型、时间、消耗），说明接入成功
  6. 仅在需要 Agent 时，再单独验证工具调用和文件操作

客户端显示成功但「使用日志」里没有这条请求，不能视为接入成功。

常见问题​

保存成功，但第一次对话失败​

保存动作不验证网络。请检查最终路径、模型 ID、令牌权限，并在彼源 AI 控制台「使用日志」中确认是否收到请求。

开启完整 URL 后没有模型回复​

完整 URL 开启时必须填写完整端点：

https://api.biyuan.ai/v1/chat/completions

仅填写 https://api.biyuan.ai/v1 会请求错误路径。

地址出现重复路径​

如果完整 URL 关闭，就只填写 Base URL，不要再手动附加 /chat/completions 或 /v1/messages。

自定义模型不在聊天选择器中​

先关闭聊天窗口的 Auto Mode，再检查该模型在 Settings -> Models 中是否已启用。

GPT 模型配置能保存，但不能用​

需要区分三类问题：

  • Chat Completions 模型：继续检查 URL、Model Series 和客户端附加参数
  • Responses-only 模型：当前 TRAE 自定义配置没有 Responses 格式，不能通过该入口使用
  • 图片生成模型：TRAE 会把它当聊天模型发送到错误端点，应改用图片 API

Claude Messages 应填写哪个地址​

关闭完整 URL 时填写 https://api.biyuan.ai；开启时填写完整的 https://api.biyuan.ai/v1/messages。

继续阅读​