API 密钥
创建密钥，限制每个密钥能花多少钱、能调用什么，并在不停机的情况下轮换或吊销密钥。
API 密钥用于认证你的请求，并从你的账户余额中扣费。你可以创建任意多个密钥，并为每个密钥设置各自的限制。所有密钥共享同一个余额。
创建密钥#
打开 API 密钥页面
进入控制台的 API 密钥页面，点击 新建密钥。
为密钥命名并选择渠道分组
按密钥的使用场景命名，例如
checkout-prod或eval-runner。除非你需要这个密钥的所有请求都在某个特定分组中运行，否则 渠道分组 保持 自动 — 最优可用 即可。参阅渠道分组。设置限制（可选）
展开 额度与限制，可以限制消费、频率、并发、模型或有效期。每个选项的说明见下文，所有选项之后都可以修改。
复制密钥
点击 创建。完整密钥只会在页面顶部的横幅中显示一次。复制它，或点击 接入客户端…，用它配置 Claude Code、Codex CLI 等客户端。点击 完成 后，只会显示密钥的前几个字符，例如
lr-a1b2c3…。
密钥只显示一次
Lovely Router 只保存每个密钥的哈希。如果密钥丢失，请吊销它并创建一个新的。
密钥选项#
| 选项 | 默认值 | 作用 |
|---|---|---|
| 名称 | — | 显示在密钥列表和日志中的标签。最多 60 个字符。 |
| 渠道分组 | 自动 | 让这个密钥的所有请求都在同一个渠道分组中运行。自动 会为每个请求选择最优的可用分组。只能在创建时设置。 |
| 消费上限（美元） | 不限 | 该密钥累计最多可花费的金额，以整美元计，涵盖模型请求、工具运行和浏览器运行。这是终身上限，而不是每月预算。 |
| 过期日期 | 永不 | 这一天结束后（按你浏览器的时区）密钥失效。 |
| 每分钟请求数 | 不限 | 该密钥每分钟最多可发起的模型请求数。 |
| 最大并发请求数 | 不限 | 该密钥同时最多可进行的模型请求数。长时间的流式请求在结束前一直计入。 |
| 仅允许指定模型 | 全部模型 | 该密钥可调用的模型白名单。claude-sonnet-5-5 这类别名按其解析到的模型计算。 |
密钥列表会显示每个密钥的分组、限制、累计 已消费 金额和 最近使用 时间。
触发限制时会怎样#
被拒绝的请求不计费，也不会出现在日志中。响应体使用你所调用 API 的格式。
| 情况 | 状态码 | Anthropic type | OpenAI type | 消息 |
|---|---|---|---|---|
| 密钥已过期 | 401 | authentication_error | authentication_error | This API key has expired |
| 密钥已吊销 | 401 | authentication_error | authentication_error | Invalid or revoked API key |
| 模型不在白名单中 | 403 | permission_error | permission_denied | This API key is not allowed to use 'gpt-6.1-sol'. |
| 达到消费上限 | 402 | billing_error | insufficient_quota | This API key has reached its spend limit. |
| 达到每分钟请求数或并发上限 | 429 | rate_limit_error | rate_limit_exceeded | This API key has reached its rate or concurrency limit. |
Gemini 格式的请求会得到相同的状态码，错误格式为 Gemini 的格式。因密钥限制返回的 429 带有 Retry-After 请求头，给出需要等待的秒数。下面是两种格式的消费上限错误。其他所有响应体和重试建议见错误。
{
"type": "error",
"error": {
"type": "billing_error",
"message": "This API key has reached its spend limit."
}
}哪些限制适用于工具和浏览器运行#
| 限制 | 模型请求 | 数据工具与浏览器智能体 |
|---|---|---|
| 过期与吊销 | 是 | 是 |
| 消费上限 | 是 | 是 |
| 每分钟请求数 | 是 | 否 |
| 最大并发请求数 | 是 | 否 |
| 模型白名单 | 是 | 否 |
消费上限在每个请求开始前检查。已经在进行中的模型请求总会完成，所以密钥的累计消费最终可能略高于上限。工具运行或浏览器运行会预先预留它的最高费用，因此如果这个最高费用会让密钥超出上限，运行会被拒绝并返回 402。
编辑密钥#
点击密钥上的 编辑，可以修改名称、消费上限、过期日期、频率和并发限制，或模型白名单。更改从下一个请求开始生效。清空某个字段即可取消对应的限制。
要把密钥换到另一个渠道分组，请在该分组中创建一个新密钥，然后轮换过去。
吊销密钥#
点击 吊销，再点击 确认吊销。密钥从下一个请求起失效，吊销无法撤销。已吊销的密钥仍会以灰色显示在列表中，保留其消费记录，它的请求也仍保留在日志中。
轮换密钥#
不停机地替换密钥：
- 创建一个分组和限制都相同的新密钥。
- 把新密钥部署到你的应用或密钥管理服务中。
- 等到旧密钥的 最近使用 时间不再变化。
- 吊销旧密钥。
定期轮换；有权限的人员离开后轮换；密钥可能泄露时立即轮换。
在你的工具中使用密钥#
点击任意密钥上的 接入客户端，即可获得 Claude Code、Codex CLI、Gemini CLI、Cherry Studio、DeepChat 和 AionUI 的现成配置，应用支持时还可一键导入。参阅在你的工具中使用。
最佳实践#
- 每个应用和环境一个密钥。 为生产、预发、CI 和你的笔记本分别使用不同的密钥，每个密钥的消费一目了然，吊销其中一个也不会影响其他密钥。
- 为无人值守运行的密钥设置上限。 智能体、批处理任务和 CI 流水线都可能陷入循环。消费上限能限制损失，每分钟请求数限制能让失控的循环慢下来。
- 只允许密钥需要的模型。 用于摘要任务的密钥不需要最贵的模型。
- 让临时密钥自动过期。 给演示、外包人员和评估用的密钥设置过期日期，而不是靠记性去吊销。
- 把密钥留在服务端。 永远不要把密钥放进前端或移动端代码。参阅保护好你的密钥。