| --- | |
| title: "查找或替换你的许可证 / API 密钥" | |
| description: "了解在何处创建桌面应用、命令行工具或 REST API 所需的 wm_ 开头密钥、哪些订阅套餐会包含密钥额度、如何轮换与撤销现有密钥、以及当仪表盘不再显示完整密钥值时的恢复流程与替代方案，并附上 MCP 客户端、Python SDK 与自建脚本的常见接入示例。" | |
| --- | |
| World Monitor 在某些桌面界面中将此值称为**许可证密钥（license key）**，在其他地方称为 **API 密钥（API key）**。它们指的是同一个由用户创建的值，以 `wm_` 开头。 | |
| <Info> | |
| 结账不会为你创建可复用的密钥。**API Starter 和 API Business** 订阅用户在登录后自行创建密钥。**Dashboard Pro 与 Pro Business 均不包含手动 API 密钥**；这些订阅用户可以使用已登录的网页版仪表盘，并改用 OAuth 连接受支持的 MCP 客户端。 | |
| </Info> | |
| ## 创建密钥 | |
| 1. 打开 [World Monitor 仪表盘](https://worldmonitor.app/dashboard)，使用拥有该 API 订阅的账户登录。 | |
| 2. 点击右上角的 **Settings（设置）**。 | |
| 3. 打开 **API Keys（API 密钥）** 标签页。 | |
| 4. 输入名称，例如 `desktop` 或 `my-app`，然后点击 **Create Key（创建密钥）**。 | |
| 5. 立即复制完整的 `wm_...` 值，并将其保存到密码管理器或密钥管理器中。 | |
| 完整密钥仅显示一次。World Monitor 存储的是单向哈希，而非明文密钥。 | |
| ## 如果你只能看到前缀 | |
| API Keys 标签页会列出一个简短前缀，方便你识别每个密钥，但它无法再次显示完整的值。 | |
| 1. 吊销你丢失了完整值的那个密钥。 | |
| 2. 创建一个替换密钥。 | |
| 3. 更新所有使用旧密钥的应用或脚本。 | |
| 吊销是永久性的。使用旧密钥的应用将停止工作。 | |
| ## 在桌面应用中使用密钥 | |
| 在 World Monitor 桌面应用中，打开 **Settings → Overview（设置 → 概览）**，将完整的值粘贴到 **License / API Key（许可证 / API 密钥）** 字段中，然后点击 **Save & Close（保存并关闭）**。 | |
| 对于 API 请求，请在 `X-WorldMonitor-Key` 标头中发送相同的值。示例请参见 [API 快速开始](/zh/usage-quickstart)。 | |
| ## 如果 API Keys 标签页提示你升级 | |
| 手动密钥需要有效的 **API Starter** 或 **API Business** 订阅。Dashboard Pro 或 Pro Business 订阅可解锁仪表盘和 MCP 功能，但不包含手动创建 API 密钥。 | |
| 如果你已经购买了 API 套餐，请确认你是使用拥有该订阅的账户登录的。如果套餐仍未被识别，请从购买时使用的邮箱地址发送邮件至 [support@worldmonitor.app](mailto:support@worldmonitor.app)。请附上套餐名称，如有可能，仅提供简短的密钥前缀——**切勿发送完整密钥**。 | |
| ## 相关 | |
| - [账户与注册](/zh/accounts) | |
| - [套餐与价格](/zh/pricing) | |
| - [身份验证与使用](/zh/usage-auth) | |
| - [支持与联系](/zh/support) | |