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.

# Référence de l'API Amazon Polly
<a name="API_Reference"></a>

Amazon Polly est un service Web qui permet de synthétiser facilement la parole à partir de texte.

Le service Amazon Polly fournit des opérations d'API pour synthétiser du discours de haute qualité à partir de texte brut et du langage de balisage de synthèse vocale (SSML), ainsi que pour gérer les lexiques de prononciations qui vous permettent d'obtenir les meilleurs résultats pour votre domaine d'application.

Les appels d'API authentifiés doivent être signés à l'aide du processus de signature « Signature Version 4 ». Pour plus d'informations, consultez [la section Signature des demandes d' AWS API](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) dans le *Référence générale d'Amazon Web Services*.

**Topics**
+ [

# Actions
](API_Operations.md)
+ [

# Types de données
](API_Types.md)
+ [

# Erreurs courantes
](CommonErrors.md)
+ [

# Paramètres communs
](CommonParameters.md)

# Actions
<a name="API_Operations"></a>

Les actions suivantes sont prises en charge :
+  [DeleteLexicon](API_DeleteLexicon.md) 
+  [DescribeVoices](API_DescribeVoices.md) 
+  [GetLexicon](API_GetLexicon.md) 
+  [GetSpeechSynthesisTask](API_GetSpeechSynthesisTask.md) 
+  [ListLexicons](API_ListLexicons.md) 
+  [ListSpeechSynthesisTasks](API_ListSpeechSynthesisTasks.md) 
+  [PutLexicon](API_PutLexicon.md) 
+  [StartSpeechSynthesisStream](API_StartSpeechSynthesisStream.md) 
+  [StartSpeechSynthesisTask](API_StartSpeechSynthesisTask.md) 
+  [SynthesizeSpeech](API_SynthesizeSpeech.md) 

# DeleteLexicon
<a name="API_DeleteLexicon"></a>

Supprime le lexique de prononciation spécifié stocké dans un fichier. Région AWS Un lexique qui a été supprimé n'est pas disponible pour la synthèse vocale et il n'est pas possible de le récupérer à l'aide du `GetLexicon` ou `ListLexicon` APIs.

Pour plus d'informations, consultez la section [Gestion des lexiques](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

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

```
DELETE /v1/lexicons/LexiconName HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [LexiconName](#API_DeleteLexicon_RequestSyntax) **   <a name="polly-DeleteLexicon-request-uri-Name"></a>
Nom du lexique à supprimer. Il doit s'agir d'un lexique existant dans la région.  
Modèle : `[0-9A-Za-z]{1,20}`   
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteLexicon_RequestBody"></a>

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

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

```
HTTP/1.1 200
```

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

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

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

 ** LexiconNotFoundException **   
Amazon Polly ne trouve pas le lexique spécifié. Cela peut être dû à un lexique manquant, à une faute d'orthographe de son nom ou à la spécification d'un lexique situé dans une autre région.  
Vérifiez que le lexique existe, qu'il se trouve dans la région (voir[ListLexicons](API_ListLexicons.md)) et que vous avez orthographié son nom correctement. Ensuite, réessayez.  
Code d’état HTTP :404

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

## Voir aussi
<a name="API_DeleteLexicon_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/DeleteLexicon) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DeleteLexicon) 

# 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\$1\$1](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) 

# GetLexicon
<a name="API_GetLexicon"></a>

Renvoie le contenu du lexique de prononciation spécifié stocké dans un Région AWS fichier. Pour plus d'informations, consultez la section [Gestion des lexiques](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

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

```
GET /v1/lexicons/LexiconName HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [LexiconName](#API_GetLexicon_RequestSyntax) **   <a name="polly-GetLexicon-request-uri-Name"></a>
Nom du lexique.  
Modèle : `[0-9A-Za-z]{1,20}`   
Obligatoire : oui

## Corps de la demande
<a name="API_GetLexicon_RequestBody"></a>

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

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

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

{
   "Lexicon": { 
      "Content": "string",
      "Name": "string"
   },
   "LexiconAttributes": { 
      "Alphabet": "string",
      "LanguageCode": "string",
      "LastModified": number,
      "LexemesCount": number,
      "LexiconArn": "string",
      "Size": number
   }
}
```

## Eléments de réponse
<a name="API_GetLexicon_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.

 ** [Lexicon](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-Lexicon"></a>
Objet Lexicon qui fournit le nom et le contenu de la chaîne du lexique.   
Type : objet [Lexicon](API_Lexicon.md)

 ** [LexiconAttributes](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-LexiconAttributes"></a>
Les métadonnées du lexique, y compris l'alphabet phonétique utilisé, le code de langue, l'ARN du lexique, le nombre de lexèmes définis dans le lexique et la taille du lexique en octets.  
Type : objet [LexiconAttributes](API_LexiconAttributes.md)

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

 ** LexiconNotFoundException **   
Amazon Polly ne trouve pas le lexique spécifié. Cela peut être dû à un lexique manquant, à une faute d'orthographe de son nom ou à la spécification d'un lexique situé dans une autre région.  
Vérifiez que le lexique existe, qu'il se trouve dans la région (voir[ListLexicons](API_ListLexicons.md)) et que vous avez orthographié son nom correctement. Ensuite, réessayez.  
Code d’état HTTP :404

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

## Voir aussi
<a name="API_GetLexicon_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/GetLexicon) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetLexicon) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetLexicon) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetLexicon) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetLexicon) 

# GetSpeechSynthesisTask
<a name="API_GetSpeechSynthesisTask"></a>

Récupère un SpeechSynthesisTask objet spécifique en fonction de son TaskID. Cet objet contient des informations sur la tâche de synthèse vocale donnée, notamment le statut de la tâche, et un lien vers le compartiment S3 contenant le résultat de la tâche.

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

```
GET /v1/synthesisTasks/TaskId HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [TaskId](#API_GetSpeechSynthesisTask_RequestSyntax) **   <a name="polly-GetSpeechSynthesisTask-request-uri-TaskId"></a>
Identifiant généré par Amazon Polly pour une tâche de synthèse vocale.  
Modèle : `^[a-zA-Z0-9_-]{1,100}$`   
Obligatoire : oui

## Corps de la demande
<a name="API_GetSpeechSynthesisTask_RequestBody"></a>

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

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

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

{
   "SynthesisTask": { 
      "CreationTime": number,
      "Engine": "string",
      "LanguageCode": "string",
      "LexiconNames": [ "string" ],
      "OutputFormat": "string",
      "OutputUri": "string",
      "RequestCharacters": number,
      "SampleRate": "string",
      "SnsTopicArn": "string",
      "SpeechMarkTypes": [ "string" ],
      "TaskId": "string",
      "TaskStatus": "string",
      "TaskStatusReason": "string",
      "TextType": "string",
      "VoiceId": "string"
   }
}
```

## Eléments de réponse
<a name="API_GetSpeechSynthesisTask_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.

 ** [SynthesisTask](#API_GetSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-GetSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask objet qui fournit des informations relatives à la tâche demandée, notamment le format de sortie, l'heure de création, le statut de la tâche, etc.  
Type : objet [SynthesisTask](API_SynthesisTask.md)

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

 ** InvalidTaskIdException **   
L'ID de tâche fourni n'est pas valide. Entrez un ID de tâche valide et réessayez.  
Code d’état HTTP : 400

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

 ** SynthesisTaskNotFoundException **   
La tâche de synthèse vocale avec l'ID de tâche demandé est introuvable.  
Code d’état HTTP : 400

## Voir aussi
<a name="API_GetSpeechSynthesisTask_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/GetSpeechSynthesisTask) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetSpeechSynthesisTask) 

# ListLexicons
<a name="API_ListLexicons"></a>

Renvoie une liste de lexiques de prononciation stockés dans un Région AWS fichier. Pour plus d'informations, consultez la section [Gestion des lexiques](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

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

```
GET /v1/lexicons?NextToken=NextToken HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

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

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

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

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

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

{
   "Lexicons": [ 
      { 
         "Attributes": { 
            "Alphabet": "string",
            "LanguageCode": "string",
            "LastModified": number,
            "LexemesCount": number,
            "LexiconArn": "string",
            "Size": number
         },
         "Name": "string"
      }
   ],
   "NextToken": "string"
}
```

## Eléments de réponse
<a name="API_ListLexicons_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.

 ** [Lexicons](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-Lexicons"></a>
Liste des noms et des attributs des lexiques.  
Type : tableau d’objets [LexiconDescription](API_LexiconDescription.md)

 ** [NextToken](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-NextToken"></a>
Le jeton de pagination à utiliser dans la prochaine demande pour continuer à répertorier les lexiques. `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.

## Erreurs
<a name="API_ListLexicons_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_ListLexicons_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/ListLexicons) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListLexicons) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListLexicons) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListLexicons) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListLexicons) 

# ListSpeechSynthesisTasks
<a name="API_ListSpeechSynthesisTasks"></a>

Renvoie une liste d' SpeechSynthesisTask objets classés par date de création. Cette opération permet de filtrer les tâches en fonction de leur statut, par exemple en permettant aux utilisateurs de répertorier uniquement les tâches terminées.

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

```
GET /v1/synthesisTasks?MaxResults=MaxResults&NextToken=NextToken&Status=Status HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [MaxResults](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-MaxResults"></a>
Nombre maximal de tâches de synthèse vocale renvoyées lors d'une opération de liste.  
Plage valide : valeur minimum de 1. Valeur maximale fixée à 100.

 ** [NextToken](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-NextToken"></a>
Le jeton de pagination à utiliser dans la prochaine demande pour continuer à répertorier les tâches de synthèse vocale.   
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 4096.

 ** [Status](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-Status"></a>
État des tâches de synthèse vocale renvoyées dans une opération de liste  
Valeurs valides : `scheduled | inProgress | completed | failed` 

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

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

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

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

{
   "NextToken": "string",
   "SynthesisTasks": [ 
      { 
         "CreationTime": number,
         "Engine": "string",
         "LanguageCode": "string",
         "LexiconNames": [ "string" ],
         "OutputFormat": "string",
         "OutputUri": "string",
         "RequestCharacters": number,
         "SampleRate": "string",
         "SnsTopicArn": "string",
         "SpeechMarkTypes": [ "string" ],
         "TaskId": "string",
         "TaskStatus": "string",
         "TaskStatusReason": "string",
         "TextType": "string",
         "VoiceId": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_ListSpeechSynthesisTasks_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_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-NextToken"></a>
Un jeton de pagination opaque renvoyé par l'opération List précédente dans cette demande. Le cas échéant, cela indique où continuer la liste.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 4096.

 ** [SynthesisTasks](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-SynthesisTasks"></a>
Liste des SynthesisTask objets fournissant des informations relatives à la tâche spécifiée dans la demande de liste, notamment le format de sortie, l'heure de création, le statut de la tâche, etc.  
Type : tableau d’objets [SynthesisTask](API_SynthesisTask.md)

## Erreurs
<a name="API_ListSpeechSynthesisTasks_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_ListSpeechSynthesisTasks_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/ListSpeechSynthesisTasks) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListSpeechSynthesisTasks) 

# PutLexicon
<a name="API_PutLexicon"></a>

Stocke un lexique de prononciation dans un Région AWS. Si un lexique portant le même nom existe déjà dans la région, il est remplacé par le nouveau lexique. Les opérations de lexique ont une certaine cohérence, par conséquent, le lexique peut prendre un certain temps avant que le lexique ne soit disponible pour l' SynthesizeSpeech opération.

Pour plus d'informations, consultez la section [Gestion des lexiques](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

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

```
PUT /v1/lexicons/LexiconName HTTP/1.1
Content-type: application/json

{
   "Content": "string"
}
```

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

La demande utilise les paramètres URI suivants.

 ** [LexiconName](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-uri-Name"></a>
Nom du lexique. Le nom doit suivre le format express normal [0-9A-zA-Z] \$11,20\$1. En d'autres termes, le nom est une chaîne alphanumérique sensible aux majuscules et minuscules d'une longueur maximale de 20 caractères.   
Modèle : `[0-9A-Za-z]{1,20}`   
Obligatoire : oui

## Corps de la demande
<a name="API_PutLexicon_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [Content](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-Content"></a>
Contenu du lexique PLS sous forme de chaîne de données.  
Type : Chaîne  
Obligatoire : oui

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

```
HTTP/1.1 200
```

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

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

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

 ** InvalidLexiconException **   
Amazon Polly ne trouve pas le lexique spécifié. Vérifiez que le nom du lexique est correctement orthographié, puis réessayez.  
Code d’état HTTP : 400

 ** LexiconSizeExceededException **   
La taille maximale du lexique spécifié serait dépassée par cette opération.  
Code d’état HTTP : 400

 ** MaxLexemeLengthExceededException **   
La taille maximale du lexème serait dépassée par cette opération.  
Code d’état HTTP : 400

 ** MaxLexiconsNumberExceededException **   
Le nombre maximum de lexiques serait dépassé par cette opération.  
Code d’état HTTP : 400

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

 ** UnsupportedPlsAlphabetException **   
L'alphabet spécifié par le lexique n'est pas un alphabet pris en charge. Les valeurs valides sont `x-sampa` et `ipa`.  
Code d’état HTTP : 400

 ** UnsupportedPlsLanguageException **   
La langue spécifiée dans le lexique n'est pas prise en charge. Pour obtenir la liste des langues prises en charge, consultez la section [Attributs du lexique](https://docs.aws.amazon.com/polly/latest/dg/API_LexiconAttributes.html).  
Code d’état HTTP : 400

## Voir aussi
<a name="API_PutLexicon_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/PutLexicon) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/PutLexicon) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/PutLexicon) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/PutLexicon) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/PutLexicon) 

# StartSpeechSynthesisStream
<a name="API_StartSpeechSynthesisStream"></a>

Synthèse l'entrée UTF-8, le texte brut ou le SSML via une connexion de streaming bidirectionnelle. Spécifiez les paramètres de synthèse dans les en-têtes HTTP/2, envoyez du texte de manière incrémentielle sous forme d'événements sur le flux d'entrée et recevez le son synthétisé dès qu'il est disponible.

Cette opération sert de contrepartie bidirectionnelle à `SynthesizeSpeech` :
+  [SynthesizeSpeech](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html) 

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

```
POST /v1/synthesisStream HTTP/1.1
x-amzn-Engine: Engine
x-amzn-LanguageCode: LanguageCode
x-amzn-LexiconNames: LexiconNames
x-amzn-OutputFormat: OutputFormat
x-amzn-SampleRate: SampleRate
x-amzn-VoiceId: VoiceId
Content-type: application/json

{
   "CloseStreamEvent": { 
   },
   "TextEvent": { 
      "FlushStreamConfiguration": { 
         "Force": boolean
      },
      "Text": "string",
      "TextType": "string"
   }
}
```

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

La demande utilise les paramètres URI suivants.

 ** [Engine](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-Engine"></a>
Spécifie le moteur qu'Amazon Polly doit utiliser lors du traitement du texte d'entrée pour la synthèse vocale. Actuellement, seul le `generative` moteur est pris en charge. Si vous spécifiez une voix que le moteur sélectionné ne prend pas en charge, Amazon Polly renvoie un message d'erreur.  
Valeurs valides : `standard | neural | long-form | generative`   
Obligatoire : oui

 ** [LanguageCode](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LanguageCode"></a>
Paramètre facultatif qui définit le code de langue pour la demande de synthèse vocale. Spécifiez ce paramètre uniquement si vous utilisez une voix bilingue. Si une voix bilingue est utilisée et qu'aucun code de langue n'est spécifié, Amazon Polly utilise la langue par défaut de la voix bilingue.  
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` 

 ** [LexiconNames](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LexiconNames"></a>
Les noms d'un ou de plusieurs lexiques de prononciation que le service doit appliquer lors de la synthèse. Amazon Polly applique les lexiques uniquement lorsque la langue du lexique correspond à la langue vocale.  
Membres du tableau : Nombre maximum de 5 éléments.  
Modèle : `[0-9A-Za-z]{1,20}` 

 ** [OutputFormat](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-OutputFormat"></a>
Format audio du discours synthétisé. Actuellement, Amazon Polly ne prend pas en charge les marques vocales JSON.  
Valeurs valides : `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Obligatoire : oui

 ** [SampleRate](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-SampleRate"></a>
Fréquence audio, spécifiée en Hz.

 ** [VoiceId](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-VoiceId"></a>
La voix à utiliser en synthèse. Pour obtenir la liste des voix disponibles IDs, utilisez l'[DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)opération.  
Valeurs valides : `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
Obligatoire : oui

## Corps de la demande
<a name="API_StartSpeechSynthesisStream_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [CloseStreamEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-CloseStreamEvent"></a>
Un événement indiquant la fin du flux d'entrée.  
Type : objet [CloseStreamEvent](API_CloseStreamEvent.md)  
Obligatoire : non

 ** [TextEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-TextEvent"></a>
Un événement de texte contenant du contenu à synthétiser.  
Type : objet [TextEvent](API_TextEvent.md)  
Obligatoire : non

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

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

{
   "AudioEvent": { 
      "AudioChunk": blob
   },
   "ServiceFailureException": { 
   },
   "ServiceQuotaExceededException": { 
   },
   "StreamClosedEvent": { 
      "RequestCharacters": number
   },
   "ThrottlingException": { 
   },
   "ValidationException": { 
   }
}
```

## Eléments de réponse
<a name="API_StartSpeechSynthesisStream_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.

 ** [AudioEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-AudioEvent"></a>
Un événement audio contenant de la parole synthétisée.  
Type : objet [AudioEvent](API_AudioEvent.md)

 ** [ServiceFailureException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceFailureException"></a>
Une situation inconnue a provoqué une panne de service.  
Type : Exception  
Code d’état HTTP : 500

 ** [ServiceQuotaExceededException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceQuotaExceededException"></a>
Une exception indiquant qu'un quota de service serait dépassé.  
Type : Exception  
Code d'état HTTP : 402

 ** [StreamClosedEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-StreamClosedEvent"></a>
Un événement, avec des informations récapitulatives, indiquant que le stream est fermé.  
Type : objet [StreamClosedEvent](API_StreamClosedEvent.md)

 ** [ThrottlingException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ThrottlingException"></a>
Exception indiquant que la demande a été limitée.  
Type : Exception  
Code d’état HTTP : 400

 ** [ValidationException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ValidationException"></a>
Exception indiquant que la validation de l'entrée a échoué.  
Type : Exception  
Code d’état HTTP : 400

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

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

 ** ServiceQuotaExceededException **   
La demande entraînerait le dépassement d'un quota de service.    
 ** quotaCode **   
Le code de quota identifiant le quota spécifique.  
 ** serviceCode **   
Le code de service identifiant le service d'origine.
Code d'état HTTP : 402

 ** ThrottlingException **   
La demande a été refusée en raison de la limitation des demandes.    
 ** throttlingReasons **   
Une liste des raisons expliquant pourquoi la demande a été limitée.
Code d’état HTTP : 400

 ** ValidationException **   
L'entrée ne satisfait pas les contraintes spécifiées par le service.    
 ** fields **   
Les champs à l'origine de l'erreur de validation.  
 ** reason **   
La raison pour laquelle la demande n'a pas pu être validée.
Code d’état HTTP : 400

## Voir aussi
<a name="API_StartSpeechSynthesisStream_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/StartSpeechSynthesisStream) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStream) 

# StartSpeechSynthesisTask
<a name="API_StartSpeechSynthesisTask"></a>

Permet de créer une tâche de synthèse asynchrone, en démarrant une nouvelle. `SpeechSynthesisTask` Cette opération nécessite toutes les informations standard nécessaires à la synthèse vocale, ainsi que le nom d'un compartiment Amazon S3 permettant au service de stocker le résultat de la tâche de synthèse et deux paramètres facultatifs (`OutputS3KeyPrefix`et`SnsTopicArn`). Une fois la tâche de synthèse créée, cette opération renverra un `SpeechSynthesisTask` objet, qui inclura un identifiant de cette tâche ainsi que le statut actuel. L'`SpeechSynthesisTask`objet est disponible pendant 72 heures après le démarrage de la tâche de synthèse asynchrone.

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

```
POST /v1/synthesisTasks HTTP/1.1
Content-type: application/json

{
   "Engine": "string",
   "LanguageCode": "string",
   "LexiconNames": [ "string" ],
   "OutputFormat": "string",
   "OutputS3BucketName": "string",
   "OutputS3KeyPrefix": "string",
   "SampleRate": "string",
   "SnsTopicArn": "string",
   "SpeechMarkTypes": [ "string" ],
   "Text": "string",
   "TextType": "string",
   "VoiceId": "string"
}
```

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

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_StartSpeechSynthesisTask_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [Engine](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Engine"></a>
Spécifie le moteur (`standard`,`neural`, `long-form` ou`generative`) qu'Amazon Polly doit utiliser lors du traitement du texte d'entrée pour la synthèse vocale. L'utilisation d'une voix qui n'est pas prise en charge pour le moteur sélectionné provoquera une erreur.  
Type : Chaîne  
Valeurs valides : `standard | neural | long-form | generative`   
Obligatoire : non

 ** [LanguageCode](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LanguageCode"></a>
Code de langue facultatif pour la demande de synthèse vocale. Cela n'est nécessaire que si vous utilisez une voix bilingue, telle que Aditi, qui peut être utilisée en anglais indien (en-in) ou en hindi (hi-in).   
Si une voix bilingue est utilisée et qu'aucun code de langue n'est spécifié, Amazon Polly utilise la langue par défaut de la voix bilingue. La langue par défaut pour toute voix est celle renvoyée par l'[DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)opération du `LanguageCode` paramètre. Par exemple, si aucun code de langue n'est spécifié, Aditi utilisera l'anglais indien plutôt que l'hindi.  
Type : Chaîne  
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`   
Obligatoire : non

 ** [LexiconNames](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LexiconNames"></a>
Liste d'un ou de plusieurs noms de lexiques de prononciation que vous souhaitez que le service applique lors de la synthèse. Les lexiques ne sont appliqués que si la langue du lexique est la même que celle de la voix.   
Type : tableau de chaînes  
Membres du tableau : Nombre maximum de 5 éléments.  
Modèle : `[0-9A-Za-z]{1,20}`   
Obligatoire : non

 ** [OutputFormat](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputFormat"></a>
Format dans lequel la sortie renvoyée sera codée. Pour le flux audio, il s'agira de mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law ou pcm. Pour les marques vocales, il s'agira de json.   
Type : Chaîne  
Valeurs valides : `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Obligatoire : oui

 ** [OutputS3BucketName](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3BucketName"></a>
Nom du compartiment Amazon S3 dans lequel le fichier de sortie sera enregistré.  
Type : Chaîne  
Modèle : `^[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]$`   
Obligatoire : oui

 ** [OutputS3KeyPrefix](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3KeyPrefix"></a>
Le préfixe de clé Amazon S3 pour le fichier vocal de sortie.  
Type : Chaîne  
Modèle : `^[0-9a-zA-Z\/\!\-_\.\*\'\(\):;\$@=+\,\?&]{0,800}$`   
Obligatoire : non

 ** [SampleRate](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SampleRate"></a>
Fréquence audio spécifiée en Hz.  
Les valeurs valides pour mp3 et ogg\$1vorbis sont « 8000 », « 16000 », « 22050 » et « 24000 ». La valeur par défaut pour les voix standard est « 22050 ». La valeur par défaut pour les voix neuronales est « 24 000 ». La valeur par défaut pour les voix longues est « 24 000 ». La valeur par défaut pour les voix génératives est « 24 000 ».  
Les valeurs valides pour pcm sont « 8000 » et « 16000 ». La valeur par défaut est « 16000 ».   
La valeur valide pour ogg\$1opus est « 48000 ».   
La valeur valide pour mu-law et a-law est « 8000 ».   
Type : chaîne  
Obligatoire : non

 ** [SnsTopicArn](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SnsTopicArn"></a>
ARN pour le sujet SNS utilisé en option pour fournir une notification d'état pour une tâche de synthèse vocale.  
Type : Chaîne  
Modèle : `^arn:aws(-(cn|iso(-b)?|us-gov))?:sns:[a-z0-9_-]{1,50}:\d{12}:[a-zA-Z0-9_-]{1,251}([a-zA-Z0-9_-]{0,5}|\.fifo)$`   
Obligatoire : non

 ** [SpeechMarkTypes](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SpeechMarkTypes"></a>
Type de marques vocales renvoyées pour le texte saisi.  
Type : tableau de chaînes  
Membres du tableau : nombre maximum de 4 éléments.  
Valeurs valides : `sentence | ssml | viseme | word`   
Obligatoire : non

 ** [Text](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Text"></a>
Le texte d'entrée à synthétiser. Si vous spécifiez ssml comme étant TextType, suivez le format SSML pour le texte d'entrée.   
Type : Chaîne  
Obligatoire : oui

 ** [TextType](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-TextType"></a>
Spécifie si le texte d'entrée est du texte brut ou du SSML. La valeur par défaut est le texte brut.   
Type : Chaîne  
Valeurs valides : `ssml | text`   
Obligatoire : non

 ** [VoiceId](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-VoiceId"></a>
Identifiant vocal à utiliser pour la synthèse.   
Type : Chaîne  
Valeurs valides : `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
Obligatoire : oui

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

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

{
   "SynthesisTask": { 
      "CreationTime": number,
      "Engine": "string",
      "LanguageCode": "string",
      "LexiconNames": [ "string" ],
      "OutputFormat": "string",
      "OutputUri": "string",
      "RequestCharacters": number,
      "SampleRate": "string",
      "SnsTopicArn": "string",
      "SpeechMarkTypes": [ "string" ],
      "TaskId": "string",
      "TaskStatus": "string",
      "TaskStatusReason": "string",
      "TextType": "string",
      "VoiceId": "string"
   }
}
```

## Eléments de réponse
<a name="API_StartSpeechSynthesisTask_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.

 ** [SynthesisTask](#API_StartSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask objet qui fournit des informations et des attributs relatifs à une tâche de synthèse vocale récemment soumise.  
Type : objet [SynthesisTask](API_SynthesisTask.md)

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

 ** EngineNotSupportedException **   
Ce moteur n'est pas compatible avec la voix que vous avez désignée. Choisissez une nouvelle voix compatible avec le moteur ou changez de moteur et relancez l'opération.  
Code d’état HTTP : 400

 ** InvalidS3BucketException **   
Le nom de compartiment Amazon S3 fourni n'est pas valide. Vérifiez que vos données sont conformes aux exigences de dénomination des compartiments S3 et réessayez.  
Code d’état HTTP : 400

 ** InvalidS3KeyException **   
Le préfixe de clé Amazon S3 fourni n'est pas valide. Veuillez fournir un nom de clé d'objet S3 valide.  
Code d’état HTTP : 400

 ** InvalidSampleRateException **   
La fréquence d'échantillonnage spécifiée n'est pas valide.  
Code d’état HTTP : 400

 ** InvalidSnsTopicArnException **   
L'ARN de la rubrique SNS fourni n'est pas valide. Entrez un ARN de rubrique SNS valide et réessayez.  
Code d’état HTTP : 400

 ** InvalidSsmlException **   
Le code SSML que vous avez fourni n'est pas valide. Vérifiez la syntaxe SSML, l'orthographe des balises et des valeurs, puis réessayez.  
Code d’état HTTP : 400

 ** LanguageNotSupportedException **   
La langue spécifiée n'est actuellement pas prise en charge par Amazon Polly à ce titre.  
Code d’état HTTP : 400

 ** LexiconNotFoundException **   
Amazon Polly ne trouve pas le lexique spécifié. Cela peut être dû à un lexique manquant, à une faute d'orthographe de son nom ou à la spécification d'un lexique situé dans une autre région.  
Vérifiez que le lexique existe, qu'il se trouve dans la région (voir[ListLexicons](API_ListLexicons.md)) et que vous avez orthographié son nom correctement. Ensuite, réessayez.  
Code d’état HTTP :404

 ** MarksNotSupportedForFormatException **   
Les marques vocales ne sont pas prises en charge pour les `OutputFormat` éléments sélectionnés. Les marques vocales ne sont disponibles que pour le contenu au `json` format.  
Code d’état HTTP : 400

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

 ** SsmlMarksNotSupportedForTextTypeException **   
Les marques vocales SSML ne sont pas prises en charge pour la saisie de type texte brut.  
Code d’état HTTP : 400

 ** TextLengthExceededException **   
La valeur du paramètre « Texte » est supérieure aux limites acceptées. Pour l'`SynthesizeSpeech`API, la limite de saisie de texte est de 6 000 caractères au total, dont 3 000 caractères peuvent être facturés au maximum. Pour l'`StartSpeechSynthesisTask`API, le maximum est de 200 000 caractères, dont 100 000 caractères peuvent être facturés au maximum. Les balises SSML ne sont pas considérées comme des caractères facturés.  
Code d’état HTTP : 400

## Voir aussi
<a name="API_StartSpeechSynthesisTask_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/StartSpeechSynthesisTask) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisTask) 

# SynthesizeSpeech
<a name="API_SynthesizeSpeech"></a>

Synthétise une entrée UTF-8, du texte brut ou SSML dans un flux d'octets. L'entrée SSML doit être un SSML valide et bien formé. Certains alphabets peuvent ne pas être disponibles avec toutes les voix (par exemple, le cyrillique peut ne pas être lu du tout par les voix anglaises) à moins que le mappage des phonèmes ne soit utilisé. Pour plus d'informations, consultez [la section Fonctionnement](https://docs.aws.amazon.com/polly/latest/dg/how-text-to-speech-works.html).

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

```
POST /v1/speech HTTP/1.1
Content-type: application/json

{
   "Engine": "string",
   "LanguageCode": "string",
   "LexiconNames": [ "string" ],
   "OutputFormat": "string",
   "SampleRate": "string",
   "SpeechMarkTypes": [ "string" ],
   "Text": "string",
   "TextType": "string",
   "VoiceId": "string"
}
```

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

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_SynthesizeSpeech_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [Engine](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Engine"></a>
Spécifie le moteur (`standard`, `neural``long-form`, ou`generative`) qu'Amazon Polly doit utiliser lors du traitement du texte d'entrée pour la synthèse vocale. Fournissez un moteur compatible avec la voix que vous sélectionnez. Si vous ne fournissez pas de moteur, le moteur standard est sélectionné par défaut. Si une voix choisie n'est pas prise en charge par le moteur standard, cela provoquera une erreur. Pour plus d'informations sur les voix Amazon Polly et sur les voix disponibles pour chaque moteur, consultez [Available](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html) Voices.  
Type : Chaîne  
Valeurs valides : `standard | neural | long-form | generative`   
Obligatoire : non

 ** [LanguageCode](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LanguageCode"></a>
Code de langue facultatif pour la demande Synthesize Speech. Cela n'est nécessaire que si vous utilisez une voix bilingue, telle que Aditi, qui peut être utilisée en anglais indien (en-in) ou en hindi (hi-in).   
Si une voix bilingue est utilisée et qu'aucun code de langue n'est spécifié, Amazon Polly utilise la langue par défaut de la voix bilingue. La langue par défaut pour toute voix est celle renvoyée par l'[DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)opération du `LanguageCode` paramètre. Par exemple, si aucun code de langue n'est spécifié, Aditi utilisera l'anglais indien plutôt que l'hindi.  
Type : Chaîne  
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`   
Obligatoire : non

 ** [LexiconNames](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LexiconNames"></a>
Liste d'un ou de plusieurs noms de lexiques de prononciation que vous souhaitez que le service applique lors de la synthèse. Les lexiques ne sont appliqués que si la langue du lexique est la même que celle de la voix. Pour plus d'informations sur le stockage des lexiques, consultez [PutLexicon](https://docs.aws.amazon.com/polly/latest/dg/API_PutLexicon.html).  
Type : tableau de chaînes  
Membres du tableau : Nombre maximum de 5 éléments.  
Modèle : `[0-9A-Za-z]{1,20}`   
Obligatoire : non

 ** [OutputFormat](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-OutputFormat"></a>
 Format dans lequel la sortie renvoyée sera codée. Pour le flux audio, il s'agira de mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law ou pcm. Pour les marques vocales, il s'agira de json.   
Lorsque pcm est utilisé, le contenu renvoyé est audio/pcm au format little-endian 16 bits, 1 canal (mono) signé.   
Type : Chaîne  
Valeurs valides : `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Obligatoire : oui

 ** [SampleRate](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SampleRate"></a>
Fréquence audio spécifiée en Hz.  
Les valeurs valides pour mp3 et ogg\$1vorbis sont « 8000 », « 16000 », « 22050 », « 24000 », « 44100 » et « 48000 ». La valeur par défaut pour les voix standard est « 22050 ». La valeur par défaut pour les voix neuronales est « 24 000 ». La valeur par défaut pour les voix longues est « 24 000 ». La valeur par défaut pour les voix génératives est « 24 000 ».  
Les valeurs valides pour pcm sont « 8000 » et « 16000 ». La valeur par défaut est « 16000 ».   
La valeur valide pour ogg\$1opus est « 48000 ».   
La valeur valide pour mu-law et a-law est « 8000 ».   
Type : chaîne  
Obligatoire : non

 ** [SpeechMarkTypes](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SpeechMarkTypes"></a>
Type de marques vocales renvoyées pour le texte saisi.  
Type : tableau de chaînes  
Membres du tableau : nombre maximum de 4 éléments.  
Valeurs valides : `sentence | ssml | viseme | word`   
Obligatoire : non

 ** [Text](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Text"></a>
 Entrez le texte à synthétiser. Si vous `ssml` le spécifiez`TextType`, suivez le format SSML pour le texte d'entrée.   
Type : Chaîne  
Obligatoire : oui

 ** [TextType](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-TextType"></a>
 Spécifie si le texte d'entrée est du texte brut ou du SSML. La valeur par défaut est le texte brut. Pour plus d'informations, consultez [Utilisation de SSML](https://docs.aws.amazon.com/polly/latest/dg/ssml.html).  
Type : Chaîne  
Valeurs valides : `ssml | text`   
Obligatoire : non

 ** [VoiceId](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-VoiceId"></a>
 Identifiant vocal à utiliser pour la synthèse. Vous pouvez obtenir une liste des voix disponibles IDs en appelant l'[DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)opération.   
Type : Chaîne  
Valeurs valides : `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
Obligatoire : oui

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

```
HTTP/1.1 200
Content-Type: ContentType
x-amzn-RequestCharacters: RequestCharacters

AudioStream
```

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

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

La réponse renvoie les en-têtes HTTP suivants.

 ** [ContentType](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-ContentType"></a>
 Spécifie le type de flux audio. Cela doit refléter le `OutputFormat` paramètre de votre demande.   
+  Si vous le demandez`OutputFormat`, `mp3` le résultat est `ContentType` audio/mpeg. 
+  Si vous le demandez`OutputFormat`, `ogg_vorbis` le résultat est `ContentType` audio/ogg. 
+  Si vous le demandez`OutputFormat`, `ogg_opus` le résultat est `ContentType` audio/ogg. 
+  Si vous `pcm` le demandez`OutputFormat`, le fichier `ContentType` renvoyé est audio/pcm au format little-endian 16 bits, 1 canal (mono) signé. 
+  Si vous `mu-law` en faites la demande`OutputFormat`, le `ContentType` retour est audio/mulaw. 
+  Si vous `a-law` en faites la demande`OutputFormat`, le `ContentType` retour est audio/alaw. 
+ Si vous le demandez `json` en tant que`OutputFormat`, le `ContentType` retour est application/x-json-stream.
 

 ** [RequestCharacters](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-RequestCharacters"></a>
Nombre de caractères synthétisés.

La réponse renvoie ce qui suit en tant que corps HTTP.

 ** [AudioStream](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-AudioStream"></a>
 Stream contenant le discours synthétisé. 

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

 ** EngineNotSupportedException **   
Ce moteur n'est pas compatible avec la voix que vous avez désignée. Choisissez une nouvelle voix compatible avec le moteur ou changez de moteur et relancez l'opération.  
Code d’état HTTP : 400

 ** InvalidSampleRateException **   
La fréquence d'échantillonnage spécifiée n'est pas valide.  
Code d’état HTTP : 400

 ** InvalidSsmlException **   
Le code SSML que vous avez fourni n'est pas valide. Vérifiez la syntaxe SSML, l'orthographe des balises et des valeurs, puis réessayez.  
Code d’état HTTP : 400

 ** LanguageNotSupportedException **   
La langue spécifiée n'est actuellement pas prise en charge par Amazon Polly à ce titre.  
Code d’état HTTP : 400

 ** LexiconNotFoundException **   
Amazon Polly ne trouve pas le lexique spécifié. Cela peut être dû à un lexique manquant, à une faute d'orthographe de son nom ou à la spécification d'un lexique situé dans une autre région.  
Vérifiez que le lexique existe, qu'il se trouve dans la région (voir[ListLexicons](API_ListLexicons.md)) et que vous avez orthographié son nom correctement. Ensuite, réessayez.  
Code d’état HTTP :404

 ** MarksNotSupportedForFormatException **   
Les marques vocales ne sont pas prises en charge pour les `OutputFormat` éléments sélectionnés. Les marques vocales ne sont disponibles que pour le contenu au `json` format.  
Code d’état HTTP : 400

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

 ** SsmlMarksNotSupportedForTextTypeException **   
Les marques vocales SSML ne sont pas prises en charge pour la saisie de type texte brut.  
Code d’état HTTP : 400

 ** TextLengthExceededException **   
La valeur du paramètre « Texte » est supérieure aux limites acceptées. Pour l'`SynthesizeSpeech`API, la limite de saisie de texte est de 6 000 caractères au total, dont 3 000 caractères peuvent être facturés au maximum. Pour l'`StartSpeechSynthesisTask`API, le maximum est de 200 000 caractères, dont 100 000 caractères peuvent être facturés au maximum. Les balises SSML ne sont pas considérées comme des caractères facturés.  
Code d’état HTTP : 400

## Voir aussi
<a name="API_SynthesizeSpeech_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/SynthesizeSpeech) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesizeSpeech) 

# Types de données
<a name="API_Types"></a>

Les types de données suivants sont pris en charge :
+  [AudioEvent](API_AudioEvent.md) 
+  [CloseStreamEvent](API_CloseStreamEvent.md) 
+  [FlushStreamConfiguration](API_FlushStreamConfiguration.md) 
+  [Lexicon](API_Lexicon.md) 
+  [LexiconAttributes](API_LexiconAttributes.md) 
+  [LexiconDescription](API_LexiconDescription.md) 
+  [StartSpeechSynthesisStreamActionStream](API_StartSpeechSynthesisStreamActionStream.md) 
+  [StartSpeechSynthesisStreamEventStream](API_StartSpeechSynthesisStreamEventStream.md) 
+  [StreamClosedEvent](API_StreamClosedEvent.md) 
+  [SynthesisTask](API_SynthesisTask.md) 
+  [TextEvent](API_TextEvent.md) 
+  [ThrottlingReason](API_ThrottlingReason.md) 
+  [ValidationExceptionField](API_ValidationExceptionField.md) 
+  [Voice](API_Voice.md) 

# AudioEvent
<a name="API_AudioEvent"></a>

Contient une partie des données audio synthétisées.

## Table des matières
<a name="API_AudioEvent_Contents"></a>

 ** AudioChunk **   <a name="polly-Type-AudioEvent-AudioChunk"></a>
Un bloc de données audio synthétisées codé dans le format spécifié par le `OutputFormat` paramètre.  
Type : objet de données binaires encodées en base64  
Obligatoire : non

## Voir aussi
<a name="API_AudioEvent_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/AudioEvent) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/AudioEvent) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/AudioEvent) 

# CloseStreamEvent
<a name="API_CloseStreamEvent"></a>

Indique la fin du flux d'entrée. Après avoir envoyé cet événement, le flux d'entrée sera fermé et tout le son sera renvoyé.

## Table des matières
<a name="API_CloseStreamEvent_Contents"></a>

Les membres de cette structure d'exception dépendent du contexte.

## Voir aussi
<a name="API_CloseStreamEvent_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/CloseStreamEvent) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/CloseStreamEvent) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/CloseStreamEvent) 

# FlushStreamConfiguration
<a name="API_FlushStreamConfiguration"></a>

Configuration qui contrôle le moment où les données audio synthétisées sont envoyées sur le flux de sortie.

## Table des matières
<a name="API_FlushStreamConfiguration_Contents"></a>

 ** Force **   <a name="polly-Type-FlushStreamConfiguration-Force"></a>
Spécifie s'il faut forcer le moteur de synthèse à écrire immédiatement des données audio mises en mémoire tampon dans le flux de sortie.  
Type : booléen  
Obligatoire : non

## Voir aussi
<a name="API_FlushStreamConfiguration_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/FlushStreamConfiguration) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/FlushStreamConfiguration) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/FlushStreamConfiguration) 

# Lexicon
<a name="API_Lexicon"></a>

Fournit le nom du lexique et le contenu du lexique sous forme de chaîne. Pour plus d'informations, voir [Spécification du lexique de prononciation (PLS) version 1.0.](https://www.w3.org/TR/pronunciation-lexicon/)

## Table des matières
<a name="API_Lexicon_Contents"></a>

 ** Content **   <a name="polly-Type-Lexicon-Content"></a>
Contenu du lexique sous forme de chaîne. Le contenu d'un lexique doit être au format PLS.  
Type : chaîne  
Obligatoire : non

 ** Name **   <a name="polly-Type-Lexicon-Name"></a>
Nom du lexique.  
Type : String  
Modèle : `[0-9A-Za-z]{1,20}`   
Obligatoire : non

## consultez aussi
<a name="API_Lexicon_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Lexicon) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Lexicon) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Lexicon) 

# LexiconAttributes
<a name="API_LexiconAttributes"></a>

Contient des métadonnées décrivant le lexique, telles que le nombre de lexèmes, le code de langue, etc. Pour plus d'informations, consultez la section [Gestion des lexiques](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

## Table des matières
<a name="API_LexiconAttributes_Contents"></a>

 ** Alphabet **   <a name="polly-Type-LexiconAttributes-Alphabet"></a>
Alphabet phonétique utilisé dans le lexique. Les valeurs valides sont `ipa` et `x-sampa`.  
Type : chaîne  
Obligatoire : non

 ** LanguageCode **   <a name="polly-Type-LexiconAttributes-LanguageCode"></a>
Code de langue auquel le lexique s'applique. Un lexique avec un code de langue tel que « en » serait appliqué à toutes les langues anglaises (en-GB, en-US, en-AUS, en-WLS, etc.)  
Type : Chaîne  
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`   
Obligatoire : non

 ** LastModified **   <a name="polly-Type-LexiconAttributes-LastModified"></a>
Date de dernière modification du lexique (valeur d'horodatage).  
Type : Timestamp  
Obligatoire : non

 ** LexemesCount **   <a name="polly-Type-LexiconAttributes-LexemesCount"></a>
Nombre de lexèmes dans le lexique.  
Type : Integer  
Obligatoire : non

 ** LexiconArn **   <a name="polly-Type-LexiconAttributes-LexiconArn"></a>
Amazon Resource Name (ARN) du lexique.  
Type : chaîne  
Obligatoire : non

 ** Size **   <a name="polly-Type-LexiconAttributes-Size"></a>
Taille totale du lexique, en caractères.  
Type : Integer  
Obligatoire : non

## Voir aussi
<a name="API_LexiconAttributes_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconAttributes) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconAttributes) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconAttributes) 

# LexiconDescription
<a name="API_LexiconDescription"></a>

Décrit le contenu du lexique.

## Table des matières
<a name="API_LexiconDescription_Contents"></a>

 ** Attributes **   <a name="polly-Type-LexiconDescription-Attributes"></a>
Fournit les métadonnées du lexique.  
Type : objet [LexiconAttributes](API_LexiconAttributes.md)  
Obligatoire : non

 ** Name **   <a name="polly-Type-LexiconDescription-Name"></a>
Nom du lexique.  
Type : String  
Modèle : `[0-9A-Za-z]{1,20}`   
Obligatoire : non

## consultez aussi
<a name="API_LexiconDescription_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconDescription) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconDescription) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconDescription) 

# StartSpeechSynthesisStreamActionStream
<a name="API_StartSpeechSynthesisStreamActionStream"></a>

Flux d'événements entrant pour envoyer des entrées et des événements de contrôle pour gérer la synthèse vocale bidirectionnelle.

## Table des matières
<a name="API_StartSpeechSynthesisStreamActionStream_Contents"></a>

 ** CloseStreamEvent **   <a name="polly-Type-StartSpeechSynthesisStreamActionStream-CloseStreamEvent"></a>
Un événement indiquant la fin du flux d'entrée.  
Type : objet [CloseStreamEvent](API_CloseStreamEvent.md)  
Obligatoire : non

 ** TextEvent **   <a name="polly-Type-StartSpeechSynthesisStreamActionStream-TextEvent"></a>
Un événement de texte contenant du contenu à synthétiser.  
Type : objet [TextEvent](API_TextEvent.md)  
Obligatoire : non

## Voir aussi
<a name="API_StartSpeechSynthesisStreamActionStream_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 

# StartSpeechSynthesisStreamEventStream
<a name="API_StartSpeechSynthesisStreamEventStream"></a>

Flux d'événements sortant contenant des données audio synthétisées et des événements d'état du flux.

## Table des matières
<a name="API_StartSpeechSynthesisStreamEventStream_Contents"></a>

 ** AudioEvent **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-AudioEvent"></a>
Un événement audio contenant de la parole synthétisée.  
Type : objet [AudioEvent](API_AudioEvent.md)  
Obligatoire : non

 ** ServiceFailureException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceFailureException"></a>
Une situation inconnue a provoqué une panne de service.  
Type : Exception  
Code d’état HTTP : 500  
Obligatoire : non

 ** ServiceQuotaExceededException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceQuotaExceededException"></a>
Une exception indiquant qu'un quota de service serait dépassé.  
Type : Exception  
Code d'état HTTP : 402  
Obligatoire : non

 ** StreamClosedEvent **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-StreamClosedEvent"></a>
Un événement, avec des informations récapitulatives, indiquant que le stream est fermé.  
Type : objet [StreamClosedEvent](API_StreamClosedEvent.md)  
Obligatoire : non

 ** ThrottlingException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ThrottlingException"></a>
Exception indiquant que la demande a été limitée.  
Type : Exception  
Code d’état HTTP : 400  
Obligatoire : non

 ** ValidationException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ValidationException"></a>
Exception indiquant que la validation de l'entrée a échoué.  
Type : Exception  
Code d’état HTTP : 400  
Obligatoire : non

## Voir aussi
<a name="API_StartSpeechSynthesisStreamEventStream_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 

# StreamClosedEvent
<a name="API_StreamClosedEvent"></a>

Indique que le flux de synthèse est fermé et fournit des informations récapitulatives.

## Table des matières
<a name="API_StreamClosedEvent_Contents"></a>

 ** RequestCharacters **   <a name="polly-Type-StreamClosedEvent-RequestCharacters"></a>
Nombre total de caractères synthétisés pendant la session de streaming.  
Type : Integer  
Obligatoire : non

## Voir aussi
<a name="API_StreamClosedEvent_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StreamClosedEvent) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StreamClosedEvent) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StreamClosedEvent) 

# SynthesisTask
<a name="API_SynthesisTask"></a>

SynthesisTask objet qui fournit des informations sur une tâche de synthèse vocale.

## Table des matières
<a name="API_SynthesisTask_Contents"></a>

 ** CreationTime **   <a name="polly-Type-SynthesisTask-CreationTime"></a>
Horodatage indiquant l'heure à laquelle la tâche de synthèse a été lancée.  
Type : Timestamp  
Obligatoire : non

 ** Engine **   <a name="polly-Type-SynthesisTask-Engine"></a>
Spécifie le moteur (`standard`,`neural`, `long-form` ou`generative`) qu'Amazon Polly doit utiliser lors du traitement du texte d'entrée pour la synthèse vocale. L'utilisation d'une voix qui n'est pas prise en charge pour le moteur sélectionné provoquera une erreur.  
Type : Chaîne  
Valeurs valides : `standard | neural | long-form | generative`   
Obligatoire : non

 ** LanguageCode **   <a name="polly-Type-SynthesisTask-LanguageCode"></a>
Code de langue facultatif pour une tâche de synthèse. Cela n'est nécessaire que si vous utilisez une voix bilingue, telle que Aditi, qui peut être utilisée en anglais indien (en-in) ou en hindi (hi-in).   
Si une voix bilingue est utilisée et qu'aucun code de langue n'est spécifié, Amazon Polly utilise la langue par défaut de la voix bilingue. La langue par défaut pour toute voix est celle renvoyée par l'[DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)opération du `LanguageCode` paramètre. Par exemple, si aucun code de langue n'est spécifié, Aditi utilisera l'anglais indien plutôt que l'hindi.  
Type : Chaîne  
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`   
Obligatoire : non

 ** LexiconNames **   <a name="polly-Type-SynthesisTask-LexiconNames"></a>
Liste d'un ou de plusieurs noms de lexiques de prononciation que vous souhaitez que le service applique lors de la synthèse. Les lexiques ne sont appliqués que si la langue du lexique est la même que celle de la voix.   
Type : tableau de chaînes  
Membres du tableau : Nombre maximum de 5 éléments.  
Modèle : `[0-9A-Za-z]{1,20}`   
Obligatoire : non

 ** OutputFormat **   <a name="polly-Type-SynthesisTask-OutputFormat"></a>
Format dans lequel la sortie renvoyée sera codée. Pour le flux audio, il s'agira de mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law ou pcm. Pour les marques vocales, il s'agira de json.   
Type : Chaîne  
Valeurs valides : `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Obligatoire : non

 ** OutputUri **   <a name="polly-Type-SynthesisTask-OutputUri"></a>
Chemin d'accès au fichier vocal de sortie.  
Type : chaîne  
Obligatoire : non

 ** RequestCharacters **   <a name="polly-Type-SynthesisTask-RequestCharacters"></a>
Nombre de caractères facturables synthétisés.  
Type : Integer  
Obligatoire : non

 ** SampleRate **   <a name="polly-Type-SynthesisTask-SampleRate"></a>
Fréquence audio spécifiée en Hz.  
Les valeurs valides pour mp3 et ogg\$1vorbis sont « 8000 », « 16000 », « 22050 » et « 24000 ». La valeur par défaut pour les voix standard est « 22050 ». La valeur par défaut pour les voix neuronales est « 24 000 ». La valeur par défaut pour les voix longues est « 24 000 ». La valeur par défaut pour les voix génératives est « 24 000 ».  
Les valeurs valides pour pcm sont « 8000 » et « 16000 ». La valeur par défaut est « 16000 ».   
La valeur valide pour ogg\$1opus est « 48000 ».   
La valeur valide pour mu-law et a-law est « 8000 ».   
Type : chaîne  
Obligatoire : non

 ** SnsTopicArn **   <a name="polly-Type-SynthesisTask-SnsTopicArn"></a>
ARN pour le sujet SNS utilisé en option pour fournir une notification d'état pour une tâche de synthèse vocale.  
Type : Chaîne  
Modèle : `^arn:aws(-(cn|iso(-b)?|us-gov))?:sns:[a-z0-9_-]{1,50}:\d{12}:[a-zA-Z0-9_-]{1,251}([a-zA-Z0-9_-]{0,5}|\.fifo)$`   
Obligatoire : non

 ** SpeechMarkTypes **   <a name="polly-Type-SynthesisTask-SpeechMarkTypes"></a>
Type de marques vocales renvoyées pour le texte saisi.  
Type : tableau de chaînes  
Membres du tableau : nombre maximum de 4 éléments.  
Valeurs valides : `sentence | ssml | viseme | word`   
Obligatoire : non

 ** TaskId **   <a name="polly-Type-SynthesisTask-TaskId"></a>
Identifiant généré par Amazon Polly pour une tâche de synthèse vocale.  
Type : Chaîne  
Modèle : `^[a-zA-Z0-9_-]{1,100}$`   
Obligatoire : non

 ** TaskStatus **   <a name="polly-Type-SynthesisTask-TaskStatus"></a>
État actuel de la tâche de synthèse vocale individuelle.  
Type : Chaîne  
Valeurs valides : `scheduled | inProgress | completed | failed`   
Obligatoire : non

 ** TaskStatusReason **   <a name="polly-Type-SynthesisTask-TaskStatusReason"></a>
Raison de l'état actuel d'une tâche de synthèse vocale spécifique, y compris les erreurs en cas d'échec de la tâche.  
Type : chaîne  
Obligatoire : non

 ** TextType **   <a name="polly-Type-SynthesisTask-TextType"></a>
Spécifie si le texte d'entrée est du texte brut ou du SSML. La valeur par défaut est le texte brut.   
Type : Chaîne  
Valeurs valides : `ssml | text`   
Obligatoire : non

 ** VoiceId **   <a name="polly-Type-SynthesisTask-VoiceId"></a>
Identifiant vocal à utiliser pour la synthèse.   
Type : Chaîne  
Valeurs valides : `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
Obligatoire : non

## Voir aussi
<a name="API_SynthesisTask_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesisTask) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesisTask) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesisTask) 

# TextEvent
<a name="API_TextEvent"></a>

Contient du texte à synthétiser sous forme vocale.

## Table des matières
<a name="API_TextEvent_Contents"></a>

 ** Text **   <a name="polly-Type-TextEvent-Text"></a>
Le contenu du texte à synthétiser. Si vous `ssml` le spécifiez`TextType`, suivez le format SSML pour le texte d'entrée.  
Type : Chaîne  
Obligatoire : oui

 ** FlushStreamConfiguration **   <a name="polly-Type-TextEvent-FlushStreamConfiguration"></a>
Configuration permettant de contrôler le moment où le son synthétisé est dirigé vers le flux de sortie.  
Type : objet [FlushStreamConfiguration](API_FlushStreamConfiguration.md)  
Obligatoire : non

 ** TextType **   <a name="polly-Type-TextEvent-TextType"></a>
Spécifie si le texte d'entrée est du texte brut ou du SSML. Par défaut : texte brut.  
Type : Chaîne  
Valeurs valides : `ssml | text`   
Obligatoire : non

## Voir aussi
<a name="API_TextEvent_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/TextEvent) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/TextEvent) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/TextEvent) 

# ThrottlingReason
<a name="API_ThrottlingReason"></a>

Fournit des informations sur une raison d'étranglement spécifique.

## Table des matières
<a name="API_ThrottlingReason_Contents"></a>

 ** reason **   <a name="polly-Type-ThrottlingReason-reason"></a>
Code de motif expliquant pourquoi la demande a été limitée.  
Type : chaîne  
Obligatoire : non

 ** resource **   <a name="polly-Type-ThrottlingReason-resource"></a>
La ressource à l'origine de l'étranglement.  
Type : chaîne  
Obligatoire : non

## Voir aussi
<a name="API_ThrottlingReason_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ThrottlingReason) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ThrottlingReason) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ThrottlingReason) 

# ValidationExceptionField
<a name="API_ValidationExceptionField"></a>

Informations relatives à un champ dont la validation a échoué.

## Table des matières
<a name="API_ValidationExceptionField_Contents"></a>

 ** message **   <a name="polly-Type-ValidationExceptionField-message"></a>
Un message expliquant pourquoi le champ n'a pas été validé.  
Type : Chaîne  
Obligatoire : oui

 ** name **   <a name="polly-Type-ValidationExceptionField-name"></a>
Nom du champ dont la validation a échoué.  
Type : Chaîne  
Obligatoire : oui

## Voir aussi
<a name="API_ValidationExceptionField_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ValidationExceptionField) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ValidationExceptionField) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ValidationExceptionField) 

# Voice
<a name="API_Voice"></a>

Description de la voix.

## Table des matières
<a name="API_Voice_Contents"></a>

 ** AdditionalLanguageCodes **   <a name="polly-Type-Voice-AdditionalLanguageCodes"></a>
Des codes supplémentaires pour les langues disponibles pour la voix spécifiée en plus de sa langue par défaut.   
Par exemple, la langue par défaut pour Aditi est l'anglais indien (en-in) car il a été utilisé pour la première fois pour cette langue. Comme Aditi est bilingue et parle couramment l'anglais indien et l'hindi, ce paramètre indiquerait le code`hi-IN`.  
Type : tableau de chaînes  
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`   
Obligatoire : non

 ** Gender **   <a name="polly-Type-Voice-Gender"></a>
Genre de la voix.  
Type : Chaîne  
Valeurs valides : `Female | Male`   
Obligatoire : non

 ** Id **   <a name="polly-Type-Voice-Id"></a>
Amazon Polly a attribué un identifiant vocal. Il s'agit de l'identifiant que vous spécifiez lors de l'appel de l'`SynthesizeSpeech`opération.  
Type : Chaîne  
Valeurs valides : `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
Obligatoire : non

 ** LanguageCode **   <a name="polly-Type-Voice-LanguageCode"></a>
Code de langue de la voix.  
Type : Chaîne  
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`   
Obligatoire : non

 ** LanguageName **   <a name="polly-Type-Voice-LanguageName"></a>
Nom lisible par l'homme de la langue en anglais.  
Type : chaîne  
Obligatoire : non

 ** Name **   <a name="polly-Type-Voice-Name"></a>
Nom de la voix (par exemple, Salli, Kendra, etc.) Cela fournit un nom vocal lisible par l'homme que vous pouvez afficher dans votre application.  
Type : chaîne  
Obligatoire : non

 ** SupportedEngines **   <a name="polly-Type-Voice-SupportedEngines"></a>
Spécifie quels moteurs (`standard`,`neural`, `long-form` ou`generative`) sont pris en charge par une voix donnée.  
Type : tableau de chaînes  
Valeurs valides : `standard | neural | long-form | generative`   
Obligatoire : non

## Voir aussi
<a name="API_Voice_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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Voice) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Voice) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Voice) 

# Erreurs courantes
<a name="CommonErrors"></a>

Cette section répertorie les erreurs communes aux actions d'API de tous les AWS services. Pour les erreurs spécifiques à une action d’API pour ce service, consultez la rubrique pour cette action d’API.

 **AccessDeniedException**   
Vous ne disposez pas d’un accès suffisant pour effectuer cette action.  
Code d’état HTTP : 400

 **IncompleteSignature**   
La signature de la demande n'est pas conforme aux AWS normes.  
Code d’état HTTP : 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
Le traitement de la demande a échoué en raison d'une erreur, d'une exception ou d'un échec inconnu.  
Code d’état HTTP : 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
L'action ou l'opération demandée n'est pas valide. Vérifiez que l’action est entrée correctement.  
Code d’état HTTP : 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
Le certificat X.509 ou AWS l'ID de clé d'accès fourni n'existe pas dans nos archives.  
Code d’état HTTP : 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
Vous ne disposez pas de l’autorisation nécessaire pour effectuer cette action.  
Code d’état HTTP : 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
L'ID de clé d' AWS accès nécessite un abonnement au service.  
Code d’état HTTP : 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
La demande est parvenue au service plus de 15 minutes après l'horodatage sur la demande ou plus de 15 minutes après la date d'expiration de la demande (par exemple pour les demandes pré-signées URLs), ou le horodatage sur la demande est daté dans plus de 15 minutes dans le futur.  
Code d’état HTTP : 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
La requête a échoué en raison d’une défaillance temporaire du serveur.  
HTTP Status Code: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
La demande a été refusée suite à une limitation des demandes.  
Code d’état HTTP : 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
L'entrée ne satisfait pas les contraintes spécifiées par un AWS service.  
Code d’état HTTP : 400

# Paramètres communs
<a name="CommonParameters"></a>

La liste suivante contient les paramètres que toutes les actions utilisent pour signer les demandes Signature Version 4 à l'aide d'une chaîne de requête. Tous les paramètres spécifiques d'une action particulière sont énumérées dans le sujet consacré à cette action. Pour plus d'informations sur la version 4 de Signature, consultez [la section Signing AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) du *guide de l'utilisateur IAM*.

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
Algorithme de hachage que vous avez utilisé pour créer la signature de la demande.  
Condition : spécifiez ce paramètre lorsque vous incluez des informations d'authentification dans une chaîne de requête plutôt que dans l'en-tête d'autorisation HTTP.  
Type : chaîne  
Valeurs valides : `AWS4-HMAC-SHA256`   
Obligatoire : Conditionnelle

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
Valeur de la portée des informations d'identification, qui est une chaîne incluant votre clé d'accès, la date, la région cible, le service demandé et une chaîne de terminaison (« aws4\$1request »). Spécifiez la valeur au format suivant : *access\$1key*/*AAAAMMJJ*/*région*/*service*/aws4\$1request.  
Pour plus d'informations, consultez la section [Création d'une demande d' AWS API signée](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) dans le *guide de l'utilisateur IAM*.  
Condition : spécifiez ce paramètre lorsque vous incluez des informations d'authentification dans une chaîne de requête plutôt que dans l'en-tête d'autorisation HTTP.  
Type : chaîne  
Obligatoire : Conditionnelle

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
La date utilisée pour créer la signature. Le format doit être au format de base ISO 8601 (AAAAMMJJ'T'HHMMSS'Z'). Par exemple, la date et l'heure suivantes sont une X-Amz-Date valeur valide :`20120325T120000Z`.  
Condition : X-Amz-Date est un en-tête facultatif pour toutes les demandes. Il peut être utilisé pour signer les demandes. Si l'en-tête Date est spécifié au format de base ISO 8601, X-Amz-Date il n'est pas obligatoire. Lorsqu'il X-Amz-Date est utilisé, il remplace toujours la valeur de l'en-tête Date. Pour plus d'informations, consultez la section [Éléments d'une signature de demande d' AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) dans le *Guide de l'utilisateur IAM*.  
Type : chaîne  
Obligatoire : Conditionnelle

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
Le jeton de sécurité temporaire obtenu par un appel à AWS Security Token Service (AWS STS). Pour obtenir la liste des services prenant en charge les informations d'identification de sécurité temporaires d' AWS STS, consultez [Services AWS qui fonctionnent avec IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) dans le *Guide de l'utilisateur IAM*.  
Condition : Si vous utilisez des informations d'identification de sécurité temporaires provenant de AWS STS, vous devez inclure le jeton de sécurité.  
Type : chaîne  
Obligatoire : Conditionnelle

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Spécifie la signature codée en hexadécimal qui a été calculée à partir de la chaîne à signer et de la clé de signature dérivée.  
Condition : spécifiez ce paramètre lorsque vous incluez des informations d'authentification dans une chaîne de requête plutôt que dans l'en-tête d'autorisation HTTP.  
Type : chaîne  
Obligatoire : Conditionnelle

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Spécifie tous les en-têtes HTTP qui ont été inclus dans la demande canonique. Pour plus d'informations sur la spécification d'en-têtes signés, consultez la section [Créer une demande d' AWS API signée](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) dans le guide de l'*utilisateur IAM*.  
Condition : spécifiez ce paramètre lorsque vous incluez des informations d'authentification dans une chaîne de requête plutôt que dans l'en-tête d'autorisation HTTP.  
Type : chaîne  
Obligatoire : Conditionnelle