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.

# DescribeVoices
<a name="API_DescribeVoices"></a>

Renvoie la liste des voix pouvant être utilisées lorsque vous demandez la synthèse vocale. Chaque voix parle une langue spécifiée, qu'elle soit masculine ou féminine, et est identifiée par un identifiant, qui est la version ASCII du nom de la voix. 

Lors de la synthèse vocale (`SynthesizeSpeech`), vous fournissez l'identifiant vocal de la voix souhaitée dans la liste des voix renvoyées par`DescribeVoices`.

Par exemple, vous souhaitez que votre application de lecture d'actualités lise les actualités dans une langue spécifique, tout en laissant à l'utilisateur la possibilité de choisir la voix. À l'aide de cette `DescribeVoices` opération, vous pouvez fournir à l'utilisateur une liste de voix disponibles parmi lesquelles sélectionner.

 Si vous le souhaitez, vous pouvez spécifier un code de langue pour filtrer les voix disponibles. Par exemple, si vous le spécifiez`en-US`, l'opération renvoie une liste de toutes les voix disponibles en anglais américain. 

Cette opération exige des autorisations pour exécuter l'action `polly:DescribeVoices`.

## Syntaxe de la demande
<a name="API_DescribeVoices_RequestSyntax"></a>

```
GET /v1/voices?Engine={{Engine}}&IncludeAdditionalLanguageCodes={{IncludeAdditionalLanguageCodes}}&LanguageCode={{LanguageCode}}&NextToken={{NextToken}} HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DescribeVoices_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [Engine](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-Engine"></a>
Spécifie le moteur (`standard`,`neural`, `long-form` ou`generative`) utilisé par Amazon Polly lors du traitement du texte d'entrée pour la synthèse vocale.   
Valeurs valides : `standard | neural | long-form | generative` 

 ** [IncludeAdditionalLanguageCodes](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-IncludeAdditionalLanguageCodes"></a>
Valeur booléenne indiquant s'il faut renvoyer des voix bilingues utilisant la langue spécifiée comme langue supplémentaire. Par exemple, si vous demandez toutes les langues utilisant l'anglais américain (es-US) et qu'une voix italienne parle à la fois l'italien (it-it) et l'anglais américain, cette voix sera incluse si vous le spécifiez `yes` mais pas si vous le spécifiez. `no`

 ** [LanguageCode](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-LanguageCode"></a>
 La balise d'identification de langue (code ISO 639 pour le nom de langue, code de pays ISO 3166) permettant de filtrer la liste des voix renvoyées. Si vous ne spécifiez pas ce paramètre facultatif, toutes les voix disponibles sont renvoyées.   
Valeurs valides : `arb | cmn-CN | cy-GB | da-DK | de-DE | en-AU | en-GB | en-GB-WLS | en-IN | en-US | es-ES | es-MX | es-US | fr-CA | fr-FR | is-IS | it-IT | ja-JP | hi-IN | ko-KR | nb-NO | nl-NL | pl-PL | pt-BR | pt-PT | ro-RO | ru-RU | sv-SE | tr-TR | en-NZ | en-ZA | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE | cs-CZ | de-CH | en-SG` 

 ** [NextToken](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-NextToken"></a>
Un jeton de pagination opaque renvoyé par l'`DescribeVoices`opération précédente. Le cas échéant, cela indique où continuer la liste.  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 4096.

## Corps de la requête
<a name="API_DescribeVoices_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DescribeVoices_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Voices": [ 
      { 
         "AdditionalLanguageCodes": [ "string" ],
         "Gender": "string",
         "Id": "string",
         "LanguageCode": "string",
         "LanguageName": "string",
         "Name": "string",
         "SupportedEngines": [ "string" ]
      }
   ]
}
```

## Eléments de réponse
<a name="API_DescribeVoices_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [NextToken](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-NextToken"></a>
Le jeton de pagination à utiliser dans la prochaine demande pour continuer la liste des voix. `NextToken`n'est renvoyé que si la réponse est tronquée.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 4096.

 ** [Voices](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-Voices"></a>
Liste des voix avec leurs propriétés.  
Type : tableau d’objets [Voice](API_Voice.md)

## Erreurs
<a name="API_DescribeVoices_Errors"></a>

 ** InvalidNextTokenException **   
Le NextToken n'est pas valide. Vérifiez qu'il est correctement orthographié, puis réessayez.  
Code d’état HTTP : 400

 ** ServiceFailureException **   
Une situation inconnue a provoqué une panne de service.  
Code d’état HTTP : 500

## Voir aussi
<a name="API_DescribeVoices_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK pour C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DescribeVoices)