# GenderAPI.io 요금 API 요금제와 크레딧

> 무료 계정으로 시작하고, 꾸준히 사용한다면 월간 크레딧을, 한 번만 결제하려면 크레딧 패키지를 선택하세요. V2 요청은 AI 설정에 따라 1크레딧 또는 2크레딧이 사용됩니다.

Canonical HTML: https://www.genderapi.io/ko/price

Last reviewed: 2026-09-30

## 무료 계정과 IP 체험

가입한 무료 계정은 API 키를 사용하며 매일 200크레딧을 받습니다. 1크레딧짜리 기본 요청을 최대 200건 보낼 수 있으며, 일부 AI 모드는 항목당 2크레딧이 사용됩니다.

V2의 IP 체험은 가입 없이 공개 IP 주소마다 24시간에 10크레딧을 제공합니다. API 키가 없거나, 형식이 잘못되었거나, 인식되지 않으면 IP 체험이 사용됩니다. 같은 공개 IP 주소를 쓰는 모든 사용자가 이 잔액을 공유하며, V1의 체험 사용량도 같은 잔액에서 차감됩니다. 인식된 키가 비활성화, 만료 또는 제한된 경우에는 IP 체험으로 전환되지 않습니다.

## 크레딧 패키지

가격은 HTML 페이지와 같은 카탈로그에서 가져옵니다. 구매하기 전에 요금 페이지에서 현재 조건과 총액을 확인하세요.

| 요금제 | 크레딧 | 월간 (EUR) | 일회성 결제 (EUR) |
| --- | --- | --- | --- |
| Tester | 5,000 | 6.69 | 8.39 |
| Mini | 25,000 | 15 | 19 |
| Start-Up | 50,000 | 25 | 30 |
| Basic | 100,000 | 40 | 50 |
| Basic+ | 200,000 | 50 | 60 |
| Pro | 500,000 | 75 | 90 |
| Advanced | 1,000,000 | 90 | 110 |
| Premium | 2,000,000 | 130 | 160 |
| Elite | 5,000,000 | 200 | 250 |
| Enterprise | 10,000,000 | 300 | 370 |
| Ultra | 20,000,000 | 450 | 560 |
| Ultimate | 50,000,000 | 900 | 1100 |

## V2의 크레딧 차감

크레딧은 HTTP 요청 횟수가 아니라 수행된 작업을 기준으로 차감됩니다. 아래 비용은 이름, 이메일 주소, 사용자 이름에 대한 V2 요청에 적용됩니다. V1과 V2는 기존 API 키와 같은 계정 잔액을 사용합니다.

예측이 없는 정상 처리 결과(gender: null)도 선택한 모드의 요금으로 과금됩니다. 과금 전에 발생한 입력 검증 오류에는 크레딧이 차감되지 않으며, 실패한 예측은 반환이 확인되면 과금되지 않습니다. 차감 여부가 확인되지 않았다면 billing_status를 확인하세요.

일괄 요청은 HTTP 요청 한 번이 아니라 정상 처리된 항목마다 과금됩니다. 일괄 요청의 항목은 기본적으로 데이터셋만 사용하므로, 필요하면 항목별로 fallback, always 또는 forceToGenderize를 지정하세요. 항목당 1크레딧인 기본 항목 50개가 정상 처리된 일괄 요청은 50크레딧입니다. 일괄 요청은 API 키를 사용하면 최대 50개 항목, IP 체험에서는 최대 10개 항목을 받습니다.

남은 잔액이 1크레딧 이상이면 단일 요청이나 일괄 요청을 시작할 수 있습니다. 그래도 전체 비용이 차감되므로 잔액이 마이너스가 될 수 있습니다. 예를 들어 잔액 1크레딧으로 2크레딧짜리 요청을 시작하면 잔액은 -1이 됩니다. 잔액이 0 이하이면 이후의 유료 작업이 차단됩니다.

다시 보낸 요청은 각각 별도의 작업으로 일반 요금이 적용됩니다. 결과나 차감 여부를 알 수 없는 요청은 자동으로 재시도하지 마세요.

| 작업 | 항목당 크레딧 | 설명 |
| --- | --- | --- |
| 데이터셋만 사용 | 1 | ai_mode: off를 사용하면 AI를 호출하지 않고 데이터셋만 조회합니다. |
| 자동 AI 폴백이 포함된 기본 요청 | 1 | ai_mode: fallback을 사용하면 먼저 데이터셋을 조회하고, 성별을 판단할 수 없을 때만 AI를 사용합니다. AI를 사용해도 총 1크레딧입니다. 단일 요청의 기본값입니다. |
| AI로 바로 보내는 요청 | 2 | ai_mode: always를 사용하면 데이터셋을 건너뛰고 요청을 AI로 바로 보냅니다. |
| 별명 분석: 데이터셋 결과 | 1 | forceToGenderize: true를 사용하면 먼저 데이터셋을 조회합니다. 데이터셋에서 성별을 판단한 결과는 1크레딧입니다. |
| 별명 분석: AI 결과 | 2 | forceToGenderize: true에서 데이터셋으로 성별을 판단할 수 없으면 AI가 실제 이름이 없는 경우에도 이름, 이메일 주소 또는 사용자 이름을 해석합니다. 총 2크레딧입니다. |
| 전화번호 검증 | 1 | 전화번호 한 건의 검증이 완료되면 결과가 valid: false여도 1크레딧입니다. |
| 잔액 확인 | 0 | GET /api/v2/usage는 크레딧을 사용하지 않지만 요청 한도에는 포함됩니다. |

## 요청 한도

V2는 모든 요금제에 요청 수와 동시 요청에 대한 한도를 적용합니다. 잔액과 요청 한도는 서로 별개입니다. HTTP 429를 처리하고, 다음 요청을 보내기 전에 Retry-After 헤더에 표시된 시간만큼 기다리세요. 현재 기본값과 응답 헤더는 V2 문서에 설명되어 있습니다.

- [V2 크레딧과 사용량 가이드](https://www.genderapi.io/ko/docs/v2/credits-and-usage)
- [V2 오류와 재시도 가이드](https://www.genderapi.io/ko/docs/v2/errors-and-retries)
- [V1 문서](https://www.genderapi.io/ko/api-documentation/v1)

## API 요청은 항상 정확히 1크레딧인가요?

아니요. V2의 기본 요청은 자동 AI 폴백을 포함해 1크레딧입니다. ai_mode: always는 2크레딧입니다. forceToGenderize는 데이터셋에서 결과를 얻으면 1크레딧, AI를 사용하면 2크레딧입니다. 일괄 요청은 정상 처리된 항목마다 과금되며, 정상 처리된 알 수 없는 결과도 과금됩니다.

## 무료 계정과 IP 체험은 어떻게 다른가요?

가입한 계정은 API 키를 사용하며 매일 200크레딧을 무료로 받습니다. V2의 IP 체험은 키가 필요 없으며 공개 IP 주소마다 24시간에 10크레딧을 제공합니다. 이 크레딧은 같은 IP 주소의 다른 사용자, 그리고 V1의 체험 사용량과 공유됩니다. 두 경우 모두 요청별 일반 요금이 적용됩니다.

## 유료 요금제에도 요청 한도가 적용되나요?

예. V2는 잔액과 관계없이 요청 수와 동시 요청에 한도를 적용합니다. 더 큰 크레딧 패키지를 구매해도 이 한도는 없어지지 않습니다. HTTP 429를 처리하고 Retry-After를 따르며, 현재 한도는 V2 문서에서 확인하세요.