---
title: API 密钥管理
description: 创建 API Key，设置额度、有效期与 IP 访问规则。
---

入口：[控制台 → API 密钥](https://sub.vcnovb.cn/keys)。建议每个应用使用独立密钥，并设置容易识别的名称。

## 创建与使用

1. 新建密钥，填写名称并选择分组。
2. 根据需要设置额度、有效期和访问限制。
3. 保存后复制 Key，或打开使用说明生成客户端配置。
4. 发起请求后，在使用记录中按密钥筛选消耗。

## 密钥设置

| 设置 | 作用 |
| --- | --- |
| 额度上限 | 限制该 Key 的累计使用额度；与账户余额、套餐额度分别校验 |
| 有效期 | 到期后不能继续调用 |
| 周期额度 | 按 5 小时、1 天、7 天周期设置金额用量上限 |
| IP 白名单 / 黑名单 | 限制调用来源；应填写实际出口 IP 或受支持的网段 |
| 分组 | 决定模型、协议和计费规则；详见[分组选择](/guides/groups) |

调用前确保 Key 处于启用状态、未过期、额度充足，且请求来源符合 IP 规则。

## 多个应用如何管理

给聊天客户端、编程工具和自己的服务分别建 Key，按名称查询用量。修改分组后重新核对模型和价格，正在运行的应用也应同步检查配置。

## 密钥泄露怎么办

立即在密钥列表停用或删除泄露的 Key，再创建新密钥并更新客户端。检查泄露时段的使用记录，发现异常可提交[工单](/help/support)。

不要把 API Key 写入浏览器前端、公开仓库或分享截图。工单排查通常只需要密钥名称或 ID，不需要完整 Key。