---
head:
  - - meta
    - name: description
      content: 在 OneGateway 创建和管理自己的 API Key，获取 API 地址，设置配额、过期时间、分组定价、可用模型与 IP 限制。
---

# API Keys {#api-key}

API Key 是应用通过 OneGateway 调用模型时的身份凭证。在 **API Keys** 页面创建和管理你自己的密钥，列表中只显示属于你的密钥。

页面顶部的 **API 地址** 是应用请求要指向的服务地址，点击右侧图标复制。按应用使用的接口格式（OpenAI、Anthropic 等）配置 API 地址和 API Key 即可开始调用，完整的请求示例见[快速开始](/guide/getting-started)。

## 创建 API Key

点击右上角 **新建 API Key**，填写 **名称** 后点击 **确定** 即可创建。名称用于区分用途，例如“Chatbox 密钥”。

这样创建的 API Key 不限额度、不过期、使用你的分组定价、可以调用全部可用模型。需要施加限制时，打开 **高级设置**：

| 字段 | 作用 | 留空时 |
| --- | --- | --- |
| 配额 | 这个 API Key 最多可以消耗的金额 | 不限额度 |
| 过期时间 | 到达该时间后密钥自动失效 | 永不过期 |
| 分组定价 | 决定调用的计费倍率 | 使用你的分组定价 |
| 可用模型 | 限定这个密钥只能调用哪些模型 | 全部可用模型 |

分组定价和可用模型的可选范围由管理员配置，你能调用的模型见[可用模型](/user/models)。

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

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

:::

创建后，密钥在卡片上以脱敏形式展示。点击密钥右侧的复制图标获取完整内容，粘贴到应用中保存。

## 管理已有的 API Keys {#管理已有的-api-key}

每张卡片对应一个 API Key。

| 卡片内容 | 说明 |
| --- | --- |
| 名称与分组定价 | 密钥名称，以及它使用的分组定价 |
| 额度 | 未设置配额时显示「无限额度」；设置过配额时显示剩余额度、已用额度和使用比例 |
| 状态开关 | 控制这个密钥能否调用；关闭后确认配置同步，并验证旧密钥的请求已被拒绝 |
| 可用模型 | 未做限制时显示「全部模型」 |
| 过期时间 | 显示到期日期或「永不过期」，已过期的会标记出来 |
| 密钥 | 脱敏显示，点击右侧图标复制完整密钥 |

卡片右上角有三个按钮，分别用于 **编辑**、**查看用量** 和 **删除**。

::: warning 密钥疑似泄漏时先关闭，不要直接删除
先关闭状态开关，保留这个密钥的历史记录，确认配置同步和拒绝调用的结果。启用语义缓存时，还需分别验证缓存命中与上游转发路径，见[停用访问的核验步骤](/guide/faq#revoke-access)。确认不再需要后再删除；删除无法恢复，会影响正在使用它的应用。
:::

## 修改限制

点击卡片上的编辑按钮进入详情页，修改后点击右上角 **更新**。

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

修改分组定价或可用模型后，用这个密钥发起一次调用，在[日志](/user/usage)中确认实际使用的模型和费用符合预期。