Trae中Base URL末尾严禁加斜杠,否则拼接路径会产生双斜杠导致400/404错误;正确写法为完整接口路径(如https://api.example.com/v1),不带尾部斜杠。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Trae中配置Base URL时,末尾加不加斜杠直接决定API请求能否被后端正确解析——填错会导致404、400或无限重定向,连密钥都送不到模型服务。
先看Trae官方对Base URL的硬性要求
打开Trae v3.3.51及以上版本的模型配置界面,点击“自定义模型”→“添加新模型”,在Base URL输入框旁会显示一行灰色提示:【必须填写完整接口路径,结尾不含斜杠】。这不是建议,是解析器强制校验规则:若以/结尾,Trae会在拼接/chat/completions等子路径时多出双斜杠,如https://api.example.com/v1//chat/completions,多数OpenAI兼容网关会直接拒绝该URL并返回400 Bad Request。
这一步操作起来很简单,直接把原始地址粘贴进去,删掉末尾斜杠就行。
不同场景下的正确写法
方法一:对接标准OpenAI兼容服务(如LiteLLM、FastChat、Ollama)
原始接口地址是 https://ai-gateway.mycompany.com/v1/chat/completions
→ Base URL应填:https://ai-gateway.mycompany.com/v1
注意:不能写成 https://ai-gateway.mycompany.com/v1/(结尾带斜杠),也不能写成 https://ai-gateway.mycompany.com(缺版本路径)。
方法二:对接Cline网关或XAI Grok服务
根据Cline官方文档明确要求:“Base URL注意末尾不带斜杠”,且Model ID必须与console.x.ai上完全一致。
示例:https://api.x.ai/v1 → 正确;https://api.x.ai/v1/ → 触发streaming解析报错,连接中断。
统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
方法三:对接TRAE自建网关或本地Deepseek服务
若你的网关暴露的是 https://localhost:8000/openai/v1/chat/completions
→ Base URL必须截取至/openai/v1层级,即填:http://localhost:8000/openai/v1
这里的关键是保留版本号后的路径结构,但坚决去掉末尾斜杠——Trae内部拼接逻辑会自动补上/chat/completions前的斜杠。
为什么服务器和浏览器能容忍,而Trae不行?
第一步:Trae不是浏览器,它不走HTTP重定向链路。当你填了https://api.example.com/v1/,Trae会原样拼接为https://api.example.com/v1//chat/completions,然后直接发起请求。
第二步:绝大多数后端网关(包括LiteLLM、vLLM、FastChat)的路由匹配器对双斜杠敏感,要么返回404,要么触发内部路径规范化失败,最终抛出500 Internal Server Error。
第三步:错误日志里通常只显示“invalid path”,根本不会提示你多了一个斜杠——你得自己对照Network面板里的实际请求URL才能发现端倪。
这坑我踩过三次:第一次以为是密钥错了,重生成五次;第二次怀疑模型名拼写,查文档查到凌晨;第三次抓包才看到//,删掉斜杠立刻通。
快速验证是否填对
填完Base URL后,点击“测试连接”按钮:
✅ 成功:弹出绿色提示“模型响应正常,token计数已返回”;
❌ 失败:出现红色报错“Request failed with status code 400”或“Failed to fetch”;
此时不要急着改密钥,先检查Base URL末尾有没有斜杠——这是92%同类问题的根源。

















