CometAPI 提供兩種方式來檢查帳戶餘額與用量：CometAPI CLI 以及位於 query.cometapi.com 的 查詢服務 API。
從終端機檢查餘額的最快方式。安裝方式請參閱 CometAPI CLI 概覽。
加入 --source token 以查看各金鑰詳細資訊：
cometapi balance --source token
查詢服務 API
GET https://query.cometapi.com/user/quota
回傳帳戶層級餘額、累計用量、總請求次數，以及各金鑰配額詳細資訊。此端點使用位於 query.cometapi.com 的獨立查詢服務，並透過 key 查詢參數進行驗證，而不是使用 Bearer Token。
請為餘額查詢產生專用的 API key，並將其配額設為 0（僅查詢權限）。即使金鑰外洩，也無法用於模型請求。
請求參數
| Parameter | Type | Required | Description |
|---|
key | string | Yes | 您的 CometAPI API key |
start_date | string | No | 每日明細的開始日期（YYYY-MM-DD 格式） |
end_date | string | No | 每日明細的結束日期（YYYY-MM-DD 格式） |
start_date 與 end_date 時，回應會包含 daily_quota 欄位，提供按日拆分的各金鑰用量。
回應欄位
| Field | Type | Description |
|---|
username | string | 使用者名稱 |
total_quota | number | 目前帳戶餘額（USD） |
total_used_quota | number | 累計用量（USD） |
request_count | integer | 總請求次數 |
keys | array | 各金鑰配額詳細資訊 |
keys[].name | string | API key 名稱 |
keys[].remain_quota | number | 金鑰剩餘配額；-1 表示無限制 |
keys[].used_quota | number | 金鑰已用配額；-1 表示無限制 |
daily_quota | object | 每日用量明細（僅在設定 start_date 與 end_date 時提供） |
daily_quota[date] | array | 該日期的各金鑰用量項目 |
daily_quota[date][].token_name | string | API key 名稱 |
daily_quota[date][].quota_used | number | 該金鑰在該日期的用量（USD） |
daily_quota[date][].request_count | integer | 該金鑰在該日期的請求次數 |
程式碼範例
查詢帳戶餘額：
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
}
]
}
}
