Trae 接入 NoneLinear
Trae 国际版支持添加自定义 OpenAI Chat Completions 兼容模型。将模型配置为自定义服务,并填写 NoneLinear 的 API 地址、API Key 和模型 ID 后,即可在 Trae 中调用 NoneLinear 模型进行代码问答、Agent 辅助开发和多模态任务。
前置要求
配置步骤
1. 进入模型设置
打开 Trae 后,点击右上角的 设置 图标,进入设置页面。
在左侧菜单中选择 模型,然后在模型管理区域点击 添加模型。
2. 选择自定义配置
在 添加模型 弹窗中,切换到 自定义配置。
然后填写以下信息:
| 字段 | 填写内容 |
|---|
| API 格式 | OpenAI Chat Completions 格式 |
| 自定义请求地址 | https://api.nonelinear.com/v1 |
| 完整 URL | 关闭 |
| 模型 ID | 例如 gpt-5.4-medium |
| API 密钥 | 你的 NoneLinear API Key |
填写完成后点击 添加模型。
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-high、DeepSeek-V3.2-Think 这类模型名称中已经带有明显思考模式标识的模型,一般不需要在工具侧额外配置 reasoning effort。NoneLinear 已经根据模型命名在平台内部配置好对应的思考参数。
配置后调用失败怎么办?
优先检查三项:
- API Key 是否完整复制,前后不要带空格。
- 自定义请求地址是否为
https://api.nonelinear.com/v1。
- 模型 ID 是否与 NoneLinear 模型列表完全一致。