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. # StartSpeechSynthesisTask 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 ``` 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 La demande n’utilise pas de paramètres URI. ## Corps de la demande Cette demande accepte les données suivantes au format JSON. ** [Engine](#API_StartSpeechSynthesisTask_RequestSyntax) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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 ``` 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 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) ** 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 ** 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 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)