메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

CometAPI는 계정 잔액과 사용량을 확인하는 두 가지 방법을 제공합니다: CometAPI CLI와 query.cometapi.com의 query service API입니다.

​
CometAPI CLI

터미널에서 잔액을 확인하는 가장 빠른 방법입니다. 설치 방법은 CometAPI CLI 개요를 참고하세요. 
cometapi balance
키별 세부 정보를 보려면 --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

ParameterTypeRequiredDescription
keystringYesCometAPI API 키
start_datestringNo일별 내역 분해의 시작 날짜(YYYY-MM-DD 형식)
end_datestringNo일별 내역 분해의 종료 날짜(YYYY-MM-DD 형식)
start_date와 end_date가 제공되면 응답에 daily_quota 필드가 포함되며, 키별 사용량이 날짜별로 나뉘어 제공됩니다.

​
Response fields

FieldTypeDescription
usernamestring사용자 이름
total_quotanumber현재 계정 잔액(USD)
total_used_quotanumber누적 사용량(USD)
request_countinteger총 요청 수
keysarray키별 quota 세부 정보
keys[].namestringAPI 키 이름
keys[].remain_quotanumber키의 남은 quota, -1은 무제한을 의미
keys[].used_quotanumber키의 사용된 quota, -1은 무제한을 의미
daily_quotaobject일별 사용량 내역( start_date와 end_date가 설정된 경우에만)
daily_quota[date]array해당 날짜의 키별 사용량 항목
daily_quota[date][].token_namestringAPI 키 이름
daily_quota[date][].quota_usednumber해당 날짜에 해당 키가 사용한 사용량(USD)
daily_quota[date][].request_countinteger해당 날짜에 해당 키의 요청 수

​
Code examples

계정 잔액 조회: 
curl `https://query.cometapi.com/user/quota?key=${process.env.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
      }
    ]
  }
}