密钥、额度与用量

本文介绍 API 密钥的各项设置、LLM 账户额度的计算方式，以及如何通过日志和统计掌握用量。

额度的基本概念

账户额度：开通 LLM API 后，您拥有一个独立的 LLM 账户，调用模型产生的费用从这里扣除。它与主账户余额分开管理，可以通过"划转"或"兑换码"增加。账户概览 页面的"当前余额"显示剩余额度，"历史消耗"显示累计消耗。
金额显示：控制台中的额度统一折算为美元金额显示。在密钥设置里手动填写额度数值时，500000 额度单位 = $1。
计费方式：大多数模型按输入和输出 Token 分别计价；部分模型（标有 按次计费）按调用次数计价。具体价格见 LLM API → 模型列表，每个模型都显示了输入、输出价格（每 1K Token）以及对应的倍率。所选分组可能还有额外的价格倍率，在创建密钥时的分组选项中可以看到。

Note

每次请求会同时受到账户额度和密钥额度上限的约束，任何一个不足时请求都会失败。

打开 LLM API → 密钥管理（/llm/tokens）。列表中每个密钥显示以下信息：

在操作列中，可以用开关启用或禁用密钥，点击编辑图标修改设置，或点击删除图标删除密钥。删除后，使用该密钥的请求会立即失败。

字段	说明
名称	必填，建议按用途命名，例如"生产环境-客服机器人"。
分组	留空使用默认分组。下拉列表只显示您账户可用的分组，可能附带说明和价格倍率。选择智能熔断 (auto) 时，平台会自动选择可用分组。分组决定了该密钥能调用哪些模型以及价格倍率。
无限配额	打开后该密钥不设额度上限，只受账户额度约束。
配额限制	关闭无限配额时出现，填写该密钥最多可消耗的额度（500000 = $1）。用完后密钥状态变为"已耗尽"。
启用模型限制 / 可用模型	打开后，填写允许调用的模型名称，多个用英文逗号分隔，例如 `gpt-4o-mini,text-embedding-3-small`。不在列表中的模型会被拒绝。
IP 限制	每行填写一个允许的来源 IP，留空表示不限制。适合只从固定服务器调用的场景。
过期时间	留空表示永不过期。不能选择已经过去的时间。到期后密钥状态变为"已过期"。

Tip

编辑一个已禁用或已过期的密钥时，如果新的过期时间有效（或设置为永不过期），保存后密钥会自动重新启用。

打开 LLM API → 使用日志（/llm/logs），可以查看每一条调用和额度变动记录。

筛选：按时间范围、令牌（密钥）名称、模型名称和类型筛选。类型包括充值、消费、管理、系统、错误。
记录内容：时间、令牌、类型、模型、用时/首字时间、输入 Token、输出 Token、花费、来源 IP，以及详情。如果请求的模型被映射到其他实际模型，会同时显示"请求模型"和"实际模型"。
汇总：页面顶部显示当前条件下的总记录数、成功请求数、失败请求数等。

排查问题时，先按错误类型筛选，再查看详情中的错误信息。

LLM API → 使用统计（/llm/stats）按时间段汇总用量：

账户概览 页面也提供简要统计，包括请求次数、统计额度、统计 Tokens，以及按所选时间范围计算的平均 RPM（每分钟请求数）和平均 TPM（每分钟 Token 数）。