Base URL 怎么填

接任何客户端、插件、CLI 工具时，第一步都是填 Base URL，而这一步错得最多。

原因是：不同客户端对"Base URL"的理解不一样——有的会帮你补 /v1，有的不会。填错了只会得到一个 404，界面上完全看不出哪里不对。

这一页把规则讲清楚，并给出各工具的对照表。

速查表

这份表会随着文档补充陆续增加。表里没有你的工具，用下面第二节的方法自己判断。

只需要问一个问题：

这个客户端会不会帮我补 /v1？

情况	填什么	例子
客户端会补 `/v1/chat/completions`	只填根地址 `https://api.wxiai.com`	Cherry Studio
客户端只补 `/chat/completions`	填 `https://api.wxiai.com/v1`	Cursor、Codex

看不出来怎么办？看报错里拼出来的路径。

这是最可靠的判断方法，因为错误信息会直接暴露它拼了什么：

报错里出现的路径	说明	怎么改
`/v1/v1/chat/completions`	你多填了 `/v1`	去掉，只留 `https://api.wxiai.com`
`/v1/chat/completions/chat/completions`	你填成了完整端点	删掉 `/chat/completions`，只留到 `/v1`
`/chat/completions`（少了 `v1`）	你少填了 `/v1`	加上，填 `https://api.wxiai.com/v1`

一条通用底线

永远不要填完整的接口地址，也就是不要填 https://api.wxiai.com/v1/chat/completions。

Base URL 是"根"，客户端会在它后面接路径。你填了完整地址，等于让它接两次。

走 Anthropic 协议（/v1/messages）的工具，规则和 OpenAI 协议不一样：

协议	Base URL	注意
OpenAI 协议	`https://api.wxiai.com/v1`	带 `/v1`
Anthropic 协议	`https://api.wxiai.com`	不要带 `/v1`，否则会拼成 `/v1/v1/messages`

判断方法：看这个工具是不是只认 Anthropic。

配任何工具之前，先用这条命令确认地址和 Key 是对的：

bash

curl https://api.wxiai.com/v1/models \
  -H "Authorization: Bearer sk-你的APIKey"

能返回模型列表，说明：

剩下的问题就只可能在客户端的 Base URL 拼接上——这时候再对着上面的报错表改，一次就能定位。

更多错误码见错误码。