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à query service API tại query.cometapi.com.
Cách nhanh nhất để kiểm tra số dư từ terminal. Xem tổng quan về CometAPI CLI để biết cách cài đặt.
Thêm --source token để xem chi tiết theo từng key:
cometapi balance --source token
Query service API
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 query service riêng tại query.cometapi.com và xác thực qua query parameter key thay vì Bearer Token.
Tạo một API key riêng dành cho truy vấn số dư và đặt quota của nó thành 0 (quyền chỉ truy vấn). Ngay cả khi key bị lộ, nó cũng không thể được dùng cho các request model.
Request parameters
| Parameter | Type | Required | Description |
|---|
key | string | Yes | API key CometAPI của bạn |
start_date | string | No | Ngày bắt đầu cho thống kê theo ngày (định dạng YYYY-MM-DD) |
end_date | string | No | Ngày kết thúc cho thống kê theo ngày (định dạng YYYY-MM-DD) |
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.
Response fields
| 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 | Thống kê mức sử dụng theo ngày (chỉ có khi start_date và end_date được đặt) |
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 đó |
Code examples
Truy vấn số dư tài khoản:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"
Response example
{
"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ụ thống kê theo ngày
Truy vấn mức sử dụng hằng ngày cho một khoảng ngày:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
daily_quota:
{
"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
}
]
}
}
