首页 > 教程攻略 > ai资讯 >Trae怎么填写Base_URL才正确?

Trae怎么填写Base_URL才正确?

来源:互联网 时间:2026-08-09 09:09:22

配置Trae接入第三方AI模型时,最让人头疼的往往不是模型本身,而是那个看似简单、实则暗藏陷阱的“Base URL”字段。填对了,一路畅通;填错了,404、401甚至路径拼接错误接踵而至,直接卡在第一步。这里先把几个核心判断讲清楚:Base URL必须严格匹配目标服务的API路径结构,OpenAI兼容服务得填到/v1/层级并且结尾带斜杠,Anthropic兼容服务则需要适配/messages的拼接逻辑——一步错,满盘输。

在Trae里成功调用第三方模型,前提就是Base URL精准对应目标服务的API路径。填错的话,连请求都发不出去,更别提调用了。

先判断你用的是哪种协议

别急着填地址,第一步是打开你拿到的API服务商文档,确认它声明支持的是OpenAI兼容接口,还是Anthropic兼容接口。这一步不能跳过——协议类型填错了,后面所有配置都是白费功夫。

目前绝大多数中转服务(比如Code0、阿里云百炼、火山CodingPlan)以及本地模型网关,都走的是OpenAI协议;而Claude的官方API以及部分企业级服务,则用Anthropic协议。两者路径拼接逻辑完全不同,必须区分清楚。

OpenAI兼容服务:Base URL必须精确到/v1/层级

拿到OpenAI兼容服务的完整请求地址后,操作很简单:截掉末尾的/chat/completions/completions

举个例子,你拿到的是:https://api.qnaigc.com/v1/chat/completions,那么Base URL就应该填入

【https://api.qnaigc.com/v1/】

这里有两个细节必须注意:第一,结尾一定要有斜杠/,填成https://api.qnaigc.com/v1(缺斜杠)或者https://api.qnaigc.com/v1//(双斜杠)都会导致失败;第二,不要加任何查询参数,比如?key=xxx——Base URL只负责定位服务根路径,参数部分Trae会自动注入。

常见错误示例:把https://code0.ai/v1/chat/completions直接当作Base URL填进去,结果Trae会二次拼接,变成/v1/chat/completions/chat/completions,服务器直接返回404。所以截断动作必须手动完成,不能图省事直接复制粘贴。

Anthropic兼容服务:Base URL必须精确到/messages前一级

Anthropic协议的路径拼接逻辑和OpenAI不同。以火山CodingPlan为例,官方要求填写的Base URL是

【https://ark.cn-beijing.volces.com/api/coding/v3】

——注意结尾没有斜杠,但路径本身已经包含/v3,Trae会自动在后面补上/messages,最终形成/v3/messages的合法请求路径。

如果服务商文档明确给出了/messages端点,比如https://api.anthropic.com/v1/messages,那么Base URL可以填https://api.anthropic.com/v1(不带斜杠)或者https://api.anthropic.com/v1/(带斜杠),两者都行。

⚠️ 提醒:在Trae里选择模型时,Anthropic模型必须选“Anthropic”协议类型,千万别选成“OpenAI”,否则路径拼接逻辑会错位,请求根本发不出去。

小米MiMo Token Plan等特殊服务商

有些服务商给的Endpoint路径比较特殊,比如小米MiMo Token Plan,完整地址是https://api.mimo.kefu.mi.com/openai/v1/chat/completions。你需要手动删除最后的/chat/completions,保留到/v1/结尾:

【https://api.mimo.kefu.mi.com/openai/v1/】

填错的话,Trae会发出重复路径的请求,比如变成/openai/v1/chat/completions/chat/completions,服务器直接返回404。这个截断动作必须手动完成,不能依赖复制粘贴。

填完后点击保存,立刻在对话窗口选择该模型测试——只要不报“Invalid URL”或“Failed to fetch”,说明Base URL格式正确,接下来就可以放心调用了。