발언자 등록 Job 입력 및 출력 파일 스키마 - Amazon Connect

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

발언자 등록 Job 입력 및 출력 파일 스키마

입력 파일 스키마

다음은 스피커 등록 Job 대한 입력 매니페스트 파일의 스키마입니다.

{ "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.

출력 파일 스키마

다음은 발언자 등록 Job 대해 생성된 출력 파일의 스키마입니다.

{ "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: 스피커가 이미 등록되었지만 새 오디오를 사용하여 재등록/덮어쓰여졌습니다.