CometAPI, hesap bakiyesini ve kullanımı kontrol etmek için iki yol sunar: CometAPI CLI ve query.cometapi.com adresindeki sorgu servisi API’si.
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
Sorgu servisi API’si
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 üzerinde ayrı bir sorgu servisi kullanır ve Bearer Token yerine key sorgu parametresi ile 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 tarihe ait 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 sorgulayın:
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ı sorgulayın:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
daily_quota alanını 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
}
]
}
}
