Trae中Base URL必须填完整接口端点,v3.3.51+版本才支持自定义;OpenAI兼容需填/v1/chat/completions,Anthropic需填/v1/messages,填错路径直接返回404或连接拒绝。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你在Trae里填了Base URL却提示“请求服务失败,请检查网络后重试”,不是网络真断了,而是URL没填对——Trae不拼路径,只认你填的完整地址,少一个斜杠、多一层目录、漏掉/chat/completions,都会直接返回404或连接拒绝。
确认是否用了支持自定义Base URL的版本
第一步:打开Trae → 点击右上角头像 →「关于」→ 查看版本号。
必须是 【v3.3.51 或更高版本】,低于此版本的「模型管理」里压根没有「Custom Request URL」输入框,所有配置都无效。
第二步:若版本过低,立即卸载当前版本,前往 trae.cn 下载最新安装包覆盖安装。旧版即使填了URL也会静默忽略,不报错也不生效。
检查Base URL是否写到具体接口端点
这是90%连接失败的根源。Trae不会自动补全路径,你填什么,它就发什么请求。
方法一(OpenAI兼容接口):
正确格式必须包含完整端点:https://your-api.com/v1/chat/completions
错误示例:https://your-api.com/v1(缺/chat/completions)、https://your-api.com(只到域名)
方法二(Anthropic兼容接口):
必须填到 /messages:https://api.anthropic.com/v1/messages
填成 https://api.anthropic.com/v1 就会报404,因为Anthropic不响应根路径或/v1路径。
注意:小米MiMo Token Plan这类服务,官方文档写的Base URL是 https://token-plan-cn.xiaomimimo.com/v1,但实际可用的端点是 【https://token-plan-cn.xiaomimimo.com/v1/chat/completions】,填错就直接返回HTML 404页面。
验证URL能否被本地系统正常解析和访问
打开终端,执行:
curl -v https://your-filled-url.com/v1/chat/completions -H "Authorization: Bearer sk-xxx"
如果返回401或403,说明URL可达、服务在线,问题出在密钥或权限;
如果返回connection refused、timeout或Name or service not known,说明DNS解析失败、域名不可达、或端口被防火墙拦截。
特别提醒:若URL含自定义域名(如 api.my-gateway.local),请确认该域名已在本机 /etc/hosts 中映射,或DNS服务器能正确解析——Trae不会走代理或特殊DNS配置,只依赖系统默认解析行为。
排查中转或代理服务的路径转发逻辑
如果你用的是Code0、SiliconCloud、OpenRouter等中转服务:
第一步:确认该中转服务本身是否正常运行(访问其官网状态页或测试页面);
第二步:检查你填的URL是否与其文档一致,比如Code0要求填 https://code0.ai/v1,而它内部已将/v1路由到对应模型服务,此时你再加/chat/completions反而会变成 https://code0.ai/v1/chat/completions/chat/completions,导致404;
第三步:若使用自建FastAPI/Ollama网关,确保其启动时监听的是0.0.0.0:端口,而非127.0.0.1:端口——Trae运行在独立进程中,无法访问仅限本地回环的监听地址。


















