必须点击“保存并测试”才能验证接口连通性,trae将base url视为最终请求地址,不自动拼接路径,填错或遗漏/chat/completions等端点将直接返回404;测试成功需同时满足网络可达、路径正确、api key有效、模型id被识别。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Trae中填完Base URL后,必须点击“保存并测试”才能验证接口是否真正连通,仅保存配置不会触发任何网络请求,也不会告诉你地址写对没写错。
点击“保存并测试”触发真实HTTP请求
进入模型设置页 → 找到刚填写完的模型条目 → 点击右侧「保存并测试」按钮 → Trae会立即向你填的完整URL发起一次/chat/completions(OpenAI)或/messages(Anthropic)请求。
这一步不是形式主义。Trae不会做路径拼接,【它把Base URL当最终请求地址用,一个字符都不能错】。比如填了https://api.xiaomimimo.com/v1却没加/chat/completions,就会直接404,根本不会帮你补。
看控制台日志确认成功响应
测试过程中,Trae底部状态栏会短暂显示“正在测试…”;结束后自动弹出提示框。
如果看到绿色“✅ 测试成功”,说明:① 网络可达 ② 路径正确 ③ API Key未被拒绝 ④ 模型ID被服务端识别。此时可直接在聊天窗口切换该模型使用。
若弹出红色错误框,重点看报错内容里的HTTP状态码:401代表Key无效或格式不对(tp-xxx vs sk-xxx),404代表URL路径少了一截(比如漏掉/chat/completions),429代表额度耗尽或请求频率超限。
手动验证失败时的三步排查法
第一步:复制你填进Trae的完整Custom Request URL,粘贴到浏览器地址栏回车 → 如果返回JSON格式的{"error": "invalid_api_key"}之类,说明地址和协议没问题,问题出在Key或模型ID;如果直接显示404页面或空白,说明URL本身不可达。
第二步:用curl命令行验证(Windows PowerShell或macOS Terminal):curl -X POST "你的完整URL" -H "Authorization: Bearer 你的API Key" -H "Content-Type: application/json" -d '{"model":"mimo-v2.5-pro","messages":[{"role":"user","content":"hi"}]}' → 这能绕过Trae封装,暴露原始服务响应。
第三步:检查模型服务商文档里要求的最小请求体字段。有些服务(如火山CodingPlan)强制要求带stream: false,缺了就拒收;有些(如Anthropic)必须用system字段而非messages[0]传系统提示词。【Trae默认发的请求体结构未必匹配所有厂商】











