CometAPI menyediakan dua cara untuk memeriksa saldo akun dan penggunaan: CometAPI CLI dan query service API di query.cometapi.com.
Cara tercepat untuk memeriksa saldo Anda dari terminal. Lihat ikhtisar CometAPI CLI untuk instalasi.
Tambahkan --source token untuk detail per-key:
cometapi balance --source token
Query service API
GET https://query.cometapi.com/user/quota
Mengembalikan saldo tingkat akun, penggunaan kumulatif, jumlah total request, dan detail kuota per-key. Endpoint ini menggunakan query service terpisah di query.cometapi.com dan melakukan autentikasi melalui parameter kueri key, bukan Bearer Token.
Buat API key khusus untuk kueri saldo dan atur kuotanya ke 0 (izin hanya-kueri). Bahkan jika key tersebut bocor, key itu tidak dapat digunakan untuk request model.
Parameter request
| Parameter | Type | Required | Description |
|---|
key | string | Yes | API key CometAPI Anda |
start_date | string | No | Tanggal mulai untuk rincian harian (format YYYY-MM-DD) |
end_date | string | No | Tanggal akhir untuk rincian harian (format YYYY-MM-DD) |
start_date dan end_date diberikan, respons akan menyertakan field daily_quota dengan penggunaan per-key yang diuraikan per hari.
Field respons
| Field | Type | Description |
|---|
username | string | Nama pengguna |
total_quota | number | Saldo akun saat ini (USD) |
total_used_quota | number | Penggunaan kumulatif (USD) |
request_count | integer | Jumlah total request |
keys | array | Detail kuota per-key |
keys[].name | string | Nama API key |
keys[].remain_quota | number | Sisa kuota key; -1 berarti tidak terbatas |
keys[].used_quota | number | Kuota yang digunakan oleh key; -1 berarti tidak terbatas |
daily_quota | object | Rincian penggunaan harian (hanya saat start_date dan end_date diatur) |
daily_quota[date] | array | Entri penggunaan per-key untuk tanggal tersebut |
daily_quota[date][].token_name | string | Nama API key |
daily_quota[date][].quota_used | number | Penggunaan untuk key tersebut pada tanggal itu (USD) |
daily_quota[date][].request_count | integer | Jumlah request untuk key tersebut pada tanggal itu |
Contoh kode
Kueri saldo akun:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"
Contoh respons
{
"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
}
]
}
Contoh rincian harian
Kueri penggunaan harian untuk rentang tanggal:
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
}
]
}
}
