必须确保base url格式严格匹配后端api监听地址,否则请求失败;需先验证服务健康状态,再在trae设置中完整填写含协议、主机、端口的url(如http://localhost:8000/v1),避免路径错误,并通过对话或network面板验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Trae中正确填写自定义大模型的Base URL,必须确保URL格式严格匹配后端API服务的实际监听地址,否则请求会直接失败并显示“Connection refused”或“Invalid endpoint”。
确认你的模型API服务已运行且可访问
先在终端执行 curl -v http://127.0.0.1:8000/health(将端口替换为你实际启动的服务端口),看到返回 {"status":"healthy"} 或类似响应,说明服务已就绪。如果超时或拒绝连接,Trae填再对的URL也没用。
这一步不能跳过——Trae不会校验URL有效性,只负责转发请求。
在Trae界面中填写Base URL
打开Trae → 点击左下角「设置」图标 → 进入「模型配置」→ 找到「自定义模型」区域 → 在「Base URL」输入框中粘贴完整地址。
必须包含协议、主机、端口,例如:【https://api.example.com/v1】 或 【http://localhost:8000/v1】;只填 localhost:8000 或 /v1 会导致请求路径错乱。
填完后点击「保存」,Trae会立即尝试向该地址发送 OPTIONS 预检请求——若控制台出现 405 或 404,说明路径末尾多加了斜杠(如 http://localhost:8000/v1/)或少写了版本路径(如漏掉 /v1)。
验证Base URL是否生效
方法一:新建对话 → 在输入框下方选择你刚配置的自定义模型 → 发送任意消息(如“hi”)→ 观察右下角状态栏是否显示「响应中…」而非「网络错误」。
方法二:打开浏览器开发者工具 → 切换到 Network 标签 → 发送消息 → 找到名为 chat/completions 的请求 → 点击查看 Headers → 检查 Request URL 是否与你填写的 Base URL 完全一致并拼接了 /chat/completions。
如果请求发到了 https://api.openai.com/v1/chat/completions,说明模型未正确切换,回到「模型配置」检查是否误选了 OpenAI 默认项。











