跳轉到主要內容

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（僅查詢權限）。即使該金鑰外洩，也無法用於模型請求。

​
請求參數

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
      }
    ]
  }
}