Bakiye ve kullanımı sorgulama

CometAPI, hesap bakiyesi ve kullanımı kontrol etmek için iki yol sunar: CometAPI CLI ve query.cometapi.com adresindeki query service API. Bir Workspace kullanıyorsanız, paylaşılan Organization Credits ve faturalandırma rollerini anlamak için CometAPI Workspace ile ekip yönetimi sayfasına bakın.

CometAPI CLI

Bakiyenizi terminalden tek bir komutla kontrol edin. Kurulum için CometAPI CLI genel bakış sayfasına bakın.

cometapi balance

Anahtar başına ayrıntılar için --source token ekleyin:

cometapi balance --source token

Mevcut tüm seçenekler için komutlar referansı sayfasına bakın.

Query service API

GET https://query.cometapi.com/user/quota Hesap düzeyindeki bakiyeyi, kümülatif kullanımı, toplam istek sayısını ve anahtar bazlı 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 ile kimlik doğrulaması yapar.

Bakiye sorguları için özel bir API key kullanın. Erişimi sınırlamak istiyorsanız Unlimited Quota özelliğini devre dışı bırakın ve dashboard’un izin verdiği en düşük pozitif kredi limitini ayarlayın.

İstek parametreleri

Parameter	Type	Required	Description
`key`	string	Yes	CometAPI API key’iniz
`start_date`	string	No	Günlük kırılım için başlangıç tarihi (`YYYY-MM-DD` formatı)
`end_date`	string	No	Günlük kırılım için bitiş tarihi (`YYYY-MM-DD` formatı)

start_date ve end_date sağlandığında, yanıtta günlük bazda anahtar başına kullanımı içeren bir daily_quota alanı bulunur.

Yanıt alanları

Field	Type	Description
`username`	string	Kullanıcı adı
`total_quota`	number	Geçerli hesap bakiyesi (USD)
`total_used_quota`	number	Kümülatif kullanım (USD)
`request_count`	integer	Toplam istek sayısı
`keys`	array	Anahtar bazlı kota ayrıntıları
`keys[].name`	string	API key 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 kırılımı (`start_date` ve `end_date` ayarlandığında)
`daily_quota[date]`	array	O tarih için anahtar bazlı kullanım girişleri
`daily_quota[date][].token_name`	string	API key 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"

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}`);

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 kırılı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"

Yanıt, aynı üst düzey alanlara ek olarak 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
      }
    ]
  }
}

Buradan başlayın

Model API hızlı başlangıçları

Temel API kılavuzları

Kütüphaneler

Hatalar

Fiyatlandırma ve faturalandırma

Destek

CometAPI CLI

Query service API

İstek parametreleri

Yanıt alanları

Kod örnekleri

Yanıt örneği

Günlük kırılım örneği

​CometAPI CLI

​Query service API

​İstek parametreleri

​Yanıt alanları

​Kod örnekleri

​Yanıt örneği

​Günlük kırılım örneği

CometAPI CLI

Query service API

İstek parametreleri

Yanıt alanları

Kod örnekleri

Yanıt örneği

Günlük kırılım örneği