> ## 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.

# Truy vấn số dư và mức sử dụng

> Sử dụng CometAPI CLI hoặc API dịch vụ truy vấn để lấy số dư tài khoản, mức sử dụng và chi tiết hạn mức theo từng key.

CometAPI cung cấp hai cách để kiểm tra số dư tài khoản và mức sử dụng: **CometAPI CLI** và **API dịch vụ truy vấn** tại `query.cometapi.com`.

Nếu bạn sử dụng Workspace, hãy xem [Quản lý một nhóm với CometAPI Workspace](/vi/workspace/overview) để tìm hiểu về Organization Credits dùng chung và các vai trò thanh toán.

***

## CometAPI CLI

Kiểm tra số dư của bạn từ terminal chỉ với một lệnh. Xem [tổng quan về CometAPI CLI](/vi/libraries/cli/overview) để biết cách cài đặt.

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

Thêm `--source token` để xem chi tiết theo từng key:

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

Xem [tài liệu tham chiếu lệnh](/vi/libraries/cli/commands) để biết tất cả các tùy chọn hiện có.

***

## API dịch vụ truy vấn

`GET https://query.cometapi.com/user/quota`

Trả về số dư cấp tài khoản, mức sử dụng tích lũy, tổng số lượng request và chi tiết quota theo từng key. Endpoint này sử dụng một dịch vụ truy vấn riêng tại `query.cometapi.com` và xác thực thông qua query parameter `key` thay vì Bearer Token.

<Tip>
  Sử dụng một API key chuyên dụng cho các truy vấn số dư. Nếu bạn muốn hạn chế mức độ lộ lọt, hãy tắt Unlimited Quota và đặt giới hạn credit dương nhỏ nhất mà dashboard cho phép.
</Tip>

### Tham số request

| Parameter    | Type   | Required | Description                                                         |
| ------------ | ------ | -------- | ------------------------------------------------------------------- |
| `key`        | string | Có       | API key CometAPI của bạn                                            |
| `start_date` | string | Không    | Ngày bắt đầu cho bảng phân tách theo ngày (định dạng `YYYY-MM-DD`)  |
| `end_date`   | string | Không    | Ngày kết thúc cho bảng phân tách theo ngày (định dạng `YYYY-MM-DD`) |

Khi cung cấp `start_date` và `end_date`, phản hồi sẽ bao gồm trường `daily_quota` với mức sử dụng theo từng key được phân tách theo ngày.

### Trường phản hồi

| Field                               | Type    | Description                                                                                 |
| ----------------------------------- | ------- | ------------------------------------------------------------------------------------------- |
| `username`                          | string  | Tên người dùng                                                                              |
| `total_quota`                       | number  | Số dư tài khoản hiện tại (USD)                                                              |
| `total_used_quota`                  | number  | Mức sử dụng tích lũy (USD)                                                                  |
| `request_count`                     | integer | Tổng số lượng request                                                                       |
| `keys`                              | array   | Chi tiết quota theo từng key                                                                |
| `keys[].name`                       | string  | Tên API key                                                                                 |
| `keys[].remain_quota`               | number  | Quota còn lại của key; `-1` nghĩa là không giới hạn                                         |
| `keys[].used_quota`                 | number  | Quota đã dùng của key; `-1` nghĩa là không giới hạn                                         |
| `daily_quota`                       | object  | Bảng phân tách mức sử dụng theo ngày (chỉ có khi `start_date` và `end_date` được thiết lập) |
| `daily_quota[date]`                 | array   | Các mục mức sử dụng theo từng key cho ngày đó                                               |
| `daily_quota[date][].token_name`    | string  | Tên API key                                                                                 |
| `daily_quota[date][].quota_used`    | number  | Mức sử dụng của key đó trong ngày đó (USD)                                                  |
| `daily_quota[date][].request_count` | integer | Số lượng request của key đó trong ngày đó                                                   |

### Ví dụ mã

Truy vấn số dư tài khoản:

<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>

### Ví dụ phản hồ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
    }
  ]
}
```

### Ví dụ phân tách theo ngày

Truy vấn mức sử dụng hằng ngày cho một khoảng ngày:

```bash theme={null}
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
```

Phản hồi bao gồm các trường cấp cao nhất giống như trên cộng thêm `daily_quota`:

```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
      }
    ]
  }
}
```