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.

# 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)