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으로 설정하세요(조회 전용 권한). 키가 유출되더라도 모델 요청에는 사용할 수 없습니다.
요청 파라미터
| 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 필드가 추가됩니다.
응답 필드
| 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 | 해당 날짜에 해당 키의 요청 수 |
코드 예제
계정 잔액 조회:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"
응답 예시
{
"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
}
]
}
일별 내역 예시
날짜 범위의 일별 사용량 조회:
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
}
]
}
}
