# GenderAPI v1에서 v2로 마이그레이션

> 동일한 API 키와 밸런스를 사용하여 GenderAPI 통합을 v1에서 v2로 이동합니다. 요청 필드, 일괄 경로, 응답, 오류 및 재시도 동작을 매핑합니다.

Canonical HTML: https://www.genderapi.io/ko/docs/v2/migration

Last reviewed: 2026-09-25

## v1에서 v2로 통합 이동

V1은 계속 사용 가능합니다. 준비가 되면 동일한 키 및 크레딧 잔액을 사용하여 개별 통합을 마이그레이션하세요. V2는 요청과 응답 계약이 다르기 때문에 URL만 변경하는 것만으로는 충분하지 않습니다.

| V1 컨셉 | V2 상당 |
| --- | --- |
| 별도의 이름, 이메일 및 사용자 이름 엔드포인트 | POST /api/v2/gender(type 및 value 포함) |
| 여러 엔드포인트 분리 | POST /api/v2/gender/batch 및 items |
| askToAI | options.ai_mode: fallback; 단일 요청은 이미 기본적으로 fallback로 설정되어 있습니다. |
| forceToGenderize | 세 가지 유형 모두에 대해 동일한 선택 필드입니다. 데이터 세트를 먼저 사용한 다음 닉네임을 인식하는 AI |
| 평탄한 응답 필드 | 결과는 data입니다. 액세스 및 청구용 meta |
| probability 백분율 | 0-1 스케일의 confidence와 confidence_kind; AI 점수는 보정된 확률이 아닙니다. |
| total_names | data.sample_count, null 가능 |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| 레거시 오류 형식 | HTTP 상태 + Problem Details code 및 action |
| POST 재시도 | 각 재시도는 일반 청구를 통한 새로운 작업입니다. |

- [v1 참조 읽기](https://www.genderapi.io/ko/api-documentation/v1)
- [v2 OpenAPI 계약 사용](https://api.genderapi.io/api/v2/openapi.json)

## 클라이언트 업데이트 및 확인

마이그레이션하려는 통합에 대해 v2 요청 및 응답 계약을 사용하세요. meta.access.mode를 확인하고, JSON null 결과를 보존하고, 항목별 배치 오류를 검사하고, 재시도하기 전에 청구를 확인하세요. 클라이언트가 업데이트될 때까지 기존 경로에서 v1 통합을 유지합니다.

- [인증부터 시작하세요](https://www.genderapi.io/ko/docs/v2/authentication)
- [v2 응답 읽기](https://www.genderapi.io/ko/docs/v2/responses)
- [재시도 처리](https://www.genderapi.io/ko/docs/v2/errors-and-retries)