# GenderAPI로 Excel 및 CSV 파일에서 성별 확인하기

> 스프레드시트를 업로드하고 제안된 열을 확인한 뒤 이름, 이메일 주소 또는 사용자 이름 분석을 선택하세요. 결과를 CSV로 내보내고 지원 형식, 데이터 처리 방식과 작업 제한을 확인하세요.

Canonical HTML: https://www.genderapi.io/ko/blog/determining-gender-of-names-in-excel-csv-with-gender-api

Last reviewed: 2026-09-30

## 계정 대시보드에서 파일 작업 실행하기

GenderAPI 파일 도구는 스프레드시트를 읽고 이름, 이메일 주소 또는 사용자 이름 열을 매핑할 수 있게 한 뒤, 보강된 CSV 내보내기 파일을 준비합니다. API 연동을 직접 구축할 필요가 없을 때 파일 기반 작업에 사용하세요.

대시보드의 파일 워크플로는 REST V2 일괄 요청과 별개입니다. 파일 자체는 V2 JSON 요청이 아니며, V2의 항목별 제한과 응답 경로를 이 기본 제공 작업에 적용해서는 안 됩니다.

- [Excel/CSV 도구 열기](https://app.genderapi.io/csv)

## 업로드 컨트롤이 허용하는 형식 사용하기

현재 업로드 컨트롤은 한 번에 1개 파일을 선택합니다. 시트가 여러 개인 통합 문서는 올바른 시트를 선택하고 읽어 들인 값을 확인하세요. 업로드 컨트롤이 파일 형식을 허용하지 않으면 시작하기 전에 목록에 있는 형식 중 하나로 파일을 내보내세요.

파일의 복잡도, 행 수, 선택한 방식, 계정 크레딧과 서비스 부하가 처리에 영향을 줍니다. 대표적인 파일로 테스트하세요. 이 가이드는 고정된 최대 크기나 고정된 처리 시간을 약속하지 않습니다.

| 형식 | 허용되는 확장자 |
| --- | --- |
| CSV | `.csv` |
| Excel | `.xls, .xlsx` |
| Apple Numbers | `.numbers` |
| OpenDocument | `.ods` |
| 탭으로 구분된 값 | `.tsv` |
| 텍스트 | `.txt` |

## 작업을 시작하기 전에 제안 확인하기

- 작업에 필요한 데이터를 담은 사본을 만드세요. 입력은 이름이 명확하게 붙은 열에 두고, 신뢰할 수 있는 2자리 국가 코드가 있다면 별도의 열에 두세요.
- 로그인한 뒤 Excel/CSV 도구를 열고 올바른 키를 선택한 다음 파일과 시트를 선택하세요.
- 시트를 설정하는 동안 도구가 AI 지원 열 제안을 위해 샘플 셀을 보낼 수 있습니다. 계속하기 전에 제안된 입력 유형과 열을 직접 확인하세요.
- 이름, 이메일 주소 또는 사용자 이름 분석을 선택하고 원본 열과 선택 사항인 국가 매핑을 확인한 뒤, 도구에 표시되는 현재 AI 및 내보내기 옵션을 검토하세요.
- 처리를 시작하고 진행 상황을 지켜보세요. 작업이 아직 끝나지 않았다는 이유만으로 같은 파일을 여러 번 제출하지 마세요.
- 내보내기가 준비되면 CSV 파일을 다운로드하고 행이 원본과 일치하는지 확인한 뒤 identified 결과, 알 수 없는 결과, 실패한 레코드를 검토하세요. 비교를 위해 원본 파일을 보관하세요.

## 파일 작업 설정 확인하기

| 설정 | 유형 | 설명 |
| --- | --- | --- |
| API 키 | 계정 인증 정보 | 선택한 작업에서 잔액이 사용될 계정입니다. |
| 파일과 시트 | 파일 선택 | 허용되는 파일 하나와 올바른 시트를 선택하세요. |
| 방식 | 선택 항목 | name, email 또는 username입니다. 자동으로 제안된 값을 확인하세요. |
| 원본 열 | 열 매핑 | 각 행에서 분석할 입력입니다. 헤더와 샘플 값을 확인하세요. |
| 국가 컨텍스트 | 선택 사항인 열 또는 설정 | 해당되는 경우 알려진 2자리 국가 코드를 사용하세요. |
| AI 및 내보내기 옵션 | 도구의 현재 컨트롤 | 처리 전에 표시된 설정을 확인하세요. 이는 V2의 ai_mode 매개변수가 아닙니다. |

## 부가기능 결과 열 읽기

내보낸 CSV 파일에는 기본 제공 결과 필드인 gender, country, probability, found_name이 추가됩니다. 다른 시스템으로 가져오기 전에 행이 원본과 일치하는지, 열 헤더가 올바른지 확인하세요. 입력이 Excel 통합 문서였더라도 출력 형식은 CSV입니다.

추정 결과는 추론된 연관성입니다. 본인이 밝힌 성별 및 확인된 국가 정보와 분리해 두세요.

- 전체 데이터셋을 처리하기 전에 일반적인 결과, 모호한 입력, 실패한 작업을 각각 확인하세요.
- 빈 셀, null이라는 텍스트, 수식 오류는 스프레드시트에서 서로 다른 값입니다. 오류를 숨기지 않도록 unknown 결과를 의도적으로 정규화하세요.
- 알 수 없거나 불확실한 레코드에는 중립적인 대체 처리를 사용하세요. 본인이 제공한 프로필 정보는 추정된 열과 구분해 보관하세요.

| 결과 | 일반적인 유형 | 사용 방법 |
| --- | --- | --- |
| Gender | 텍스트 또는 미확정 값 | 성공한 결과에서만 male 또는 female을 유지하세요. 미확정 값은 unknown으로 보존하고, 오류 텍스트는 따로 검토하세요. |
| Probability | 숫자(제공되는 경우) | 이전 방식의 신뢰도 신호입니다. V2의 confidence 필드도 아니고, 사용자의 데이터셋에서 측정한 정확도도 아닙니다. |
| Country | 텍스트(제공되는 경우) | 조회 결과로 반환된 컨텍스트입니다. 고객의 확인된 국가와 구분해 보관하세요. |
| Found / normalized name | 텍스트(제공되는 경우) | 처리 중에 사용되었거나 추출된 이름입니다. 모호한 이메일 주소와 사용자 이름에서는 이 값을 검토하세요. |

- [신뢰도와 한계를 해석하는 방법](https://www.genderapi.io/ko/accuracy-methodology)

## 크레딧, 한도, 반복 실행 계획하기

등록된 무료 GenderAPI 계정에는 하루 200크레딧이 포함됩니다. 크레딧은 계정 잔액이며, 모든 워크플로에서 200개의 성공한 결과를 보장한다는 뜻이 아닙니다. 시작하기 전에 선택한 키의 잔액과 도구의 현재 처리 옵션을 확인하세요.

내장 부가기능과 파일 작업에는 각각 고유한 처리 경로가 있습니다. REST API V2의 일괄 요청 한도, AI 옵션, 요청별 과금 필드가 이들에 자동으로 적용되지는 않습니다. 다시 실행하거나 재계산하면 새 작업이 제출될 수 있으므로 무료라고 가정하지 마세요.

작은 표본으로 시작하고, 완료된 결과를 보관하고, 다시 실행하기 전에 실패한 행을 검토하세요. 나중에 내보내기나 대상 앱 업데이트만 바로잡으면 되는 경우에는 이미 얻은 결과를 재사용하세요.

- [계정 요금제와 크레딧](https://www.genderapi.io/ko/price)

## 설정 단계의 분석과 파일 보관 고려하기

시트를 선택하면 최종 처리 단계 전에 AI 지원 열 매핑을 위해 샘플 셀이 전송될 수 있습니다. Start 버튼을 누르기 전까지 모든 데이터가 로컬에 머문다고 가정하지 마세요. 불필요한 열을 제거하고, 개인정보가 포함된 파일을 선택하기 전에 개인정보 처리방침을 확인하세요.

내보낸 뒤 작업 공간의 사본이 더 이상 필요하지 않으면 제공되는 삭제 기능을 사용하세요. 공개된 방침은 운영 시스템에서의 예정된 삭제와 백업 보관을 설명합니다. 삭제 일정이 있다고 해서 모든 사본이 이미 삭제되었다는 증거가 되지는 않습니다.

- [파일 및 조회 보관 정책](https://www.genderapi.io/ko/privacy-policy)

## API V2를 직접 사용해야 하는 경우

애플리케이션에 명시적인 AI 옵션과 V2의 항목별 status, source, confidence_kind, usage 정보가 필요하다면 별도의 HTTP 연동을 사용하세요. V2의 요청 및 응답 규격을 따르세요. 내장 수식이나 기존 부가기능에 V2 필드 이름을 추가해도 해당 클라이언트의 동작은 바뀌지 않습니다.

- [V2 요청 매개변수](https://www.genderapi.io/ko/docs/v2/request-parameters)
- [V2 응답 필드](https://www.genderapi.io/ko/docs/v2/responses)
- [Python V2 연동](https://www.genderapi.io/ko/integrations/python)
- [Node.js V2 연동](https://www.genderapi.io/ko/integrations/javascript)

## 업로드에서 XLSM 파일을 사용할 수 있나요?

현재 업로드 컨트롤에는 CSV, XLS, XLSX, Numbers, ODS, TSV, TXT가 표시됩니다. XLSM 통합 문서는 이 형식 중 하나로 내보내고, 업로드하기 전에 변환된 값을 확인하세요.

## 열 제안은 항상 정확한가요?

아니요. 제안된 입력 유형, 헤더 행 처리, 원본 열과 국가 매핑을 확인하세요. 설정 중에 AI 지원 제안을 위해 샘플 데이터가 전송될 수 있습니다.

## 원래의 Excel 통합 문서를 다시 받을 수 있나요?

문서화된 파일 작업은 결과를 CSV로 내보냅니다. 원래 통합 문서나 다른 도구로 가져오기 전에 내보낸 열과 행 일치 여부를 확인하세요.

## V2 일괄 요청과 같은 것인가요?

아니요. 자체 옵션과 처리 방식을 갖춘 대시보드 파일 작업입니다. 사용자 지정 연동에서 JSON 요청을 구성할 때는 V2 일괄 요청 문서를 참고하세요.

## 출처와 문서

- [Microsoft AppSource의 부가기능 공식 페이지](https://app.genderapi.io/csv)
- [V2 일괄 요청 문서](https://www.genderapi.io/ko/docs/v2/batch)
- [GenderAPI 요금제와 크레딧](https://www.genderapi.io/ko/price)
- [GenderAPI 개인정보 처리방침](https://www.genderapi.io/ko/privacy-policy)
- [V2 요청 규격](https://www.genderapi.io/ko/docs/v2/request-parameters)