必须在Trae中正确填写Base URL才能接入本地大模型等服务,填错会导致API连接失败;Base URL须精确匹配实际端点,OpenAI接口结尾为/v1/chat/completions,Anthropic为/messages,火山引擎为/api/coding/v3。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在Trae中正确填写Base URL才能接入本地大模型、第三方中转服务或企业私有AI网关,填错会导致“API连接失败”或“模型不可用”,而错误往往出在路径层级上。
确认版本与入口
打开Trae → 左下角设置图标(或按 Ctrl+, )→ 进入 Settings → 找到 Models 标签页。
【必须使用 v3.3.51 或更高版本】 旧版不显示 Custom Request URL 字段,强行升级可避免后续反复重装。
填写Base URL的三项硬性规则
Base URL不是域名,也不是/v1,它必须精确匹配目标服务的实际请求端点。
OpenAI兼容接口:结尾必须是 /v1/chat/completions,例如 https://api.qnaigc.com/v1/chat/completions。
Anthropic兼容接口:结尾必须是 /messages,例如 https://api.anthropic.com/v1/messages。
火山引擎Coding Plan:必须用 https://ark.cn-beijing.volces.com/api/coding/v3,【绝不能写成 /api/v3】,否则会走在线推理通道,扣费且不消耗Coding Plan额度。
不同服务商的填写示例
方法一:阿里云百炼(OpenAI协议)
Base URL 填:https://coding.dashscope.aliyuncs.com/v1/chat/completions
方法二:小米MiMo Token Plan(OpenAI协议)
Base URL 填:https://token-plan-cn.xiaomimimo.com/v1/chat/completions,注意中间无空格、无下划线。
方法三:魔芋AI聚合网关
Base URL 填:https://api.moyu.info/v1/chat/completions,该地址已预置兼容全部92个模型,无需额外切换。
验证与保存
第一步:填完 Base URL、API Key、Model Name 后,点击右下角「Add Model」按钮。
第二步:返回对话窗口,在模型选择器中找到刚添加的条目,点击一次即可触发首次调用。
第三步:输入一句简单指令如“输出 hello world”,若返回文本且无报错,说明 Base URL 配置成功。
如果提示“Invalid endpoint”或“404 Not Found”,请立即检查 Base URL 是否漏掉 /chat/completions 或 /messages 这一级路径——这是90%配置失败的根源。


















