기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Connect Voice ID의 스피커 등록 작업에 대한 입력 및 출력 파일 스키마
**참고**
지원 종료 알림: 2026년 5월 20일에 Amazon Connect Voice ID에 대한 지원이 AWS 종료됩니다. 2026년 5월 20일 이후에는 Amazon Connect 콘솔에서 Voice ID에 액세스하거나, Amazon Connect 관리자 웹 사이트 또는 연락처 제어판에서 Voice ID 기능에 액세스하거나, Voice ID 리소스에 액세스할 수 없습니다. 자세한 내용은 [Amazon Connect Voice ID 지원 종료](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html) 섹션을 참조하세요.
## 입력 파일 스키마
다음은 화자 등록 작업을 위한 입력 매니페스트 파일의 스키마입니다.
```
{
"Version": "string",
"SpeakerEnrollmentRequests": [
{
"RequestId": "string",
"SpeakerId": "string",
"AudioSpecifications": [
{
"S3Uri": "string",
"ChannelId": number
}
]
}
]
}
```
**참고**
스키마의 모든 필드는 **필수**입니다.
다음은 입력 스키마의 각 속성에 대한 설명입니다.
+ `Version`: 입력 스키마 문서의 버전입니다. 현재는 `1.0`일 것입니다.
+ `SpeakerEnrollmentRequests`: 작업의 일환으로 처리해야 하는 화자 등록 요청 목록
+ `RequestId`: 이 화자 등록 요청의 식별자입니다. 입력 파일 내에서 고유해야 합니다. 출력 파일의 항목을 매핑하고 식별하는 데 사용됩니다.
+ `SpeakerId`: 등록이 필요한 화자에 대해 클라이언트가 제공한 식별자입니다. 이 필드에 `CustomerSpeakerId`를 전달해야 합니다. 현재 `GeneratedSpeakerId`는 지원되지 않습니다.
+ `AudioSpecifications`: Voice ID에서 이 화자를 등록하는 데 사용할 수 있는 오디오 파일 목록입니다. Voice ID는 이러한 오디오 파일을 함께 사용하여 등록에 필요한 분량의 발화를 수집합니다. 현재 등록 요청에 허용되는 최대 오디오 파일 수는 **10개**입니다. 각 파일은 8kHz 샘플 속도 및 PCM-16 인코딩을 사용하는 오디오가 포함된 최대 20MB의 .wav 파일일 수 있습니다.
+ `S3URI`: 화자 등록에 사용해야 하는 .wav 형식 오디오 파일의 Amazon S3 위치입니다.
+ `ChannelId`: 화자를 다중 채널 오디오 파일에 등록하는 데 사용되는 오디오 채널입니다. Voice ID는 채널이 최대 2개인 오디오 파일을 지원하므로 이 값은 **0** 또는 **1**로 제한됩니다.
## 출력 파일 스키마
다음은 화자 등록 작업을 위해 생성된 출력 파일의 스키마입니다.
```
{
"Version": "string",
"Errors": [
{
"RequestId": "string",
"ErrorCode": number,
"ErrorMessage": "string"
}
],
"SuccessfulEnrollments": [
{
"RequestId": "string",
"GeneratedSpeakerId": "string",
"CustomerSpeakerId": "string",
"EnrollmentStatus": "DUPLICATE_SKIPPED" | "NEW_ENROLLMENT" | "ENROLLMENT_OVERWRITE"
}
]
}
```
다음은 출력 스키마의 각 속성에 대한 설명입니다.
+ `Version`: 출력 스키마 문서의 버전입니다. 현재는 `1.0`일 것입니다.
+ `Errors`: 등록 중 실패한 화자 등록 요청의 오류 목록입니다.
+
+ `RequestId`: 이 요청과 관련된 요청 식별자입니다. 이 요청의 입력 파일에 지정된 `RequestId`와 동일합니다.
+ `ErrorCode`: 오류 유형을 나타내는 HTTP 오류 코드입니다. 몇 가지 예시 오류 시나리오가 아래에 설명되어 있습니다.
**참고**
이 목록은 전체 목록이 아닙니다.
+ 400(잘못된 요청 예외):
+ 입력 JSON 파일의 형식이 잘못되어 구문을 분석할 수 없습니다.
+ 제공된 오디오 파일에 있는 발화의 분량이 등록에 충분하지 않습니다.
+ 해당 화자에 대한 사기 확인 검사에 실패했습니다.
+ 402(ServiceQuotaLimitExceededException):
+ 화자 제한이 초과되었습니다.
+ 409(충돌 예외):
+ 상충되는 작업: 옵트아웃한 화자의 등록을 요청할 수 없습니다.
+ 500(내부 오류)
+ 내부 서버 오류(서비스 측에서 예상치 못한 오류 발생).
+ `ErrorMessage`: 등록 실패의 원인을 설명하는 메시지입니다.
+ `SuccessfulEnrollments`: 성공한 등록 요청 목록입니다.
+ `RequestId`: 이 요청과 관련된 요청 식별자입니다. 이 요청의 입력 파일에 지정된 `RequestId`와 동일합니다.
+ `CustomerSpeakerId`: 등록된 화자에 대해 클라이언트가 제공한 식별자입니다.
+ `GeneratedSpeakerId`: 등록된 화자에 대해 서비스가 생성한 식별자입니다.
+ `EnrollmentStatus`: 성공적인 화자 등록 상태입니다.
+ `DUPLICATE_SKIPPED`: 화자가 이미 등록되었으므로 등록을 건너뛰었습니다.
+ `NEW_ENROLLMENT`: 화자가 시스템에 새로 등록되었습니다.
+ `ENROLLMENT_OVERWRITE`: 화자가 이미 등록되었지만 새 오디오를 사용하여 재등록했습니다/덮어썼습니다.