메인 콘텐츠로 건너뛰기
GET
잔액 조회

엔드포인트 정보

이 엔드포인트에는 요청 매개변수가 없습니다. 요청마다 인증 헤더를 포함하세요.

1. 인증

HTTP 헤더에 Bearer 자격 증명을 포함하세요. 다음 두 가지 중 하나를 사용하세요.
자격 증명이 누락되었거나 유효하지 않거나 삭제 또는 비활성화된 경우, 또는 계정이 비활성화된 경우 인증에 실패합니다.

2. 공통 응답 구조

애플리케이션 상태 코드

요청 성공 여부는 응답 본문의 code로 확인하세요.

금액 형식

  • 모든 금액은 미국 달러(USD) 기준이며 부동소수점 정밀도 손실을 방지하기 위해 문자열로 반환됩니다.
  • 잔액 관련 금액은 항상 소수점 이하 네 자리로 표시됩니다. 예를 들어 "986.9275"입니다.
  • 모델 단가는 소수점 이하 자릿수를 0으로 채우지 않습니다. 예를 들어 "40", "2.5", "0.00075"입니다.

3. 잔액 조회

응답 구조는 자격 증명에 따라 달라집니다. data.type으로 구분할 수 있습니다.

3.1 시스템 액세스 토큰으로 계정 잔액 조회 (type = account)

기업 하위 계정은 해당 계정의 잔액만 조회할 수 있습니다.

3.2 API 키로 해당 키의 한도 조회 (type = token)

unlimited = true인 키에는 키 단위 한도가 없으므로 balance가 음수일 수 있습니다. 키 사용량은 usedAmount로 확인하고, 실제 사용 가능 금액은 계정 잔액을 기준으로 판단하세요.

4. 요청 예시


5. 참고 사항

  1. 갱신 주기. 잔액 데이터는 약 1분 이내에 갱신됩니다. 충전이나 사용 내역이 반영되기까지 시간이 걸릴 수 있습니다.
  2. 최종 청구 금액. 이 엔드포인트는 조회 및 추정용입니다. 최종 청구 금액은 청구서를 확인하세요.
  3. 자격 증명 보호. 시스템 액세스 토큰으로 계정 전체 정보를 조회할 수 있으므로 외부에 공개하지 마세요. 특정 키의 한도만 조회하려면 해당 API 키를 사용하세요.