设置API令牌
API令牌
在“设置”中为以您身份进行身份验证的脚本和 MCP 客户端创建、轮换和撤销个人 API 令牌。
API tokens 是验证为 you 的个人凭据。当您需要从“设置”控制的令牌时,请将它们用于脚本或 MCP 客户端。
从用户菜单中打开 Settings(您的名字位于侧边栏的左下角),然后打开 API tokens 选项卡。
仅当您的组织启用了 API 访问权限时,API 令牌才会出现。组织拥有的 service tokens 位于管理面板 API 控制台,而不是此处。
创建一个令牌
- 前往Settings → API tokens
- 单击Create token
- 输入 Name(例如
Grafana ingest或Nightly scripts) - 选择 Expiry(7、30、90 或 365 天)
- 至少选择一个Scope。选择器仅显示您的计划和组织启用的范围。
- (可选)设置 IP allowlist(中小企业和企业)。如果不需要 IP 固定,请保持打开状态。
- (可选)pin 您当前组织的令牌。当您切换时,取消固定的令牌会跟随您的活动组织(对于多组织 MCP 或脚本使用很有用)。
- 单击Create token
- Copy the token immediately. PetroBench 仅显示一次秘密。
任何使用撤销或轮换令牌的操作都会立即停止工作。
管理代币
| 行动 | 它有什么作用 |
|---|---|
| Revoke | 立即删除令牌。无法撤消。 |
| Rotate | 撤销旧的秘密并发布具有相同范围的新秘密。更新每个客户。 |
| Rename | 更改显示名称。 |
| Resume | 清除异常暂停(部门管理员或更高级别)。 |
按 Status(Active 或 Expired)过滤列表。单击令牌名称可了解范围、IP 允许列表、到期时间和其他详细信息。
个人令牌、服务令牌、连接应用程序
| 资质证书 | 哪里 | 最适合 |
|---|---|---|
| Personal API token | 设置 → API 令牌 | 你和你的脚本 |
| Service token | 管理面板 → API 控制台 → 服务令牌 | 整合和工作必须比一个人的寿命更长 |
| Connected app (OAuth) | 设置 → 连接的应用程序 | 无需粘贴密码即可登录的 AI 主机 |
速率限制和暂停
如果调用返回429,则打开Admin Panel → API & Integrations → API Console → Usage,然后参见速率限制。
代币可以因每日支出上限或异常使用而暂停。当您有权限时,从令牌行恢复,或联系部门管理员。
## 有关的