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 lũy kế, tổng số lượng request và chi tiết hạn mức 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 tham số truy vấn key thay vì Bearer Token.
Tạo một API key chuyên dụng cho việc truy vấn số dư và đặt hạn mức của nó là 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.
Tham số request
| Parameter | Type | Required | Description |
|---|
key | string | Yes | API key CometAPI của bạn |
start_date | string | No | Ngày bắt đầu cho phần phân tách theo ngày (định dạng YYYY-MM-DD) |
end_date | string | No | Ngày kết thúc cho phần phân tách 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.
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 lũy kế (USD) |
request_count | integer | Tổng số lượng request |
keys | array | Chi tiết hạn mức theo từng key |
keys[].name | string | Tên API key |
keys[].remain_quota | number | Hạn mức còn lại của key; -1 nghĩa là không giới hạn |
keys[].used_quota | number | Hạn mức đã dùng của key; -1 nghĩa là không giới hạn |
daily_quota | object | Phân tách mức sử dụng theo ngày (chỉ 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:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"
Ví dụ phản hồ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
}
]
}
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:
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
}
]
}
}
