Trae 接入 NoneLinear

Trae 国际版支持添加自定义 OpenAI Chat Completions 兼容模型。将模型配置为自定义服务,并填写 NoneLinear 的 API 地址、API Key 和模型 ID 后,即可在 Trae 中调用 NoneLinear 模型进行代码问答、Agent 辅助开发和多模态任务。

前置要求

配置步骤

1. 进入模型设置

打开 Trae 后,点击右上角的 设置 图标,进入设置页面。 在左侧菜单中选择 模型,然后在模型管理区域点击 添加模型。 Trae 进入模型设置并添加模型

2. 选择自定义配置

在 添加模型 弹窗中,切换到 自定义配置。 然后填写以下信息: 填写完成后点击 添加模型。 Trae 配置 NoneLinear 自定义模型
Trae 会自动把 /chat/completions 补到你填写的服务地址末尾。因此 自定义请求地址 填写 https://api.nonelinear.com.cn/v1 即可,不要额外拼接 /chat/completions。
不要在截图、工单、公开仓库或聊天群中暴露真实 API Key。如果怀疑 Key 泄露,请立即在 NoneLinear 控制台删除并重新生成。

3. 启用并测试模型

添加完成后,回到模型列表,在 自定义 分组下确认刚刚添加的模型已启用。 然后回到 Trae 对话或 Agent 面板,在模型选择器中选择该 NoneLinear 模型,发送一条测试消息,例如:
如果模型正常回复,说明 Trae 已经成功接入 NoneLinear API。

常见问题

自定义请求地址应该填 Base URL 还是完整路径?

Trae 的 自定义请求地址 填写 Base URL:
不要填写:
因为 Trae 会自动拼接 /chat/completions。

完整 URL 开关要打开吗?

通常保持关闭。关闭后,Trae 会按 OpenAI Chat Completions 格式自动补全请求路径。 只有在你明确需要把请求发送到一个完整接口地址时,才考虑打开 完整 URL。

模型 ID 应该怎么填?

模型 ID 必须与 NoneLinear 模型列表 中展示的 ID 完全一致,包括大小写、连字符和版本号。 示例:

使用思考模型时需要额外配置 reasoning effort 吗?

如果使用 gpt-5.5-high、DeepSeek-V3.2-Think 这类模型名称中已经带有明显思考模式标识的模型,一般不需要在工具侧额外配置 reasoning effort。NoneLinear 已经根据模型命名在平台内部配置好对应的思考参数。

配置后调用失败怎么办?

优先检查三项:
  • API Key 是否完整复制,前后不要带空格。
  • 自定义请求地址是否为 https://api.nonelinear.com.cn/v1。
  • 模型 ID 是否与 NoneLinear 模型列表完全一致。