残高と利用状況を照会する

CometAPI では、アカウント残高と利用状況を確認する方法として、CometAPI CLI と query.cometapi.com の 照会サービス API の 2 つを提供しています。 Workspace を使用している場合は、CometAPI Workspace でチームを管理するを参照して、共有 Organization Credits と請求ロールについて確認してください。

CometAPI CLI

ターミナルから 1 つのコマンドで残高を確認できます。インストールについては、CometAPI CLI の概要を参照してください。

cometapi balance

キーごとの詳細を表示するには、--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 を使用してください。公開範囲を制限したい場合は、Unlimited Quota を無効にし、ダッシュボードで許可されている最小の正のクレジット上限を設定してください。

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"

import os
import requests

resp = requests.get(
    "https://query.cometapi.com/user/quota",
    params={"key": os.environ["COMETAPI_KEY"]}
)
data = resp.json()
print(f"Balance: ${data['total_quota']:.2f}")
print(f"Used: ${data['total_used_quota']:.2f}")
print(f"Requests: {data['request_count']}")

const resp = await fetch(
  `https://query.cometapi.com/user/quota?key=${process.env.COMETAPI_KEY}`
);
const data = await resp.json();
console.log(`Balance: $${data.total_quota.toFixed(2)}`);
console.log(`Used: $${data.total_used_quota.toFixed(2)}`);
console.log(`Requests: ${data.request_count}`);

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

ここから始める

モデルAPIクイックスタート

Core API ガイド

ライブラリ

エラー

料金と請求

サポート

CometAPI CLI

Query service API

Request parameters

Response fields

Code examples

Response example

Daily breakdown example

​CometAPI CLI

​Query service API

​Request parameters

​Response fields

​Code examples

​Response example

​Daily breakdown example

CometAPI CLI

Query service API

Request parameters

Response fields

Code examples

Response example

Daily breakdown example