本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

SynthesisTask 提供有关语音合成任务信息的对象。

## 内容
<a name="API_SynthesisTask_Contents"></a>

 ** CreationTime **   <a name="polly-Type-SynthesisTask-CreationTime"></a>
合成任务启动时间的时间戳。  
类型：时间戳  
必需：否

 ** Engine **   <a name="polly-Type-SynthesisTask-Engine"></a>
指定 Amazon Polly 在处理输入文本进行语音合成时使用的引擎（`standard`、`neural`、`long-form` 或 `generative`）。使用不受所选引擎支持的语音会导致错误。  
类型：字符串  
有效值：`standard | neural | long-form | generative`  
必需：否

 ** LanguageCode **   <a name="polly-Type-SynthesisTask-LanguageCode"></a>
合成任务的可选语言代码。只有在使用双语语音（例如 Aditi）时才需设置，Aditi 可用于印度英语 (en-IN) 或印地语 (hi-IN)。  
如果使用双语语音但未指定语言代码，则 Amazon Polly 将使用双语语音的默认语言。任何语音的默认语言都是[DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)操作返回的`LanguageCode`参数语言。例如，如果未指定语言代码，Aditi 将使用印度英语而不是印地语。  
类型：字符串  
有效值：`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 **   <a name="polly-Type-SynthesisTask-LexiconNames"></a>
您希望服务在合成过程中应用的一个或多个发音词典名称的列表。仅当词典的语言与语音的语言相同时，才会应用词典。  
类型：字符串数组  
数组成员：最多 5 项。  
模式：`[0-9A-Za-z]{1,20}`  
必需：否

 ** OutputFormat **   <a name="polly-Type-SynthesisTask-OutputFormat"></a>
返回的输出将采用的编码格式。对于音频流，这将是 mp3、ogg\$1vorbis、ogg\$1opus、mu-law、a-law 或 pcm。对于语音标记，格式为 JSON。  
类型：字符串  
有效值：`json | mp3 | ogg_opus | ogg_vorbis | pcm`  
必需：否

 ** OutputUri **   <a name="polly-Type-SynthesisTask-OutputUri"></a>
输出语音文件的路径。  
类型：字符串  
必需：否

 ** RequestCharacters **   <a name="polly-Type-SynthesisTask-RequestCharacters"></a>
合成的可计费字符数。  
类型：整数  
必需：否

 ** SampleRate **   <a name="polly-Type-SynthesisTask-SampleRate"></a>
指定的音频频率，单位为 Hz。  
对于 MP3 和 OGG Vorbis，有效值为“8000”、“16000”、“22050”和“24000”。标准语音的默认值为“22050”。神经语音的默认值为“24000”。长篇语音的默认值为“24000”。生成式语音的默认值为“24000”。  
对于 PCM，有效值为“8000”和“16000”。默认值为“16000”。  
ogg\$1opus 的有效值为 “48000”。  
mu-law 和 a-law 的有效值为 “8000”。  
类型：字符串  
必需：否

 ** SnsTopicArn **   <a name="polly-Type-SynthesisTask-SnsTopicArn"></a>
SNS 主题的 ARN，可用于为语音合成任务提供状态通知。  
类型：字符串  
模式：`^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)$`  
必需：否

 ** SpeechMarkTypes **   <a name="polly-Type-SynthesisTask-SpeechMarkTypes"></a>
为输入文本返回的语音标记的类型。  
类型：字符串数组  
数组成员：最多 4 项。  
有效值：`sentence | ssml | viseme | word`  
必需：否

 ** TaskId **   <a name="polly-Type-SynthesisTask-TaskId"></a>
Amazon Polly 生成的语音合成任务的标识符。  
类型：字符串  
模式：`^[a-zA-Z0-9_-]{1,100}$`  
必需：否

 ** TaskStatus **   <a name="polly-Type-SynthesisTask-TaskStatus"></a>
单个语音合成任务的当前状态。  
类型：字符串  
有效值：`scheduled | inProgress | completed | failed`  
必需：否

 ** TaskStatusReason **   <a name="polly-Type-SynthesisTask-TaskStatusReason"></a>
特定语音合成任务当前状态的原因，包括任务失败时出现的错误。  
类型：字符串  
必需：否

 ** TextType **   <a name="polly-Type-SynthesisTask-TextType"></a>
指定输入文本是纯文本还是 SSML。默认值为纯文本。  
类型：字符串  
有效值：`ssml | text`  
必需：否

 ** VoiceId **   <a name="polly-Type-SynthesisTask-VoiceId"></a>
要用于合成的语音 ID。  
类型：字符串  
有效值：`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`  
必需：否

## 另请参阅
<a name="API_SynthesisTask_SeeAlso"></a>

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesisTask) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesisTask) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesisTask)