🔑 API 密钥

API 密钥是调用 API 的核心凭证，创建并管理每个密钥的额度、模型、分组和安全来源限制。

左侧导航点击「API 密钥」，或直接访问 /keys。页面清晰展示密钥名称、掩码密钥、启用状态、额度使用进度与绑定分组，并支持关键字搜索、复制、编辑、启停和批量管理。在行操作菜单中，还可直接复制连接配置，或一键将凭证发送至受支持的桌面聊天客户端中。

创建 API 密钥

配置选项	详细作用
名称	自定义名称，建议按使用场景或应用命名，便于账单区分与统计。
分组	指定该密钥访问的渠道分组（如默认组、高速组或特定订阅组）。
Auto 分组顺序	仅在分组选择 `auto` 时生效；可继承系统默认分流顺序，亦可自定义此密钥的专属优先级。
跨分组重试开关	开启后，当首选分组渠道遇故障或受限时，自动无缝跨组重试下一候选分组，保障调用高可用。
过期时间	设置密钥失效时间，到期后自动拒绝后续请求，留空为永不过期。
数量	支持一次性批量创建多个密钥（系统将自动附加随机后缀）。
额度	为此密钥分配独立的消耗上限，防止单一密钥过度消耗账户主余额。
无限额度开关	开启后不受独立额度限制（但仍受账户整体余额约束）。
模型限制	限定此密钥仅能调用指定模型白名单，防止误调用昂贵模型。
IP 白名单	逐行填写允许发起请求的 IPv4/IPv6 或 CIDR 网段，留空为不限制来源。

API 密钥等同于您的账户凭据。切勿将密钥明文提交到公共 GitHub 仓库、前端客户端代码或公共聊天工具中；若怀疑泄露，请立即删除并生成新密钥。

在 API 密钥列表中点击掩码密钥，按提示完成安全核验后即可复制完整密钥。

点击「复制连接信息」可一键将 Base URL 与 API Key 组合为标准客户端连接串；亦可点击目标聊天客户端图标，通过浏览器协议一键呼起本地客户端并自动填充配置。

在列表中找到目标密钥，点击「编辑」按钮，可随时调整其额度上限、模型白名单、过期时间或 IP 限制（修改配置不改变 API Key 本身）。