사용량 및 할당량

GenderAPI 플랫폼은 전용 엔드포인트를 통해 현재 계정의 크레딧 잔액을 언제든지 확인할 수 있도록 지원합니다. 이를 통해 대량 작업 수행 시 사용량을 모니터링하고 예기치 않은 중단을 방지할 수 있습니다.

✅ 남은 크레딧 확인

다음 엔드포인트를 사용하여 현재 할당량 정보를 가져올 수 있습니다: 

GET https://api.genderapi.io/api/remaining?key=YOUR_API_KEY

curl을 사용한 요청 예시:

curl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"

✅ 응답 예시

API는 다음과 같은 JSON 객체를 반환합니다:

{
  "status": true,
  "remaining": 9443,
  "expiresAt": 1752651601
}

응답 필드

필드 타입 설명
status Boolean 요청이 성공했는지를 나타냅니다. API 키가 유효한 경우 true를 반환합니다.
remaining Integer 계정에 남아 있는 API 크레딧 수입니다.
expiresAt Integer (타임스탬프) 현재 크레딧 패키지의 만료 시간을 나타내는 유닉스 타임스탬프입니다.

활용 사례

  • 대시보드 UI에 현재 할당량 정보를 표시합니다.
  • 크레딧이 특정 임계값 아래로 떨어지면 경고를 트리거합니다.
  • 청구 또는 모니터링 도구와 통합하여 서비스 중단을 방지합니다.
중요: 남은 크레딧을 항상 확인하여 크레딧 부족으로 인한 예기치 않은 오류를 방지하세요. 대량 작업 또는 자동화된 스크립트는 주기적으로 할당량을 확인해야 합니다.