---
title: API 密钥
pageTitle: API 密钥
eyebrow: 详细配置
lead: 管理客户端访问 CCR 网关时使用的 API Key，并为每个 Key 设置过期时间和本地限额。
---

## 列表字段

| 字段 | 代表的能力 |
| --- | --- |
| 搜索 API 密钥 | 按名称或 Key 内容过滤列表。 |
| 添加 API 密钥 | 打开创建弹窗，生成新的客户端访问 Key。 |
| 名称 | API Key 的显示名，用于区分客户端、团队、用途或自动化来源。 |
| Key | 脱敏后的访问 Key。可以点击 `复制 API 密钥` 复制完整 Key。 |
| 过期 | 当前 Key 的过期时间。过期后客户端不能继续使用这个 Key 访问 CCR。 |
| 限制 | 当前 Key 的本地限额摘要。没有配置限额时显示“未配置限制”。 |
| 编辑 API 密钥 | 修改过期时间和限额。出于安全原因，已创建的 Key 本身不会重新明文展示。 |
| 移除 API 密钥 | 删除当前客户端访问 Key。删除后立即不能再用于请求。 |

## 创建和编辑

| 字段 | 代表的能力 |
| --- | --- |
| 名称 | 新 Key 的显示名。建议写成客户端或用途，例如 `Claude Code - laptop`、`CI` 或团队名。 |
| 过期时间 | 选择 Key 的有效期：`永不`、`7 天`、`30 天`、`90 天` 或 `自定义`。 |
| 过期于 | 选择 `自定义` 时出现，用于填写精确的过期日期和时间。 |
| API 密钥已创建 | 创建成功后的确认弹窗。这里会显示完整 Key。 |
| 请现在复制保存这个密钥，之后可能不会再次完整显示。 | 提醒你立即复制 Key。关闭弹窗后，CCR 不会再次展示完整 Key。 |

## 高级设置

`高级设置` 用于给单个客户端 Key 添加本地限额。限额命中后，使用这个 Key 的客户端请求会被拒绝或限制；它不会修改供应商侧额度。

| 字段 | 代表的能力 |
| --- | --- |
| 高级设置 | 展开或收起限额编辑区。 |
| 未配置限制 | 当前 Key 没有任何本地限额。 |
| 请求 | 按请求次数限制。 |
| 令牌 | 按 token 数量限制。 |
| 图片 | 按图片数量限制。 |
| 每分钟 | 限额窗口为 1 分钟。 |
| 每小时 | 限额窗口为 1 小时。 |
| 每天 | 限额窗口为 1 天。 |
| 添加限制 | 新增一条限额规则。 |
| 移除限制 | 删除当前限额规则。 |
