Skip to main content
GET
현재 사용자 계정의 남은 잔액과 사용된 잔액을 조회합니다. 이 엔드포인트는 특정 토큰에 의존하지 않는 사용자 수준의 잔액 정보를 반환하며, 전체 계정 잔액을 확인하는 데 사용됩니다.

인증

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

엔드포인트

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

응답

boolean
요청 성공 여부
string
오류 메시지 (실패 시에만 반환)
float
사용자 남은 잔액 (성공 시 반환)
integer
사용자 남은 크레딧 (성공 시 반환)
float
사용자 사용된 잔액 (성공 시 반환)
float
사용자 사용된 크레딧 (성공 시 반환)

토큰 잔액 vs 사용자 잔액

사용 사례

  • 사용자 계정의 전체 잔액 확인
  • 충전 알림 및 잔액 경고 설정
  • 사용자 대시보드에서 계정 잔액 표시
잔액 단위 정보잔액 값의 단위는 시스템 설정에 따라 다릅니다:
  • USD - 미국 달러
  • CNY - 중국 위안
  • Tokens - 토큰 수

일반적인 오류

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