API 개요
Balance Query API는 총 쿼터, 사용한 쿼터, 남은 잔액, 요청 수를 포함하여 계정의 현재 쿼터 사용 현황을 가져옵니다. 이 API를 사용하면 계정 잔액을 쉽게 모니터링할 수 있어, 선제적이고 유연한 잔액 알림 관리가 가능합니다.인증 토큰을 받는 방법
1
콘솔 액세스
api.apiyi.com/account/profile를 방문하여 프로필 페이지에 액세스합니다2
시스템 토큰 찾기
페이지 하단의 “Account Options - System Token” 섹션을 찾습니다
3
액세스 토큰 생성
계정 비밀번호를 입력하면 이후 API 쿼리에 사용할 수 있는 액세스 토큰을 받을 수 있습니다

API 정보
요청 세부 정보
요청 헤더
요청 매개변수
이것은 GET 요청이며 요청 본문 매개변수는 필요하지 않습니다.
응답 세부정보
성공 응답 예시
주요 응답 필드
쿼터 변환
변환 규칙
500,000 quota = $1.00 USD
- USD 금액 = quota ÷ 500,000
- 남은 쿼터 = quota (quota는 현재 남은 잔액을 나타냄)
- 남은 USD = quota ÷ 500,000
quota: 24997909→ $49.99 USD (현재 남은 잔액)used_quota: 10027091→ $20.05 USD (사용한 금액)
오류 응답
HTTP 401 - 인증 실패
HTTP 403 - 권한 거부
코드 예제
cURL 예제
참고:
-s 옵션은 진행 표시줄을 숨기고, --compressed은 gzip 응답을 자동으로 압축 해제합니다Python 예제(기본)
Python 예제(최적화)
이 예제는 기본 예제에 다음 내용을 추가합니다:오류 처리
완전한 예외 처리와 오류 캡처
환경 변수
안전한 token 관리, 하드코딩 방지
서식 있는 출력
보기 좋은 표 표시와 숫자 서식 지정
자동 변환
자동 USD 금액 계산
quota.py로 저장하면 바로 실행할 수 있습니다:
자주 묻는 질문
잔액 조회는 쿼터를 소모합니까?
잔액 조회는 쿼터를 소모합니까?
아니요, 잔액 조회 API는 쿼터를 소모하지 않습니다.
잔액은 얼마나 자주 조회할 수 있습니까?
잔액은 얼마나 자주 조회할 수 있습니까?
요청 제한을 피하려면 조회 간격은 최소 1초로 권장합니다.
ModelFixedPrice 필드는 무엇을 위한 것입니까?
ModelFixedPrice 필드는 무엇을 위한 것입니까?
이 필드는 다양한 AI 모델의 요금 정보를 반환합니다. 잔액 정보만 필요하다면 무시하셔도 됩니다.
quota 필드는 무엇을 의미합니까?
quota 필드는 무엇을 의미합니까?
quota 필드는 현재 남은 잔액을 나타냅니다. quota가 0이거나 0에 가까우면 계정 잔액이 부족하여 충전이 필요합니다.curl이 깨진 텍스트를 반환하거나 jq가 오류를 보고하는 이유는 무엇입니까?
curl이 깨진 텍스트를 반환하거나 jq가 오류를 보고하는 이유는 무엇입니까?
문제: curl을 실행하면 깨진 텍스트가 반환되거나 jq가 “Invalid numeric literal”을 보고합니다원인: API가 gzip 압축 콘텐츠(
Content-Encoding: gzip)를 반환하며, curl은 이를 자동으로 압축 해제하지 않습니다.해결: curl이 자동으로 압축 해제하도록 --compressed 옵션을 추가합니다:중요 참고 사항
요청 제한
- 적절한 요청 timeout을 설정하십시오(권장: 10초)
- 지나치게 빈번한 쿼리 요청을 피하십시오
예외 처리 권장 사항
- 네트워크 예외, timeout, 인증 실패를 항상 처리하십시오
- 문제 해결을 쉽게 하기 위해 오류를 로그에 남기십시오
응답 형식 참고 사항
- API는 gzip으로 압축된 콘텐츠를 반환합니다. curl은
--compressed옵션이 필요합니다 - Python의 requests 라이브러리는 추가 설정 없이 gzip 압축 해제를 자동으로 처리합니다