Skip to main content
GET
현재 API 키(토큰)의 남은 잔액과 사용된 잔액을 조회합니다. 이 엔드포인트는 단일 토큰의 사용량을 모니터링하는 데 사용됩니다.

인증

string
필수
모든 API 엔드포인트에는 Bearer Token 인증이 필요합니다API 키 받기:API 키 관리 페이지에서 API 키를 받으세요요청 헤더에 추가:

엔드포인트

두 엔드포인트는 동일한 기능을 가지고 있습니다. 둘 중 하나를 사용할 수 있습니다.

응답

boolean
요청 성공 여부
string
오류 메시지 (실패 시에만 반환)
float
토큰 남은 잔액 (성공 시 반환). unlimited_quotatrue일 때 값은 -1입니다
integer
토큰 남은 크레딧 (성공 시 반환). unlimited_quotatrue일 때 값은 -1입니다
float
토큰 사용된 잔액 (성공 시 반환)
integer
토큰 사용된 크레딧 (성공 시 반환)
boolean
토큰이 무제한인지 여부. true는 무제한, false는 제한됨을 의미합니다

사용 사례

  • 단일 API 키의 소비 상황 모니터링
  • 애플리케이션에서 현재 토큰 잔액 표시
  • 잔액이 임계값 이하로 떨어지면 알림 설정
잔액 단위 정보잔액 값의 단위는 시스템 설정에 따라 다릅니다:
  • USD - 미국 달러
  • Credits - 크레딧
무제한 토큰토큰이 무제한으로 설정된 경우:
  • unlimited_quota 필드는 true를 반환합니다
  • remain_balance 필드는 -1을 반환합니다
  • remain_credits 필드는 -1을 반환합니다
  • 해당 토큰은 제한 없이 무제한으로 사용할 수 있습니다

일반적인 오류

보안 참고 사항API 키는 비밀번호와 같습니다. 안전하게 보관하고 다른 사람과 공유하지 마세요. 프로덕션에서는 항상 HTTPS를 사용하세요.