Esquema de arquivos de entrada e saída para o Speaker Enrollment Job no Amazon Connect Voice ID - Amazon Connect
Esquema de arquivos de entradaEsquema de arquivos de saída

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Esquema de arquivos de entrada e saída para o Speaker Enrollment Job no Amazon Connect Voice ID

Esquema de arquivos de entrada

Veja abaixo o esquema do arquivo de manifesto de entrada para o trabalho de inscrição de locutor:

{
  "Version": "string",
  "SpeakerEnrollmentRequests": [
      {
          "RequestId": "string",
          "SpeakerId": "string",
          "AudioSpecifications": [
              {
                  "S3Uri": "string",
                  "ChannelId": number 
              }
           ] 
      }
   ]
}
nota

Todos os campos no esquema são obrigatórios.

Veja a seguir uma descrição de cada atributo do esquema de entrada.

  • Version: a versão do documento do esquema de entrada. No momento, deve ser 1.0.

  • SpeakerEnrollmentRequests: lista de solicitações de inscrição de locutores a serem atendidas como parte do trabalho.

    • RequestId: um identificador para essa solicitação de inscrição de locutor. Ele deve ser exclusiva dentro do arquivo de entrada. É usado para mapear e identificar entradas no arquivo de saída.

    • SpeakerId: o identificador fornecido pelo cliente para o locutor que precisa ser inscrito. Você deve passar o CustomerSpeakerId nesse campo. Atualmente, o GeneratedSpeakerId não é compatível.

    • AudioSpecifications: a lista de arquivos de áudio que o Voice ID pode usar para inscrever esse locutor. O Voice ID usa esses arquivos de áudio juntos para coletar a quantidade necessária de fala para a inscrição. Atualmente, o número máximo de arquivos de áudio permitidos para uma solicitação de registro é dez. Cada arquivo pode ser um arquivo.wav de até 20 MB, contendo áudio com taxa de KHz amostragem 8 e PCM codificação -16.

      • S3URI: a localização no Amazon S3 do arquivo de áudio no formato.wav que precisa ser usado para inscrever o locutor.

      • ChannelId: o canal de áudio a ser usado para inscrever o locutor em um arquivo de áudio multicanal. O Voice ID comporta arquivos de áudio com até dois canais; portanto, esse valor é restrito a 0 ou 1.

Esquema de arquivos de saída

Veja abaixo o esquema do arquivo de saída para o trabalho de inscrição de locutor:

{
  "Version": "string",
  "Errors": [
       {
          "RequestId": "string",
          "ErrorCode": number,
          "ErrorMessage": "string"
       }
   ],
   "SuccessfulEnrollments": [
       {
          "RequestId": "string",
          "GeneratedSpeakerId": "string",
          "CustomerSpeakerId": "string",
          "EnrollmentStatus": "DUPLICATE_SKIPPED" | "NEW_ENROLLMENT" | "ENROLLMENT_OVERWRITE"
       }
   ]   
}

Veja a seguir uma descrição de cada atributo do esquema de entrada.

  • Version: a versão do documento do esquema de saída. No momento, deve ser 1.0.

  • Errors: a lista de erros nas solicitações de inscrição de locutores que apresentaram falha em algum momento durante a inscrição.

    • RequestId: o identificador da solicitação associado a essa solicitação. É o mesmo RequestId especificado no arquivo de entrada para essa solicitação.

    • ErrorCode: o código HTTP de erro que representa o tipo de erro. Alguns exemplos de cenários de erro são descritos abaixo.

      nota

      Esta não é uma lista completa.

      • 400 (exceção de solicitação inválida):

        • O JSON arquivo de entrada está malformado e não pode ser analisado.

        • Os arquivos de áudio fornecidos não têm voz suficiente para a inscrição.

        • As verificações de fraude falharam para o locutor em questão.

      • 402 (ServiceQuotaLimitExceededException):

        • Limite de locutores excedido.

      • 409 (exceção de conflito):

        • Ação conflitante: você não pode solicitar a inscrição de um locutor que optou por não participar.

      • 500 (erro interno):

        • Erro interno do servidor (erro inesperado do lado do serviço).

    • ErrorMessage: uma mensagem descrevendo a causa da falha na inscrição.

  • SuccessfulEnrollments: a lista de solicitações de inscrição que foram bem-sucedidas.

    • RequestId: o identificador da solicitação associado a essa solicitação. É o mesmo RequestId especificado no arquivo de entrada para essa solicitação.

    • CustomerSpeakerId: o identificador fornecido pelo cliente para o locutor que foi inscrito.

    • GeneratedSpeakerId: o identificador gerado pelo serviço para o locutor que foi inscrito.

    • EnrollmentStatus: o status da inscrição bem-sucedida de locutores.

      • DUPLICATE_SKIPPED: o locutor já está inscrito e a inscrição foi ignorada.

      • NEW_ENROLLMENT: o locutor foi recém-inscrito no sistema.

      • ENROLLMENT_OVERWRITE: o locutor já está inscrito, mas foi reinscrito/sobrescrito usando o novo áudio.