網路與連線說明
從中國大陸、香港、台灣、新加坡和馬來西亞存取 Vidmoat 的 API、開發者文件和 MCP 伺服器時需要知道的事。
在香港、台灣、新加坡和馬來西亞,所有 Vidmoat 網域都能正常存取,包括登入。在中國大陸,API 和文件同樣可以直接存取,不需要 VPN;唯一要留意的是登入:在登入遷移到我們自己的網域之前,從中國大陸登入可能需要 VPN。
可以直接存取的網域#
| 網域 | 用途 | 中國大陸 |
|---|---|---|
api.vidmoat.com | REST API、MCP 伺服器、OAuth 權杖端點 | 可直接存取,不需要 VPN |
developer.vidmoat.com | 開發者文件和主控台 | 可直接存取,不需要 VPN |
用 API 金鑰呼叫 REST API 和 MCP(請求標頭方式)時,只會存取 api.vidmoat.com。
不需要 ICP 備案#
Vidmoat 的伺服器部署在中國大陸以外,所以我們的網域沒有 ICP 備案,也不需要。呼叫 API 不需要你辦理任何備案;你自己的產品如何備案,依你所在地的規定辦理。
登入#
在主控台建立金鑰,以及 MCP 的 OAuth 授權,都需要登入 Vidmoat 帳號。目前登入使用的身分驗證服務在中國大陸可能無法存取,所以從中國大陸登入時可能需要 VPN。我們正在把登入遷移到 Vidmoat 自己的網域,完成後從中國大陸登入就不再需要 VPN,本頁也會跟著更新。
在那之前,從中國大陸使用建議這樣做:
- 只在建立金鑰時登入一次,必要時使用 VPN。
- 之後用 API 金鑰呼叫 REST API 和 MCP(請求標頭方式)。這兩者都只存取
api.vidmoat.com,不需要登入,也不需要 VPN。 - MCP 的 OAuth 方式在授權時會開啟登入頁。從中國大陸使用時,建議改用請求標頭方式,各用戶端的寫法見連線 MCP 伺服器。
實用建議#
- npm 鏡像站。
npx mcp-remote和 Qwen Code 都透過 npm 安裝。從中國大陸下載很慢時,可以執行npm config set registry https://registry.npmmirror.com切換到大陸的鏡像站。 - 不要因為逾時就重送算繪。 算繪和生成都是非同步的:送出後用 Webhook 或輪詢取得結果。如果送出算繪的請求逾時,先查詢既有的算繪,不要直接再送一次,否則可能重複排入佇列。
- 金鑰只放在伺服器上。 不要寫進網頁或 App 的前端程式碼;外洩後到主控台撤銷,再建立一把新的。