> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bakiye ve kullanımı sorgulama

> Hesap bakiyesi, kullanım ve anahtar başına kota ayrıntılarını almak için CometAPI CLI veya query service API'yi kullanın.

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](/tr/workspace/overview) sayfasına bakın.

***

## CometAPI CLI

Bakiyenizi terminalden tek bir komutla kontrol edin. Kurulum için [CometAPI CLI genel bakış](/tr/libraries/cli/overview) sayfasına bakın.

```bash theme={null}
cometapi balance
```

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

```bash theme={null}
cometapi balance --source token
```

Mevcut tüm seçenekler için [komutlar referansı](/tr/libraries/cli/commands) 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.

<Tip>
  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.
</Tip>

### İ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:

<CodeGroup>
  ```bash curl theme={null}
  curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"
  ```

  ```python Python theme={null}
  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']}")
  ```

  ```javascript Node.js theme={null}
  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}`);
  ```
</CodeGroup>

### Yanıt örneği

```json theme={null}
{
  "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:

```bash theme={null}
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:

```json theme={null}
{
  "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
      }
    ]
  }
}
```