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 是否改對。