网络与访问说明
从中国大陆、香港、台湾、新加坡和马来西亚访问 Vidmoat 的 API、开发者文档和 MCP 服务器时需要知道的事。
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 服务器。
香港、台湾、新加坡和马来西亚#
这些地区访问所有 Vidmoat 域名都没有特别限制,包括登录。
实用建议#
- npm 镜像。
npx mcp-remote和 Qwen Code 都从 npm 安装。在中国大陆下载慢时,可以运行npm config set registry https://registry.npmmirror.com切换到国内镜像。 - 不要因为超时重复提交渲染。 渲染和生成都是异步的:提交后用 Webhook 或轮询拿结果。如果提交渲染的请求超时,先查询已有的渲染,不要直接再发一次,否则可能排两次队。
- 密钥只放在服务器上。 不要写进网页或 App 的前端代码;泄露后到控制台撤销,再创建一把新的。