跳转到主要内容
CometAPI 提供两种方式来检查账户余额和用量：CometAPI CLI 和位于 query.cometapi.com 的 查询服务 API。

​
CometAPI CLI

从终端检查余额的最快方式。安装方法请参见 CometAPI CLI 概览。 
cometapi balance
添加 --source token 以查看每个密钥的详细信息： 
cometapi balance --source token
有关所有可用选项，请参见命令参考。

​
查询服务 API

GET https://query.cometapi.com/user/quota 返回账户级余额、累计用量、请求总数以及每个密钥的配额详情。此端点使用位于 query.cometapi.com 的独立查询服务，并通过 key 查询参数进行身份验证，而不是使用 Bearer Token。
为余额查询生成一个专用 API key，并将其配额设置为 0（仅查询权限）。即使该密钥泄露，也无法用于模型请求。

​
请求参数

ParameterTypeRequiredDescription
keystringYes你的 CometAPI API key
start_datestringNo每日明细的开始日期（YYYY-MM-DD 格式）
end_datestringNo每日明细的结束日期（YYYY-MM-DD 格式）
当提供 start_date 和 end_date 时，响应会包含 daily_quota 字段，其中按天拆分每个密钥的用量。

​
响应字段

FieldTypeDescription
usernamestring用户名
total_quotanumber当前账户余额（USD）
total_used_quotanumber累计用量（USD）
request_countinteger请求总数
keysarray每个密钥的配额详情
keys[].namestringAPI key 名称
keys[].remain_quotanumber密钥剩余配额；-1 表示无限制
keys[].used_quotanumber密钥已用配额；-1 表示无限制
daily_quotaobject每日用量明细（仅在设置 start_date 和 end_date 时返回）
daily_quota[date]array该日期下每个密钥的用量条目
daily_quota[date][].token_namestringAPI key 名称
daily_quota[date][].quota_usednumber该密钥在该日期的用量（USD）
daily_quota[date][].request_countinteger该密钥在该日期的请求数

​
代码示例

查询账户余额： 
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"

​
响应示例

{
  "username": "example_user",
  "total_quota": 2105.23,
  "total_used_quota": 21.07,
  "request_count": 1221,
  "keys": [
    {
      "name": "my-key",
      "remain_quota": 8.94,
      "used_quota": 2.10
    }
  ]
}

​
每日明细示例

查询某个日期范围内的每日用量： 
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
响应除了包含相同的顶层字段外，还会包含 daily_quota： 
{
  "username": "example_user",
  "total_quota": 2105.23,
  "total_used_quota": 21.07,
  "request_count": 1221,
  "daily_quota": {
    "2026-04-13T00:00:00Z": [
      {
        "token_name": "my-key",
        "quota_used": 4.27,
        "request_count": 59
      }
    ],
    "2026-04-14T00:00:00Z": [
      {
        "token_name": "my-key",
        "quota_used": 0.57,
        "request_count": 36
      }
    ]
  }
}