CometAPI, hesap bakiyesini ve kullanımı kontrol etmek için iki yol sunar: CometAPI CLI ve query.cometapi.com adresindeki query service API.
Bakiyenizi terminalden kontrol etmenin en hızlı yolu. Kurulum için CometAPI CLI genel bakış sayfasına bakın.
Anahtar bazında ayrıntılar için --source token ekleyin:
cometapi balance --source token
Query service API
GET https://query.cometapi.com/user/quota
Hesap düzeyinde bakiye, kümülatif kullanım, toplam istek sayısı ve anahtar bazında kota ayrıntılarını döndürür. Bu endpoint, query.cometapi.com adresinde ayrı bir query service kullanır ve Bearer Token yerine key sorgu parametresi üzerinden kimlik doğrulaması yapar.
Bakiye sorguları için özel bir API anahtarı oluşturun ve kotasını 0 olarak ayarlayın (yalnızca sorgu izni). Anahtar sızdırılsa bile model istekleri için kullanılamaz.
İstek parametreleri
| Parameter | Type | Required | Description |
|---|
key | string | Yes | CometAPI API anahtarınız |
start_date | string | No | Günlük döküm için başlangıç tarihi (YYYY-MM-DD biçimi) |
end_date | string | No | Günlük döküm için bitiş tarihi (YYYY-MM-DD biçimi) |
start_date ve end_date sağlandığında, yanıt gün bazında ayrılmış anahtar bazında kullanımı içeren bir daily_quota alanı içerir.
Yanıt alanları
| Field | Type | Description |
|---|
username | string | Kullanıcı adı |
total_quota | number | Mevcut hesap bakiyesi (USD) |
total_used_quota | number | Kümülatif kullanım (USD) |
request_count | integer | Toplam istek sayısı |
keys | array | Anahtar bazında kota ayrıntıları |
keys[].name | string | API anahtarı adı |
keys[].remain_quota | number | Anahtarın kalan kotası; -1 sınırsız anlamına gelir |
keys[].used_quota | number | Anahtarın kullanılan kotası; -1 sınırsız anlamına gelir |
daily_quota | object | Günlük kullanım dökümü (start_date ve end_date ayarlandığında) |
daily_quota[date] | array | O tarih için anahtar bazında kullanım girdileri |
daily_quota[date][].token_name | string | API anahtarı adı |
daily_quota[date][].quota_used | number | O tarihte bu anahtar için kullanım (USD) |
daily_quota[date][].request_count | integer | O tarihte bu anahtar için istek sayısı |
Kod örnekleri
Hesap bakiyesini sorgulama:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"
Yanıt örneği
{
"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
}
]
}
Günlük döküm örneği
Bir tarih aralığı için günlük kullanımı sorgulama:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
daily_quota alanını da içerir:
{
"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
}
]
}
}
