CometAPI는 계정 잔액과 사용량을 확인하는 두 가지 방법을 제공합니다: CometAPI CLI와 query.cometapi.com의 query service API입니다.
터미널에서 잔액을 확인하는 가장 빠른 방법입니다. 설치 방법은 CometAPI CLI 개요를 참고하세요.
키별 세부 정보를 보려면 --source token을 추가하세요:
cometapi balance --source token
Query service API
GET https://query.cometapi.com/user/quota
계정 수준의 잔액, 누적 사용량, 총 요청 수, 키별 quota 세부 정보를 반환합니다. 이 엔드포인트는 query.cometapi.com의 별도 query service를 사용하며, Bearer Token 대신 key 쿼리 파라미터를 통해 인증합니다.
잔액 조회 전용 API 키를 생성하고 해당 키의 quota를 0으로 설정하세요(query 전용 권한). 이 키가 유출되더라도 모델 요청에는 사용할 수 없습니다.
Request parameters
| Parameter | Type | Required | Description |
|---|
key | string | Yes | CometAPI API 키 |
start_date | string | No | 일별 내역 분해의 시작 날짜(YYYY-MM-DD 형식) |
end_date | string | No | 일별 내역 분해의 종료 날짜(YYYY-MM-DD 형식) |
start_date와 end_date가 제공되면 응답에 daily_quota 필드가 포함되며, 키별 사용량이 날짜별로 나뉘어 제공됩니다.
Response fields
| Field | Type | Description |
|---|
username | string | 사용자 이름 |
total_quota | number | 현재 계정 잔액(USD) |
total_used_quota | number | 누적 사용량(USD) |
request_count | integer | 총 요청 수 |
keys | array | 키별 quota 세부 정보 |
keys[].name | string | API 키 이름 |
keys[].remain_quota | number | 키의 남은 quota, -1은 무제한을 의미 |
keys[].used_quota | number | 키의 사용된 quota, -1은 무제한을 의미 |
daily_quota | object | 일별 사용량 내역( start_date와 end_date가 설정된 경우에만) |
daily_quota[date] | array | 해당 날짜의 키별 사용량 항목 |
daily_quota[date][].token_name | string | API 키 이름 |
daily_quota[date][].quota_used | number | 해당 날짜에 해당 키가 사용한 사용량(USD) |
daily_quota[date][].request_count | integer | 해당 날짜에 해당 키의 요청 수 |
Code examples
계정 잔액 조회:
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
}
]
}
Daily breakdown example
날짜 범위에 대한 일별 사용량 조회:
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
}
]
}
}
