跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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（仅查询权限）。即使该 key 泄露，也无法用于模型请求。

​
请求参数

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=${process.env.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
      }
    ]
  }
}