Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Schéma des fichiers d'entrée et de sortie pour la tâche d'inscription des conférenciers dans Connect Customer Voice ID
<a name="speaker-enrollment-job-schema"></a>

**Note**  
Avis de fin de support : le 20 mai 2026, la prise en charge de Amazon Connect Customer Voice ID AWS prendra fin. Après le 20 mai 2026, vous ne pourrez plus accéder à Voice ID sur la Amazon Connect Customer console, accéder aux fonctionnalités Voice ID sur le site Web d' Connect Customer administration ou le Panneau de configuration des contacts, ni accéder aux ressources Voice ID. Pour plus d'informations, consultez la page de fin de support de [Amazon Connect Customer Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html). 

## Schéma de fichier d'entrée
<a name="speaker-enrollment-input-schema"></a>

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 du son avec une fréquence d'échantillonnage et un encodage de 8 kHz. 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
<a name="speaker-enrollment-output-schema"></a>

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 interne du serveur (erreur inattendue sur le Service-side).
  + `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`: L'orateur est déjà inscrit, mais il était en train de enrolled/overwritten réutiliser le nouveau son.