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

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 để 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 để biết cách cài đặt.

cometapi balance

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

cometapi balance --source token

Xem tài liệu tham chiếu lệnh để 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.

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.

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:

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

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"

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:

{
  "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
      }
    ]
  }
}

Bắt đầu tại đây

Hướng dẫn nhanh về API mô hình

Hướng dẫn API cốt lõi

Thư viện

Lỗi

Giá cả và thanh toán

Hỗ trợ

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

CometAPI CLI

API dịch vụ truy vấn

Tham số request

Trường phản hồi

Ví dụ mã

Ví dụ phản hồi

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

​CometAPI CLI

​API dịch vụ truy vấn

​Tham số request

​Trường phản hồi

​Ví dụ mã

​Ví dụ phản hồi

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

CometAPI CLI

API dịch vụ truy vấn

Tham số request

Trường phản hồi

Ví dụ mã

Ví dụ phản hồi

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