Base URL 怎么填

Base URL 是客户端或 SDK 请求 API 时使用的基础地址。

你可以把它理解成“请求要发往哪里”。如果这个地址填错了，即使你的 API Key 是对的，也一样会请求失败。

API 地址配置示例：输入框中的 Base URL 与下方预览的完整请求地址

MoleAPI 最常用的填写方式

对于绝大多数支持 OpenAI 兼容接口的工具和 SDK，推荐直接填写：

https://api.moleapi.com/v1

这是新手最应该优先记住的一条配置。

为什么很多场景都要带 `/v1`

因为很多 SDK 或客户端会自动在你填写的 Base URL 后，继续拼接类似下面这样的路径：

/chat/completions
/responses
/embeddings
/images/generations

所以如果你填写的是：

https://api.moleapi.com/v1

最终它拼出来的完整地址可能就是：

https://api.moleapi.com/v1/chat/completions

这通常就是正确的。

什么时候可以不写 `/v1`

少数工具会要求你填写的是“站点根地址”，然后它自己内部再补 /v1。

这种情况下，你可以尝试：

https://api.moleapi.com

但如果你不确定，优先先试 https://api.moleapi.com/v1。

给新手的简单结论

不确定怎么填时，先用：https://api.moleapi.com/v1

最常见的错误写法

错误 1：填成 OpenAI 官方地址

例如：

https://api.openai.com/v1

这样请求就不会走到 MoleAPI，而是直接发去 OpenAI 官方。

错误 2：漏掉 `/v1`

有些应用必须填写到 /v1，如果你只写：

https://api.moleapi.com

就可能出现：

404
Invalid URL
接口不存在
请求路径拼接错误

错误 3：把完整接口路径当成 Base URL

例如你把它写成：

https://api.moleapi.com/v1/chat/completions

这通常是不对的，因为很多 SDK 还会在后面继续拼路径，最后就会拼乱。

除非某个工具明确要求你填写完整接口地址，否则 Base URL 一般只应填到：

https://api.moleapi.com/v1

错误 4：复制时多了空格、中文符号或错误协议

比如：

https//api.moleapi.com/v1
http://api.moleapi.com/v1
地址前后多了空格
复制进了全角字符

这类问题很常见，而且肉眼不一定立刻看出来。

如何快速判断自己有没有填对

你可以按下面顺序检查：

Base URL 是否是 https://api.moleapi.com/v1
API Key 是否是你在 MoleAPI 控制台创建的 sk-...
模型名是否是当前分组下可用的模型
客户端是否支持 OpenAI 兼容接口

如果你已经确认这些都没问题，仍然失败，再去看更细的日志和错误码。

常见场景建议

场景 1：第三方客户端接入

如 Chatbox、NextChat、沉浸式翻译、Cherry Studio 一类工具：

优先填 https://api.moleapi.com/v1
API Key 填你的 sk-...

场景 2：OpenAI SDK 接入

无论是 Node.js、Python 还是其他 OpenAI 兼容 SDK，通常也优先填：

https://api.moleapi.com/v1

场景 3：你看到报错里出现 `api.openai.com`

这通常说明你的请求根本没有走到 MoleAPI，而是仍在请求 OpenAI 官方地址。优先检查 Base URL 是否改对。