콘텐츠로 이동
무료 가입
API 레퍼런스

API Key 할당량 조회

Bearer 인증으로 BetterToken API Key 하나의 사용한 할당량과 남은 할당량을 조회합니다. 반환된 통화와 환산 계수로 할당량 단위를 금액으로 변환하세요.

GET https://bettertoken.ai/api/usage/token/을 사용하면 BetterToken API Key 하나의 사용한 할당량과 남은 할당량을 조회할 수 있습니다.

요청 보내기

모델 호출에 사용하는 것과 동일한 sk-... BetterToken API Key를 사용하세요. 다음 명령을 실행하기 전에 로컬 환경 변수 BETTERTOKEN_API_KEY에 설정하세요.

Authorization: Bearer <API_KEY>로 인증합니다. 요청에는 매개변수나 본문이 없습니다. URL 끝의 슬래시를 유지하세요. 전체 URL에는 /v1이 포함되지 않습니다.

터미널 창
curl -sS 'https://bettertoken.ai/api/usage/token/' \
-H "Authorization: Bearer ${BETTERTOKEN_API_KEY}"

성공 응답

code: true는 조회 성공을 의미합니다. 다음은 응답의 일부이며, 수치는 설명을 위한 예시입니다.

{
"code": true,
"message": "ok",
"data": {
"object": "token_usage",
"name": "example-key",
"total_granted": 1000000,
"total_used": 250000,
"total_available": 750000,
"unlimited_quota": false,
"quota_currency": "USD"
}
}

할당량 읽기

필드의미
data.total_available이 Key의 남은 할당량입니다. 내부 할당량 단위로 반환됩니다.
data.total_used이 Key의 누적 사용 할당량입니다. 동일한 단위입니다.
data.total_granted사용한 할당량과 남은 할당량의 합입니다. 동일한 단위입니다.
data.quota_currency할당량의 통화입니다. 예: USD.
data.unlimited_quotatrue이면 이 Key에는 별도의 할당량 한도가 없습니다. 지출은 여전히 지갑 잔액의 제한을 받습니다.

금액으로 환산하기

GET https://bettertoken.ai/api/status 응답에서 data.quota_per_unit을 확인하세요. 할당량을 이 계수로 나누면 data.quota_currency 통화의 금액을 구할 수 있습니다.

남은 금액 = data.total_available / data.quota_per_unit

예를 들어 계수가 500000이면 위 예시의 금액은 750000 / 500000 = 1.50 USD입니다. 사용한 할당량도 같은 방법으로 환산합니다.

계정의 지갑 잔액은 BetterToken Workspace에서 확인하세요. 이 API는 요청 인증에 사용한 API Key의 할당량만 반환합니다.

이 Key의 최근 요청은 API Key 요청 로그에서 확인하세요.