管理员创建 Key
在管理控制台创建和管理 API Key，用于 API 请求的身份验证与权限控制
说明：API Key 是调用 AI Gateway 接口的身份凭证，创建后会通过邮箱发送给使用者。请妥善保管，不要泄露给他人。
前置准备：创建 API Key 前需要完成以下两项配置：
- 先完成 Token 供应商配置。请参考 Token 供应商配置文档。Token 供应商配置
- 在「系统设置」→「域名管理」中配置并启用至少一个域名。系统会在创建 Key 时校验是否有可用域名，未配置域名将无法创建 Key。
前置步骤：配置域名
在左侧导航栏中选择「系统设置」→「域名管理」，进入域名管理页面。点击「添加域名」按钮，输入域名地址并启用。
供应商列表
图 1：域名管理列表，展示已配置的域名及启用状态
填写 Key 基本信息
图 2：添加域名表单，输入域名并选择启用
Key 管理列表
1
进入 Key 管理页面
完成前置配置后，在左侧导航栏中选择「网关管理」→「Key 管理」，进入 Key 管理列表页面。
统计概览
页面顶部展示四张统计卡片，帮助您快速了解当前 Key 的整体状态：
活跃 Key 数量
活跃 Key 数量
正常使用的 Key
正常使用的 Key
接近或超过配额的 Key
接近或超过配额的 Key
被禁用的 Key 数量
被禁用的 Key 数量
Key 管理列表
图 3：Key 管理列表页面，展示所有已创建的 Key 及其状态
列表字段说明
| 字段 | 说明 |
|---|---|
| Key 名称 | 用户自定义的 Key 名称，下方显示脱敏后的 Key 前缀和后 4 位 |
| 供应商 | 该 Key 绑定的 Token 供应商名称，支持绑定多个供应商 |
| 绑定类型 | 「个人」或「应用」。个人 Key 绑定到具体用户，应用 Key 绑定到应用程序 |
| Key 后缀 | Key 的后 4 位字符，用于快速识别 |
| 使用量 | 展示今日使用量 / 日配额，以及使用百分比进度条。超过 80% 进度条变黄色 |
| 状态 | 绿色「启用」、灰色「已禁用」、橙色「日额度告警 / 月额度告警」、红色「已过期」 |
| 操作 | 复制 Key、编辑、重置 Key、删除、启用/禁用 |
搜索与筛选
列表上方提供了搜索和筛选功能，支持按以下条件过滤供应商：
- 名称搜索：输入 Key 名称关键字搜索
- 状态筛选：筛选「正常」或「已禁用」
- 绑定类型筛选：筛选「用户」或「应用」
- 点击「重置」按钮可清空所有筛选条件
创建 API Key
1
打开创建表单
点击列表页面右上角的「创建 Key」按钮，从右侧滑出抽屉式表单窗口。创建前系统会自动检查是否已配置并启用了域名，若未配置会提示前往域名管理页面。
2
填写 Key 基本信息
在添加供应商表单中，需要填写以下信息：
| 字段 | M | 说明 |
|---|---|---|
| Key 名称 | 是 | 用户自定义的 Key 名称，下方显示脱敏后的 Key 前缀和后 4 位 |