メインコンテンツへスキップ

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 では、アカウント残高と使用量を確認する方法が 2 つあります。CometAPI CLI と、query.cometapi.com にある query service API です。

​
CometAPI CLI

ターミナルから残高を確認する最も速い方法です。インストールについては CometAPI CLI overview を参照してください。 
cometapi balance
キーごとの詳細を表示するには --source token を追加します。 
cometapi balance --source token
利用可能なすべてのオプションについては、commands reference を参照してください。

​
Query service API

GET https://query.cometapi.com/user/quota アカウント全体の残高、累積使用量、総リクエスト数、およびキーごとのクォータ詳細を返します。このエンドポイントは query.cometapi.com 上の別個の query service を使用し、Bearer Token ではなく key クエリパラメータで認証します。
残高照会専用の API key を生成し、そのクォータを 0（照会専用権限）に設定してください。万が一そのキーが漏洩しても、model リクエストには使用できません。

​
Request parameters

ParameterTypeRequiredDescription
keystringYesあなたの CometAPI API key
start_datestringNo日別内訳の開始日（YYYY-MM-DD 形式）
end_datestringNo日別内訳の終了日（YYYY-MM-DD 形式）
start_date と end_date の両方を指定すると、レスポンスには日ごとのキー別使用量を含む daily_quota フィールドが追加されます。

​
Response fields

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その日におけるそのキーのリクエスト数

​
Code examples

アカウント残高を照会するには: 
curl `https://query.cometapi.com/user/quota?key=${process.env.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
      }
    ]
  }
}