API 密钥管理

API 密钥是调用 API 的凭证,每个密钥可独立配置权限范围和配额上限。左侧导航点击「API 密钥」,或直接访问 /keys

API 密钥列表展示所有已创建的密钥,包含名称、状态、已用配额、剩余配额、过期时间等信息。

API 密钥列表

创建 API 密钥

基本配置

打开创建弹窗

在 API 密钥列表页点击右上角「创建 API 密钥」按钮,弹出创建弹窗

填写密钥名称

输入密钥名称(建议按用途命名,如「生产环境」「测试用」)

创建 API 密钥

高级配置选项

配置项说明
过期时间设置有效期,留空或设为 -1 表示永不过期
额度限制该 API 密钥可消耗的最大配额,超出后自动失效
无限配额开启后不受配额限制(仍受账户总配额约束)
模型限制限定该 API 密钥只能调用指定模型,留空表示不限制
IP 白名单限定允许使用该 API 密钥的来源 IP,留空表示不限制
分组指定该 API 密钥使用的渠道分组

保存 API 密钥

点击「保存更改」,完成 API 密钥创建流程,可在令牌列表中复制使用 API 密钥。

API 密钥展示

编辑 API 密钥

在 API 密钥列表中找到目标密钥,点击右侧「编辑」按钮,可修改 API 密钥的配置选项(不包括 API 密钥本身)。可修改的选项包括过期时间、额度、模型限制、IP 白名单和分组等。

删除 API 密钥

在 API 密钥列表中找到目标密钥,点击右侧「删除」按钮,确认后该 API 密钥立即失效,无法恢复。

ℹ️ 最佳实践
  • 为不同用途(生产、测试、开发)创建独立 API 密钥
  • 为每个 API 密钥设置合理的配额上限,防止意外超额消耗
  • 定期清理不再使用的 API 密钥
  • 对生产环境 API 密钥配置 IP 白名单提高安全性