Schema dei file di input e output per il processo di registrazione del parlante

Schema del file di input

Di seguito è riportato lo schema del file manifesto di input per il processo di registrazione del parlante:

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

Nota

Tutti i campi dello schema sono obbligatori.

Di seguito è riportata una descrizione di ogni attributo dello schema di input.

• Version: versione del documento dello schema di input. Al momento, è 1.0.

• SpeakerEnrollmentRequests: elenco delle richieste di registrazione dei parlanti da gestire nell'ambito del processo.

  • RequestId: identificatore per la richiesta di registrazione del parlante. Il nome deve essere univoco all'interno del file di input. Viene usato per mappare e identificare le voci nel file di output.

  • SpeakerId: identificatore fornito dal cliente del parlante che deve essere registrato. In questo campo è necessario passare CustomerSpeakerId. Attualmente, GeneratedSpeakerId non è supportato.

  • AudioSpecifications: elenco dei file audio che Voice ID può usare per registrare il parlante. Voice ID usa questi file audio insieme per raccogliere la quantità di parlato necessaria per la registrazione. Attualmente, il numero massimo di file audio consentito per una richiesta di registrazione è 10. Ogni file può essere un file WAV con dimensioni fino a 20 MB, contenente audio con frequenza di campionamento a 8 KHz e codifica PCM-16.

    • S3URI: posizione in Amazon S3 del file audio in formato WAV da usare per registrare il parlante.

    • ChannelId: canale audio da usare per registrare il parlante in un file audio multicanale. Voice ID supporta i file audio con un massimo di due canali, quindi questo valore è limitato a 0 o 1.

Schema del file di output

Di seguito è riportato lo schema del file di output generato per il processo di registrazione del parlante:

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

Di seguito è riportata una descrizione di ogni attributo dello schema di output.

• Version: versione del documento dello schema di output. Al momento, è 1.0.

• Errors: elenco degli errori relativi alle richieste di registrazione del parlante che non sono andate a buon fine.

• • RequestId: identificatore associato alla richiesta. Corrisponde all'attributo RequestId specificato nel file di input per la richiesta.

  • ErrorCode: codice di errore HTTP che rappresenta il tipo di errore. Di seguito sono descritti alcuni scenari di errore di esempio.

    Nota

    Questo elenco non è esaustivo.

    • 400 (eccezione di richiesta non valida):

      • Il file JSON di input non è valido e non può essere analizzato.

      • I file audio forniti non contengono abbastanza parlato per la registrazione.

      • I controlli di verifica delle frodi non sono riusciti per il parlante specificato.

    • 402 (Eccezione) ServiceQuotaLimitExceeded:

      • Limite di parlanti superato.

    • 409 (eccezione di conflitto):

      • Azione in conflitto: non è possibile richiedere la registrazione di un parlante di cui è stato eseguito l'opt-out.

    • 500 (errore interno):

      • Errore interno del server (errore imprevisto sul lato del servizio).

  • ErrorMessage: messaggio che descrive la causa dell'errore di registrazione.

• SuccessfulEnrollments: elenco delle richieste di registrazione che hanno avuto esito positivo.

  • RequestId: identificatore associato alla richiesta. Corrisponde all'attributo RequestId specificato nel file di input per la richiesta.

  • CustomerSpeakerId: identificatore fornito dal cliente per il parlante che è stato registrato.

  • GeneratedSpeakerId: identificatore generato dal servizio per il parlante che è stato registrato.

  • EnrollmentStatus: stato dell'avvenuta registrazione del parlante.

    • DUPLICATE_SKIPPED: il parlante è già iscritto e la registrazione è stata ignorata.

    • NEW_ENROLLMENT: il parlante è stato appena registrato nel sistema.

    • ENROLLMENT_OVERWRITE: il parlante era già registrato, ma è stato nuovamente registrato/sovrascritto usando il nuovo audio.