CometAPI では、アカウント残高と使用量を確認する方法として CometAPI CLI と query.cometapi.com の query service API の 2 つを提供しています。
ターミナルから残高を確認する最も速い方法です。インストールについては CometAPI CLI overview を参照してください。
キーごとの詳細を表示するには --source token を追加します。
cometapi balance --source token
Query service API
GET https://query.cometapi.com/user/quota
アカウントレベルの残高、累積使用量、総リクエスト数、キーごとの quota 詳細を返します。このエンドポイントは query.cometapi.com 上の別個の query service を使用し、Bearer Token ではなく key クエリパラメータで認証します。
残高照会専用の API key を生成し、その quota を 0（query 専用権限）に設定してください。仮にそのキーが漏洩しても、model リクエストには使用できません。
Request parameters
| 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 フィールドが含まれます。
Response fields
| Field | Type | Description |
|---|
username | string | ユーザー名 |
total_quota | number | 現在のアカウント残高（USD） |
total_used_quota | number | 累積使用量（USD） |
request_count | integer | 総リクエスト数 |
keys | array | キーごとの quota 詳細 |
keys[].name | string | API key 名 |
keys[].remain_quota | number | キーの残り quota。-1 は無制限を意味します |
keys[].used_quota | number | キーの使用済み quota。-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 | その日にそのキーで発生したリクエスト数 |
Code examples
アカウント残高を照会する場合:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"
Response example
{
"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
}
]
}
Daily breakdown example
日付範囲の日次使用量を照会する場合:
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
}
]
}
}
