---
head:
  - - meta
    - name: description
      content: 管理员在 OneGateway 查看和管理全体成员的 API Key，代成员新建密钥，调整配额、有效期、分组定价、可用模型与 IP 限制。
---

# 管理 API Keys {#管理-api-key}

管理员在 **用户 API Keys** 页面查看和管理全体成员的密钥，可以代成员新建，也可以调整已有密钥的限制。成员自己创建和使用密钥的说明见 [API Keys](/user/tokens)。

## 查找 API Key

列表以表格形式展示你权限范围内的全部 API Key。左上角选择字段并输入关键字搜索，右上角的筛选入口可按条件缩小范围，底部可调整每页行数并翻页。

## 代成员新建

点击右上角 **新建**，选择成员并填写名称即可创建。

| 字段 | 填写说明 |
| --- | --- |
| 所属部门 | 可选。选择后，成员列表只显示该部门下的人员 |
| 成员 | 必填。密钥归属的成员，调用产生的费用记在该成员名下 |
| 名称 | 必填。用于区分密钥的用途 |

需要施加限制时打开 **高级设置**。配额、过期时间、分组定价和可用模型的含义与成员侧一致：留空时分别表示不限额度、永不过期、使用该成员的分组定价、可调用全部可用模型。

::: warning 使用 `og-auto` 等虚拟模型时

限定了可用模型的密钥，按[智能路由](/guide/intelligent-routing)改写后的**实际模型**校验。只勾选虚拟模型名没有用，要把它可能用到的每个目标模型和候选模型都加进可用模型，否则请求返回 403，且不会切换到候选模型。目标模型和候选模型以智能路由规则为准。

:::

创建后，密钥在列表中脱敏展示。把完整密钥交给成员时，通过安全的渠道传递。

## 调整已有的 API Key

点击列表中的名称进入详情页，修改后点击右上角 **更新**；不再需要时点击 **删除**。

| 区域 | 可以修改的内容 |
| --- | --- |
| 基础信息 | 名称和分组定价可以修改；部门、用户、状态、密钥和创建时间由系统维护 |
| 配额与有效期 | 勾选 **无限额度**，或填写具体配额；设置过期时间，也可用 **永不过期**、**一小时**、**一天**、**一个月** 快捷设置 |
| 访问限制 | 调整 **可用模型**；在 **IP 限制** 中每行填写一个允许访问的地址，留空表示不限制 |

::: warning 删除会影响成员的调用
删除无法恢复，会影响正在使用该密钥的应用。因泄漏或离职撤销访问时，先停用并确认同步结果；启用语义缓存时还需验证缓存命中与上游转发路径，见[停用访问的核验步骤](/guide/faq#revoke-access)。调整分组定价或可用模型同样会影响正在运行的应用，修改前先与使用方确认。
:::

## 成员反馈调用异常时

| 现象 | 检查方向 |
| --- | --- |
| 提示密钥无效 | 确认密钥是否已被删除，以及成员使用的是不是最新的密钥 |
| 提示额度不足 | 查看列表中的剩余额度。密钥配额用完时提高配额；成员账户额度用完时，通过[额度与兑换码](/admin/quota)补充 |
| 提示密钥已过期 | 在详情页重新设置过期时间 |
| 提示模型不存在或无权限 | 核对详情页的可用模型，以及承载该模型的供应商是否已选择密钥使用的分组定价，见[分组定价](/admin/providers-and-models#分组定价) |
| 部分机器能调通、部分调不通 | 检查详情页的 IP 限制是否包含这些机器的出口地址 |
| 状态是已过期或已耗尽 | 这两种状态的密钥需要先延长有效期或补充额度，才能恢复调用 |

需要核对某一次具体调用时，在[日志](/user/usage)中按用户和 API Key 筛选。