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_quota | true이면 이 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 요청 로그에서 확인하세요.

