Schéma de fichier d'entrée et de sortie pour la tâche d'inscription de locuteur

Schéma de fichier d'entrée

Voici le schéma du fichier manifeste d'entrée pour la tâche d'inscription de locuteur :

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

Note

Tous les champs du schéma sont obligatoires.

Vous trouverez ci-dessous une description de chaque attribut du schéma d'entrée.

• Version : version de document du schéma d'entrée. Actuellement, il s'agit normalement de la version 1.0.

• SpeakerEnrollmentRequests : liste des demandes d'inscription de locuteur à traiter dans la tâche.

  • RequestId : identifiant pour cette demande d'inscription de locuteur. Il doit être unique dans le fichier d'entrée. Il sert à mapper et identifier les entrées dans le fichier de sortie.

  • SpeakerId : identifiant fourni par le client du locuteur qui doit être inscrit. Vous devez passer le CustomerSpeakerId dans ce champ. Le GeneratedSpeakerId n'est actuellement pas pris en charge.

  • AudioSpecifications : liste des fichiers audio que Voice ID peut utiliser pour inscrire ce locuteur. Voice ID utilise ces fichiers audio conjointement pour recueillir le temps de parole nécessaire pour l'inscription. Actuellement, le nombre maximal de fichiers audio autorisé pour une demande d'inscription est de 10. Chaque fichier peut être un fichier .wav d'une taille maximale de 20 Mo, contenant un enregistrement audio avec un taux d'échantillonnage de 8 kHz et un encodage PCM-16.

    • S3URI: emplacement Amazon S3 du fichier audio au format .wav qui doit être utilisé pour inscrire le locuteur.

    • ChannelId : canal audio à utiliser pour inscrire le locuteur contenu dans un fichier audio multicanal. Voice ID prend en charge les fichiers audio à deux canaux, au maximum. Cette valeur est donc limitée à 0 ou à 1.

Schéma de fichier de sortie

Voici le schéma du fichier de sortie généré pour la tâche d'inscription de locuteur :

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

Vous trouverez ci-dessous une description de chaque attribut du schéma de sortie.

• Version : version de document du schéma de sortie. Actuellement, il s'agit normalement de la version 1.0.

• Errors : liste d'erreurs relatives aux demandes d'inscription de locuteur qui ont échoué à un moment donné au cours de l'inscription.

• • RequestId : identifiant de demande associé à cette demande. Il correspond au RequestId spécifié dans le fichier d'entrée de cette demande.

  • ErrorCode : code d'erreur HTTP représentant le type d'erreur. Des exemples de scénarios d'erreur sont décrits ci-dessous.

    Note

    Cette liste n'est pas exhaustive.

    • 400 (exception de demande incorrecte) :

      • Le fichier JSON d'entrée est mal formé et ne peut pas être analysé.

      • Les fichiers audio fournis n'ont pas un temps de parole suffisant pour permettre l'inscription.

      • Les contrôles de vérification antifraude ont échoué pour le locuteur concerné.

    • 402 (ServiceQuotaLimitExceededException) :

      • Limite dépassée pour le locuteur.

    • 409 (exception de conflit) :

      • Action contradictoire : vous ne pouvez pas demander à inscrire un locuteur qui est désinscrit.

    • 500 (échec interne) :

      • Erreur de serveur interne (erreur inattendue côté service).

  • ErrorMessage : message décrivant la cause de l'échec d'inscription.

• SuccessfulEnrollments : liste des demandes d'inscription ayant abouti.

  • RequestId : identifiant de demande associé à cette demande. Il correspond au RequestId spécifié dans le fichier d'entrée de cette demande.

  • CustomerSpeakerId : identifiant fourni par le client pour le locuteur qui a été inscrit.

  • GeneratedSpeakerId : identifiant généré par le service pour le locuteur qui a été inscrit.

  • EnrollmentStatus : statut d'inscription réussie pour le locuteur.

    • DUPLICATE_SKIPPED : le locuteur étant déjà inscrit, l'inscription a été ignorée.

    • NEW_ENROLLMENT : le locuteur a été dernièrement inscrit dans le système.

    • ENROLLMENT_OVERWRITE : le locuteur est déjà inscrit, mais il a été réinscrit/remplacé avec un nouvel enregistrement audio.