Trae 接入 NoneLinear

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

前置要求

配置步骤

1. 进入模型设置

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

2. 选择自定义配置

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

3. 启用并测试模型

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

常见问题

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

Trae 的 自定义请求地址 填写 Base URL:
https://api.nonelinear.com/v1
不要填写:
https://api.nonelinear.com/v1/chat/completions
因为 Trae 会自动拼接 /chat/completions

完整 URL 开关要打开吗?

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

模型 ID 应该怎么填?

模型 ID 必须与 NoneLinear 模型列表 中展示的 ID 完全一致,包括大小写、连字符和版本号。 示例:
gpt-5.4-medium
gpt-5.4-mini
DeepSeek-V3.2-Think

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

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

配置后调用失败怎么办?

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