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

# Amazon Polly API 参考
<a name="API_Reference"></a>

Amazon Polly 是一项 Web 服务，可让您轻松地用文本合成语音。

Amazon Polly 服务提供 API 操作，能够用纯文本和语音合成标记语言（SSML）来合成高质量语音，并管理发音词典，使您能够在自己的应用领域中获得极佳结果。

已验证的 API 调用都必须使用签名版本 4 签名流程签名。有关更多信息，请参阅中的[签署 AWS API 请求*Amazon Web Services 一般参考*](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html)。

**Topics**
+ [操作](API_Operations.md)
+ [数据类型](API_Types.md)
+ [常见错误](CommonErrors.md)
+ [常见参数](CommonParameters.md)

# 操作
<a name="API_Operations"></a>

支持以下操作：
+  [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>

删除 AWS 区域中存储的指定的发音词典。已删除的词典无法用于语音合成，也无法使用`GetLexicon`或`ListLexicon` APIs进行检索。

有关更多信息，请参阅[管理词典](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)。

## 请求语法
<a name="API_DeleteLexicon_RequestSyntax"></a>

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

## URI 请求参数
<a name="API_DeleteLexicon_RequestParameters"></a>

请求使用以下 URI 参数。

 ** [LexiconName](#API_DeleteLexicon_RequestSyntax) **   <a name="polly-DeleteLexicon-request-uri-Name"></a>
要删除的词典的名称。必须是该地区的现有词典。  
模式：`[0-9A-Za-z]{1,20}`  
必需：是

## 请求体
<a name="API_DeleteLexicon_RequestBody"></a>

该请求没有请求正文。

## 响应语法
<a name="API_DeleteLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## 响应元素
<a name="API_DeleteLexicon_ResponseElements"></a>

如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。

## 错误
<a name="API_DeleteLexicon_Errors"></a>

 ** LexiconNotFoundException **   
Amazon Polly 找不到指定的词典。这可能是由于词典缺失、名称拼写错误或指定了位于不同区域的词典所致。  
验证词典是否存在、位于该区域（参阅 [ListLexicons](API_ListLexicons.md)），以及词典名称拼写是否正确。然后请重试。  
HTTP 状态代码：404

 ** ServiceFailureException **   
未知情况导致服务故障。  
HTTP 状态代码：500

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

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DeleteLexicon) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DeleteLexicon) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DeleteLexicon) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DeleteLexicon) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DeleteLexicon) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DeleteLexicon) 

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

返回在请求语音合成时可用的语音列表。每个语音都说一种特定的语言，可以是男性语音也可以是女性语音，并由 ID（即语音名称的 ASCII 版本）标识。

合成语音 (`SynthesizeSpeech`) 时，您需要从 `DescribeVoices` 返回的语音列表中提供所需的语音 ID。

例如，您希望新闻阅读器应用程序以特定语言阅读新闻，但允许用户选择语音。使用 `DescribeVoices` 操作，您可以为用户提供可供选择的可用语音列表。

 您可以选择指定语言代码以筛选可用语音。例如，如果您指定 `en-US`，则该操作将返回所有可用美国英语语音的列表。

此操作需要执行 `polly:DescribeVoices` 操作的权限。

## 请求语法
<a name="API_DescribeVoices_RequestSyntax"></a>

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

## URI 请求参数
<a name="API_DescribeVoices_RequestParameters"></a>

请求使用以下 URI 参数。

 ** [Engine](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-Engine"></a>
指定 Amazon Polly 在处理输入文本进行语音合成时使用的引擎（`standard`、`neural`、`long-form` 或 `generative`）。  
有效值：`standard | neural | long-form | generative`

 ** [IncludeAdditionalLanguageCodes](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-IncludeAdditionalLanguageCodes"></a>
布尔值，表示是否返回使用指定语言作为附加语言的双语语音。例如，如果您请求所有使用美国英语 (es-US) 的语言，并且有一个意大利语语音同时说意大利语 (it-IT) 和美国英语，那么如果您指定 `yes`，则将包含该语音，但如果您指定 `no`，则不会包含该语音。

 ** [LanguageCode](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-LanguageCode"></a>
 用于筛选返回的语音列表的语言标识标签（语言名称的 ISO 639 代码：ISO 3166 国家/地区代码）。如果不指定此可选参数，则返回所有可用的语音。  
有效值：`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>
从上一次 `DescribeVoices` 操作返回的不透明分页标记。如果存在，则表示在哪里继续列出。  
长度限制：最小长度为 0。最大长度为 4096。

## 请求正文
<a name="API_DescribeVoices_RequestBody"></a>

该请求没有请求正文。

## 响应语法
<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" ]
      }
   ]
}
```

## 响应元素
<a name="API_DescribeVoices_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

 ** [NextToken](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-NextToken"></a>
在下一个请求中使用的分页标记，用于继续列出语音。仅当响应被截断时才会返回 `NextToken`。  
类型：字符串  
长度限制：最小长度为 0。最大长度为 4096。

 ** [Voices](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-Voices"></a>
语音及其属性的列表。  
类型：[Voice](API_Voice.md) 对象数组

## 错误
<a name="API_DescribeVoices_Errors"></a>

 ** InvalidNextTokenException **   
 NextToken 无效。确保拼写正确，然后请重试。  
HTTP 状态代码：400

 ** ServiceFailureException **   
未知情况导致服务故障。  
HTTP 状态代码：500

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

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DescribeVoices) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DescribeVoices) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DescribeVoices) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DescribeVoices) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DescribeVoices) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DescribeVoices) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DescribeVoices) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DescribeVoices) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DescribeVoices) 

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

返回 AWS 区域中存储的指定的发音词典的内容。有关更多信息，请参阅[管理词典](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)。

## 请求语法
<a name="API_GetLexicon_RequestSyntax"></a>

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

## URI 请求参数
<a name="API_GetLexicon_RequestParameters"></a>

请求使用以下 URI 参数。

 ** [LexiconName](#API_GetLexicon_RequestSyntax) **   <a name="polly-GetLexicon-request-uri-Name"></a>
词典的名称。  
模式：`[0-9A-Za-z]{1,20}`  
必需：是

## 请求体
<a name="API_GetLexicon_RequestBody"></a>

该请求没有请求正文。

## 响应语法
<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
   }
}
```

## 响应元素
<a name="API_GetLexicon_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

 ** [Lexicon](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-Lexicon"></a>
提供词典名称和字符串内容的词典对象。  
类型：[Lexicon](API_Lexicon.md) 对象

 ** [LexiconAttributes](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-LexiconAttributes"></a>
词典的元数据，包括使用的音标字母、语言代码、词典 ARN、词典中定义的词素数量以及以字节为单位的词典大小。  
类型：[LexiconAttributes](API_LexiconAttributes.md) 对象

## 错误
<a name="API_GetLexicon_Errors"></a>

 ** LexiconNotFoundException **   
Amazon Polly 找不到指定的词典。这可能是由于词典缺失、名称拼写错误或指定了位于不同区域的词典所致。  
验证词典是否存在、位于该区域（参阅 [ListLexicons](API_ListLexicons.md)），以及词典名称拼写是否正确。然后请重试。  
HTTP 状态代码：404

 ** ServiceFailureException **   
未知情况导致服务故障。  
HTTP 状态代码：500

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

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/GetLexicon) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetLexicon) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetLexicon) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetLexicon) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetLexicon) 
+  [AWS JavaScript V3 版 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetLexicon) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetLexicon) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetLexicon) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetLexicon) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetLexicon) 

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

根据特定 SpeechSynthesisTask 对象的 taskID 检索该对象。此对象包含有关给定语音合成任务的信息，包括任务的状态，以及指向包含任务输出的 S3 存储桶的链接。

## 请求语法
<a name="API_GetSpeechSynthesisTask_RequestSyntax"></a>

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

## URI 请求参数
<a name="API_GetSpeechSynthesisTask_RequestParameters"></a>

请求使用以下 URI 参数。

 ** [TaskId](#API_GetSpeechSynthesisTask_RequestSyntax) **   <a name="polly-GetSpeechSynthesisTask-request-uri-TaskId"></a>
Amazon Polly 生成的语音合成任务的标识符。  
模式：`^[a-zA-Z0-9_-]{1,100}$`  
必需：是

## 请求体
<a name="API_GetSpeechSynthesisTask_RequestBody"></a>

该请求没有请求正文。

## 响应语法
<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"
   }
}
```

## 响应元素
<a name="API_GetSpeechSynthesisTask_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

 ** [SynthesisTask](#API_GetSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-GetSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask 对象，它提供所请求任务的信息，包括输出格式、创建时间、任务状态等。  
类型：[SynthesisTask](API_SynthesisTask.md) 对象

## 错误
<a name="API_GetSpeechSynthesisTask_Errors"></a>

 ** InvalidTaskIdException **   
提供的任务 ID 无效。请提供有效的任务 ID，然后重试。  
HTTP 状态代码：400

 ** ServiceFailureException **   
未知情况导致服务故障。  
HTTP 状态代码：500

 ** SynthesisTaskNotFoundException **   
找不到具有请求任务 ID 的语音合成任务。  
HTTP 状态代码：400

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

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetSpeechSynthesisTask) 

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

返回 AWS 区域中存储的发音词典的列表。有关更多信息，请参阅[管理词典](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)。

## 请求语法
<a name="API_ListLexicons_RequestSyntax"></a>

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

## URI 请求参数
<a name="API_ListLexicons_RequestParameters"></a>

请求使用以下 URI 参数。

 ** [NextToken](#API_ListLexicons_RequestSyntax) **   <a name="polly-ListLexicons-request-uri-NextToken"></a>
从上一次 `ListLexicons` 操作返回的不透明分页标记。如果存在，则表示在哪里继续列出词典。  
长度限制：最小长度为 0。最大长度为 4096。

## 请求正文
<a name="API_ListLexicons_RequestBody"></a>

该请求没有请求正文。

## 响应语法
<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"
}
```

## 响应元素
<a name="API_ListLexicons_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

 ** [Lexicons](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-Lexicons"></a>
词典名称和属性的列表。  
类型：[LexiconDescription](API_LexiconDescription.md) 对象数组

 ** [NextToken](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-NextToken"></a>
在下一个请求中使用的分页标记，用于继续列出词典。仅当响应被截断时才会返回 `NextToken`。  
类型：字符串  
长度限制：最小长度为 0。最大长度为 4096。

## 错误
<a name="API_ListLexicons_Errors"></a>

 ** InvalidNextTokenException **   
 NextToken 无效。确保拼写正确，然后请重试。  
HTTP 状态代码：400

 ** ServiceFailureException **   
未知情况导致服务故障。  
HTTP 状态代码：500

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

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/ListLexicons) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListLexicons) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListLexicons) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListLexicons) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListLexicons) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListLexicons) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListLexicons) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListLexicons) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListLexicons) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListLexicons) 

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

返回按创建日期排序的 SpeechSynthesisTask 对象列表。此操作可以按任务状态筛选任务，例如，允许用户仅列出已完成的任务。

## 请求语法
<a name="API_ListSpeechSynthesisTasks_RequestSyntax"></a>

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

## URI 请求参数
<a name="API_ListSpeechSynthesisTasks_RequestParameters"></a>

请求使用以下 URI 参数。

 ** [MaxResults](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-MaxResults"></a>
在列表操作中返回的最大语音合成任务数。  
有效范围：最小值为 1。最大值为 100。

 ** [NextToken](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-NextToken"></a>
在下一个请求中使用的分页标记，用于继续列出语音合成任务。  
长度限制：最小长度为 0。最大长度为 4096。

 ** [Status](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-Status"></a>
在列表操作中返回的语音合成任务的状态  
有效值：`scheduled | inProgress | completed | failed`

## 请求正文
<a name="API_ListSpeechSynthesisTasks_RequestBody"></a>

该请求没有请求正文。

## 响应语法
<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"
      }
   ]
}
```

## 响应元素
<a name="API_ListSpeechSynthesisTasks_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

 ** [NextToken](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-NextToken"></a>
此请求中从上一次列表操作返回的不透明分页标记。如果存在，则表示在哪里继续列出。  
类型：字符串  
长度限制：最小长度为 0。最大长度为 4096。

 ** [SynthesisTasks](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-SynthesisTasks"></a>
提供列表请求中指定任务信息的 SynthesisTask 对象列表，包括输出格式、创建时间、任务状态等。  
类型：[SynthesisTask](API_SynthesisTask.md) 对象数组

## 错误
<a name="API_ListSpeechSynthesisTasks_Errors"></a>

 ** InvalidNextTokenException **   
 NextToken 无效。确保拼写正确，然后请重试。  
HTTP 状态代码：400

 ** ServiceFailureException **   
未知情况导致服务故障。  
HTTP 状态代码：500

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

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListSpeechSynthesisTasks) 

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

在 AWS 区域中存储一个发音词典。如果区域中已存在同名词典，则新词典将覆盖该词典。词典操作具有最终一致性，因此，可能需要一段时间才能使用该词典。 SynthesizeSpeech 

有关更多信息，请参阅[管理词典](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)。

## 请求语法
<a name="API_PutLexicon_RequestSyntax"></a>

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

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

## URI 请求参数
<a name="API_PutLexicon_RequestParameters"></a>

请求使用以下 URI 参数。

 ** [LexiconName](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-uri-Name"></a>
词典的名称。名称必须遵循正则表达式格式 [0-9A-Za-z]\$11,20\$1。也就是说，该名称是一个区分大小写的字母数字字符串，长度最多为 20 个字符。  
模式：`[0-9A-Za-z]{1,20}`  
必需：是

## 请求体
<a name="API_PutLexicon_RequestBody"></a>

请求接受采用 JSON 格式的以下数据。

 ** [Content](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-Content"></a>
PLS 词典的内容作为字符串数据。  
类型：字符串  
是否必需：是

## 响应语法
<a name="API_PutLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## 响应元素
<a name="API_PutLexicon_ResponseElements"></a>

如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。

## 错误
<a name="API_PutLexicon_Errors"></a>

 ** InvalidLexiconException **   
Amazon Polly 找不到指定的词典。确保词典名称拼写正确，然后请重试。  
HTTP 状态代码：400

 ** LexiconSizeExceededException **   
此操作将超过指定词典的最大大小。  
HTTP 状态代码：400

 ** MaxLexemeLengthExceededException **   
此操作将超过词素的最大大小。  
HTTP 状态代码：400

 ** MaxLexiconsNumberExceededException **   
此操作将超过最大词典数量。  
HTTP 状态代码：400

 ** ServiceFailureException **   
未知情况导致服务故障。  
HTTP 状态代码：500

 ** UnsupportedPlsAlphabetException **   
词典指定的字母不受支持。有效值为 `x-sampa` 和 `ipa`。  
HTTP 状态代码：400

 ** UnsupportedPlsLanguageException **   
不支持词典中指定的语言。有关受支持的语言的列表，请参阅[词典属性](https://docs.aws.amazon.com/polly/latest/dg/API_LexiconAttributes.html)。  
HTTP 状态代码：400

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

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/PutLexicon) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/PutLexicon) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/PutLexicon) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/PutLexicon) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/PutLexicon) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/PutLexicon) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/PutLexicon) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/PutLexicon) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/PutLexicon) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/PutLexicon) 

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

通过双向流媒体连接合成 UTF-8 输入、纯文本或 SSML。在 HTTP/2 标头中指定合成参数，将文本作为输入流上的事件递增发送，并在合成音频可用时接收合成的音频。

此操作可作为双向`SynthesizeSpeech`对应物：
+  [SynthesizeSpeech](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html) 

## 请求语法
<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"
   }
}
```

## URI 请求参数
<a name="API_StartSpeechSynthesisStream_RequestParameters"></a>

请求使用以下 URI 参数。

 ** [Engine](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-Engine"></a>
指定 Amazon Polly 在处理语音合成输入文本时使用的引擎。当前，仅支持该`generative`引擎。如果您指定了所选引擎不支持的声音，Amazon Polly 将返回错误。  
有效值：`standard | neural | long-form | generative`  
是否必需：是

 ** [LanguageCode](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LanguageCode"></a>
一个可选参数，用于设置语音合成请求的语言代码。只有在使用双语语音时才指定此参数。如果使用双语语音但未指定语言代码，则 Amazon Polly 将使用双语语音的默认语言。  
有效值：`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>
服务在合成过程中要应用的一个或多个发音词典的名称。只有当词典语言与语音语言匹配时，Amazon Polly 才会应用词典。  
数组成员：最多 5 项。  
模式：`[0-9A-Za-z]{1,20}`

 ** [OutputFormat](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-OutputFormat"></a>
合成语音的音频格式。目前，Amazon Polly 不支持 JSON 语音标记。  
有效值：`json | mp3 | ogg_opus | ogg_vorbis | pcm`  
是否必需：是

 ** [SampleRate](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-SampleRate"></a>
音频频率，以 Hz 为单位指定。

 ** [VoiceId](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-VoiceId"></a>
合成中要使用的声音。要获取可用语音列表 IDs，请使用[DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)操作。  
有效值：`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_StartSpeechSynthesisStream_RequestBody"></a>

请求接受采用 JSON 格式的以下数据。

 ** [CloseStreamEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-CloseStreamEvent"></a>
一个表示输入流结束的事件。  
类型：[CloseStreamEvent](API_CloseStreamEvent.md) 对象  
必需：否

 ** [TextEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-TextEvent"></a>
包含待合成内容的文本事件。  
类型：[TextEvent](API_TextEvent.md) 对象  
必需：否

## 响应语法
<a name="API_StartSpeechSynthesisStream_ResponseSyntax"></a>

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

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

## 响应元素
<a name="API_StartSpeechSynthesisStream_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

 ** [AudioEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-AudioEvent"></a>
包含合成语音的音频事件。  
类型：[AudioEvent](API_AudioEvent.md) 对象

 ** [ServiceFailureException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceFailureException"></a>
未知情况导致服务故障。  
类型：异常  
HTTP 状态代码：500

 ** [ServiceQuotaExceededException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceQuotaExceededException"></a>
表示将超过服务配额的异常。  
类型：异常  
HTTP 状态代码：402

 ** [StreamClosedEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-StreamClosedEvent"></a>
带有摘要信息的事件，表示直播已关闭。  
类型：[StreamClosedEvent](API_StreamClosedEvent.md) 对象

 ** [ThrottlingException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ThrottlingException"></a>
表示请求已被限制的异常。  
类型：异常  
HTTP 状态代码：400

 ** [ValidationException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ValidationException"></a>
表示输入未通过验证的异常。  
类型：异常  
HTTP 状态代码：400

## 错误
<a name="API_StartSpeechSynthesisStream_Errors"></a>

 ** ServiceFailureException **   
未知情况导致服务故障。  
HTTP 状态代码：500

 ** ServiceQuotaExceededException **   
该请求会导致超出服务限额。    
 ** quotaCode **   
标识特定配额的配额代码。  
 ** serviceCode **   
标识源服务的服务代码。
HTTP 状态代码：402

 ** ThrottlingException **   
由于请求限制，该请求被拒绝。    
 ** throttlingReasons **   
解释请求被限制的原因列表。
HTTP 状态代码：400

 ** ValidationException **   
输入未能满足 服务指定的约束。    
 ** fields **   
导致验证错误的字段。  
 ** reason **   
请求验证失败的原因。
HTTP 状态代码：400

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

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStream) 

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

允许通过启动新 `SpeechSynthesisTask` 来创建异步合成任务。此操作需要语音合成所需的所有标准信息，以及用于存储合成任务输出的 Amazon S3 存储桶的名称和两个可选参数（`OutputS3KeyPrefix` 和 `SnsTopicArn`）。合成任务创建后，此操作将返回一个 `SpeechSynthesisTask` 对象，其中将包括该任务的标识符以及当前状态。启动异步合成任务后，该 `SpeechSynthesisTask` 对象在 72 小时内可用。

## 请求语法
<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"
}
```

## URI 请求参数
<a name="API_StartSpeechSynthesisTask_RequestParameters"></a>

该请求不使用任何 URI 参数。

## 请求正文
<a name="API_StartSpeechSynthesisTask_RequestBody"></a>

请求接受采用 JSON 格式的以下数据。

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

 ** [LanguageCode](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-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](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LexiconNames"></a>
您希望服务在合成过程中应用的一个或多个发音词典名称的列表。仅当词典的语言与语音的语言相同时，才会应用词典。  
类型：字符串数组  
数组成员：最多 5 项。  
模式：`[0-9A-Za-z]{1,20}`  
必需：否

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

 ** [OutputS3BucketName](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3BucketName"></a>
将保存输出文件的 Amazon S3 存储桶名称。  
类型：字符串  
模式：`^[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]$`  
是否必需：是

 ** [OutputS3KeyPrefix](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3KeyPrefix"></a>
输出语音文件的 Amazon S3 键前缀。  
类型：字符串  
模式：`^[0-9a-zA-Z\/\!\-_\.\*\'\(\):;\$@=+\,\?&]{0,800}$`  
必需：否

 ** [SampleRate](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-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](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-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](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SpeechMarkTypes"></a>
为输入文本返回的语音标记的类型。  
类型：字符串数组  
数组成员：最多 4 项。  
有效值：`sentence | ssml | viseme | word`  
必需：否

 ** [Text](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Text"></a>
要合成的输入文本。如果您将 ssml 指定为 TextType，请按照 SSML 格式输入文本。  
类型：字符串  
是否必需：是

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

 ** [VoiceId](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-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_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"
   }
}
```

## 响应元素
<a name="API_StartSpeechSynthesisTask_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

 ** [SynthesisTask](#API_StartSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask 对象，提供有关新提交的语音合成任务的信息和属性。  
类型：[SynthesisTask](API_SynthesisTask.md) 对象

## 错误
<a name="API_StartSpeechSynthesisTask_Errors"></a>

 ** EngineNotSupportedException **   
此引擎与您指定的语音不兼容。选择与引擎兼容的新语音，或者更换引擎并重新开始操作。  
HTTP 状态代码：400

 ** InvalidS3BucketException **   
提供的 Amazon S3 存储桶名称无效。请检查您输入的 S3 存储桶命名要求并重试。  
HTTP 状态代码：400

 ** InvalidS3KeyException **   
提供的 Amazon S3 键前缀无效。请提供有效的 S3 对象键名称。  
HTTP 状态代码：400

 ** InvalidSampleRateException **   
指定的采样率无效。  
HTTP 状态代码：400

 ** InvalidSnsTopicArnException **   
提供的 SNS 主题 ARN 无效。请提供有效的 SNS 主题 ARN 并重试。  
HTTP 状态代码：400

 ** InvalidSsmlException **   
您提供的 SSML 无效。验证 SSML 语法、标签和值拼写，然后重试。  
HTTP 状态代码：400

 ** LanguageNotSupportedException **   
Amazon Polly 目前不支持使用指定的语言。  
HTTP 状态代码：400

 ** LexiconNotFoundException **   
Amazon Polly 找不到指定的词典。这可能是由于词典缺失、名称拼写错误或指定了位于不同区域的词典所致。  
验证词典是否存在、位于该区域（参阅 [ListLexicons](API_ListLexicons.md)），以及词典名称拼写是否正确。然后请重试。  
HTTP 状态代码：404

 ** MarksNotSupportedForFormatException **   
所选 `OutputFormat` 不支持语音标记。语音标记仅适用于 `json` 格式的内容。  
HTTP 状态代码：400

 ** ServiceFailureException **   
未知情况导致服务故障。  
HTTP 状态代码：500

 ** SsmlMarksNotSupportedForTextTypeException **   
纯文本类型输入不支持 SSML 语音标记。  
HTTP 状态代码：400

 ** TextLengthExceededException **   
“文本”参数的值长于可接受的限制值。对于 `SynthesizeSpeech` API，输入文本的总长度限制为最多 6000 个字符，其中计费字符不能超过 3000 个。对于 `StartSpeechSynthesisTask` API，最大值为 20 万个字符，其中计费字符数不得超过 10 万个。SSML 标签不会算作计费字符。  
HTTP 状态代码：400

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

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisTask) 

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

将 UTF-8 输入、纯文本或 SSML 合成为字节流。SSML 输入必须是有效的、格式正确的 SSML。除非使用音素映射，否则某些字母可能无法用于所有语音（例如，英语语音可能根本无法读取西里尔语）。有关更多信息，请参阅[工作原理](https://docs.aws.amazon.com/polly/latest/dg/how-text-to-speech-works.html)。

## 请求语法
<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"
}
```

## URI 请求参数
<a name="API_SynthesizeSpeech_RequestParameters"></a>

该请求不使用任何 URI 参数。

## 请求正文
<a name="API_SynthesizeSpeech_RequestBody"></a>

请求接受采用 JSON 格式的以下数据。

 ** [Engine](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Engine"></a>
指定 Amazon Polly 在处理输入文本进行语音合成时使用的引擎（`standard`、`neural`、`long-form` 或 `generative`）。提供您选定的语音所支持的引擎。如果您未提供引擎，则默认情况下选择标准引擎。如果标准引擎不支持所选语音，则会导致出错。有关 Amazon Polly 语音以及每个引擎可用的语音的信息，请参阅[可用语音](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html)。  
类型：字符串  
有效值：`standard | neural | long-form | generative`  
必需：否

 ** [LanguageCode](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-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](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LexiconNames"></a>
您希望服务在合成过程中应用的一个或多个发音词典名称的列表。仅当词典的语言与语音的语言相同时，才会应用词典。有关存储词典的信息，请参见[PutLexicon](https://docs.aws.amazon.com/polly/latest/dg/API_PutLexicon.html)。  
类型：字符串数组  
数组成员：最多 5 项。  
模式：`[0-9A-Za-z]{1,20}`  
必需：否

 ** [OutputFormat](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-OutputFormat"></a>
 返回的输出将采用的编码格式。对于音频流，这将是 mp3、ogg\$1vorbis、ogg\$1opus、mu-law、a-law 或 pcm。对于语音标记，格式为 JSON。  
使用 pcm 时，返回的内容采用带符号的 audio/pcm 16 位、1 通道（mono）、小端格式。  
类型：字符串  
有效值：`json | mp3 | ogg_opus | ogg_vorbis | pcm`  
是否必需：是

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

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

 ** [Text](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Text"></a>
 输入要合成的文本。如果指定 `ssml` 为 `TextType`，请按照 SSML 格式输入文本。  
类型：字符串  
是否必需：是

 ** [TextType](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-TextType"></a>
 指定输入文本是纯文本还是 SSML。默认值为纯文本。有关更多信息，请参阅[使用 SSML](https://docs.aws.amazon.com/polly/latest/dg/ssml.html)。  
类型：字符串  
有效值：`ssml | text`  
必需：否

 ** [VoiceId](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-VoiceId"></a>
 要用于合成的语音 ID。您可以 IDs 通过拨打[DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)操作来获取可用语音列表。  
类型：字符串  
有效值：`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_SynthesizeSpeech_ResponseSyntax"></a>

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

AudioStream
```

## 响应元素
<a name="API_SynthesizeSpeech_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

响应将返回以下 HTTP 标头。

 ** [ContentType](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-ContentType"></a>
 指定音频流的类型。这应该反映您的请求中的 `OutputFormat` 参数。  
+  如果您请求 `mp3` 为 `OutputFormat`，则 `ContentType` 返回的是音频/MPEG。
+  如果您请求 `ogg_vorbis` 为 `OutputFormat`，则 `ContentType` 返回的是音频/OGG。
+  如果您请求 `ogg_opus` 为 `OutputFormat`，则 `ContentType` 返回的是音频/OGG。
+  如果您请求`pcm`为`OutputFormat`，则`ContentType`返回的格式为带符号的 audio/pcm 16 位、1 通道 (mono)、小端字节序格式。
+  如果您请求`mu-law`为`OutputFormat`，则`ContentType`返回的是音频/mulaw。
+  如果您`a-law`以的身份请求`OutputFormat`，则`ContentType`返回的是音频/alaw。
+ 如果您请求`json`为`OutputFormat`，则`ContentType`返回的是应用程序/ x-json-stream。
 

 ** [RequestCharacters](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-RequestCharacters"></a>
合成的字符数。

响应将以下内容作为 HTTP 正文返回。

 ** [AudioStream](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-AudioStream"></a>
 包含合成语音的流。

## 错误
<a name="API_SynthesizeSpeech_Errors"></a>

 ** EngineNotSupportedException **   
此引擎与您指定的语音不兼容。选择与引擎兼容的新语音，或者更换引擎并重新开始操作。  
HTTP 状态代码：400

 ** InvalidSampleRateException **   
指定的采样率无效。  
HTTP 状态代码：400

 ** InvalidSsmlException **   
您提供的 SSML 无效。验证 SSML 语法、标签和值拼写，然后重试。  
HTTP 状态代码：400

 ** LanguageNotSupportedException **   
Amazon Polly 目前不支持使用指定的语言。  
HTTP 状态代码：400

 ** LexiconNotFoundException **   
Amazon Polly 找不到指定的词典。这可能是由于词典缺失、名称拼写错误或指定了位于不同区域的词典所致。  
验证词典是否存在、位于该区域（参阅 [ListLexicons](API_ListLexicons.md)），以及词典名称拼写是否正确。然后请重试。  
HTTP 状态代码：404

 ** MarksNotSupportedForFormatException **   
所选 `OutputFormat` 不支持语音标记。语音标记仅适用于 `json` 格式的内容。  
HTTP 状态代码：400

 ** ServiceFailureException **   
未知情况导致服务故障。  
HTTP 状态代码：500

 ** SsmlMarksNotSupportedForTextTypeException **   
纯文本类型输入不支持 SSML 语音标记。  
HTTP 状态代码：400

 ** TextLengthExceededException **   
“文本”参数的值长于可接受的限制值。对于 `SynthesizeSpeech` API，输入文本的总长度限制为最多 6000 个字符，其中计费字符不能超过 3000 个。对于 `StartSpeechSynthesisTask` API，最大值为 20 万个字符，其中计费字符数不得超过 10 万个。SSML 标签不会算作计费字符。  
HTTP 状态代码：400

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

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesizeSpeech) 

# 数据类型
<a name="API_Types"></a>

支持以下数据类型：
+  [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>

包含一大块合成的音频数据。

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

 ** AudioChunk **   <a name="polly-Type-AudioEvent-AudioChunk"></a>
以参数指定的格式编码的合成音频数据块。`OutputFormat`  
类型：Base64 编码的二进制数据对象  
必需：否

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

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

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

表示输入流的结束。发送此事件后，输入流将被关闭并返回所有音频。

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

此例外结构的成员取决于上下文。

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

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

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

控制何时在输出流上发送合成音频数据的配置。

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

 ** Force **   <a name="polly-Type-FlushStreamConfiguration-Force"></a>
指定是否强制合成引擎立即将缓冲的音频数据写入输出流。  
类型：布尔值  
必需：否

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

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

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

以字符串格式提供词典名称和词典内容。有关更多信息，请参阅[发音词典规范 (PLS) 1.0 版](https://www.w3.org/TR/pronunciation-lexicon/)。

## 目录
<a name="API_Lexicon_Contents"></a>

 ** Content **   <a name="polly-Type-Lexicon-Content"></a>
字符串格式的词典内容。词典的内容必须采用 PLS 格式。  
类型：字符串  
必需：否

 ** Name **   <a name="polly-Type-Lexicon-Name"></a>
词典的名称。  
类型：字符串  
模式：`[0-9A-Za-z]{1,20}`  
必需：否

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

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

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

包含描述词典的元数据，例如词素数量、语言代码等。有关更多信息，请参阅[管理词典](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)。

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

 ** Alphabet **   <a name="polly-Type-LexiconAttributes-Alphabet"></a>
词典中使用的语音字母。有效值为 `ipa` 和 `x-sampa`。  
类型：字符串  
必需：否

 ** LanguageCode **   <a name="polly-Type-LexiconAttributes-LanguageCode"></a>
词典适用的语言代码。例如，语言代码为“en”的词典将应用于所有英语语言（en-GB、en-US、en-AUS、en-WLS 等）。  
类型：字符串  
有效值：`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`  
必需：否

 ** LastModified **   <a name="polly-Type-LexiconAttributes-LastModified"></a>
上次修改词典的日期（时间戳值）。  
类型：时间戳  
必需：否

 ** LexemesCount **   <a name="polly-Type-LexiconAttributes-LexemesCount"></a>
词典中的词素数量。  
类型：整数  
必需：否

 ** LexiconArn **   <a name="polly-Type-LexiconAttributes-LexiconArn"></a>
词典的 Amazon 资源名称 (ARN)。  
类型：字符串  
必需：否

 ** Size **   <a name="polly-Type-LexiconAttributes-Size"></a>
词典的总大小（以字符为单位）。  
类型：整数  
必需：否

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

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

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

描述词典的内容。

## 目录
<a name="API_LexiconDescription_Contents"></a>

 ** Attributes **   <a name="polly-Type-LexiconDescription-Attributes"></a>
提供词典元数据。  
类型：[LexiconAttributes](API_LexiconAttributes.md) 对象  
必需：否

 ** Name **   <a name="polly-Type-LexiconDescription-Name"></a>
词典的名称。  
类型：字符串  
模式：`[0-9A-Za-z]{1,20}`  
必需：否

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

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

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

入站事件流，用于发送输入和控制事件以管理双向语音合成。

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

 ** CloseStreamEvent **   <a name="polly-Type-StartSpeechSynthesisStreamActionStream-CloseStreamEvent"></a>
一个表示输入流结束的事件。  
类型：[CloseStreamEvent](API_CloseStreamEvent.md) 对象  
必需：否

 ** TextEvent **   <a name="polly-Type-StartSpeechSynthesisStreamActionStream-TextEvent"></a>
包含待合成内容的文本事件。  
类型：[TextEvent](API_TextEvent.md) 对象  
必需：否

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

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

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

包含合成音频数据和流状态事件的出站事件流。

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

 ** AudioEvent **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-AudioEvent"></a>
包含合成语音的音频事件。  
类型：[AudioEvent](API_AudioEvent.md) 对象  
必需：否

 ** ServiceFailureException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceFailureException"></a>
未知情况导致服务故障。  
类型：异常  
HTTP 状态代码：500  
必需：否

 ** ServiceQuotaExceededException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceQuotaExceededException"></a>
表示将超过服务配额的异常。  
类型：异常  
HTTP 状态代码：402  
必需：否

 ** StreamClosedEvent **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-StreamClosedEvent"></a>
带有摘要信息的事件，表示直播已关闭。  
类型：[StreamClosedEvent](API_StreamClosedEvent.md) 对象  
必需：否

 ** ThrottlingException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ThrottlingException"></a>
表示请求已被限制的异常。  
类型：异常  
HTTP 状态代码：400  
必需：否

 ** ValidationException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ValidationException"></a>
表示输入未通过验证的异常。  
类型：异常  
HTTP 状态代码：400  
必需：否

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

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

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

表示合成流已关闭并提供摘要信息。

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

 ** RequestCharacters **   <a name="polly-Type-StreamClosedEvent-RequestCharacters"></a>
直播会话期间合成的角色总数。  
类型：整数  
必需：否

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

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

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

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

包含要合成语音的文本内容。

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

 ** Text **   <a name="polly-Type-TextEvent-Text"></a>
要合成的文本内容。如果指定 `ssml` 为 `TextType`，请按照 SSML 格式输入文本。  
类型：字符串  
是否必需：是

 ** FlushStreamConfiguration **   <a name="polly-Type-TextEvent-FlushStreamConfiguration"></a>
用于控制合成音频何时刷新到输出流的配置。  
类型：[FlushStreamConfiguration](API_FlushStreamConfiguration.md) 对象  
必需：否

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

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

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

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

提供有关特定限制原因的信息。

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

 ** reason **   <a name="polly-Type-ThrottlingReason-reason"></a>
解释请求受限原因的原因代码。  
类型：字符串  
必需：否

 ** resource **   <a name="polly-Type-ThrottlingReason-resource"></a>
导致限制的资源。  
类型：字符串  
必需：否

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

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

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

有关验证失败的字段的信息。

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

 ** message **   <a name="polly-Type-ValidationExceptionField-message"></a>
一条消息，描述该字段验证失败的原因。  
类型：字符串  
是否必需：是

 ** name **   <a name="polly-Type-ValidationExceptionField-name"></a>
验证失败的字段的名称。  
类型：字符串  
必需：是

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

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

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

语音描述。

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

 ** AdditionalLanguageCodes **   <a name="polly-Type-Voice-AdditionalLanguageCodes"></a>
除默认语言外，指定语音还可用的其他语言代码。  
例如，Aditi 的默认语言是印度英语 (en-IN)，因为它最初用于该语言。由于 Aditi 会说双语，并且精通印度英语和印地语，因而此参数将显示代码 `hi-IN`。  
类型：字符串数组  
有效值：`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`  
必需：否

 ** Gender **   <a name="polly-Type-Voice-Gender"></a>
语音的性别。  
类型：字符串  
有效值：`Female | Male`  
必需：否

 ** Id **   <a name="polly-Type-Voice-Id"></a>
Amazon Polly 分配的语音 ID。这是您调用 `SynthesizeSpeech` 操作时指定的 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`  
必需：否

 ** LanguageCode **   <a name="polly-Type-Voice-LanguageCode"></a>
语音的语言代码。  
类型：字符串  
有效值：`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`  
必需：否

 ** LanguageName **   <a name="polly-Type-Voice-LanguageName"></a>
语言的用户可读英文名称。  
类型：字符串  
必需：否

 ** Name **   <a name="polly-Type-Voice-Name"></a>
语音的名称（例如 Salli、Kendra 等）。提供了用户可读的语音名称，您可以在应用程序中显示该名称。  
类型：字符串  
必需：否

 ** SupportedEngines **   <a name="polly-Type-Voice-SupportedEngines"></a>
指定给定语音支持哪些引擎（`standard`、`neural`、`long-form` 或 `generative`）。  
类型：字符串数组  
有效值：`standard | neural | long-form | generative`  
必需：否

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

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

# 常见错误
<a name="CommonErrors"></a>

本部分列出了所有 AWS 服务的常见 API 操作错误。对于特定于此服务的 API 操作的错误，请参阅该 API 操作的主题。

 **AccessDeniedException**   
您没有足够的访问权限，无法执行该操作。  
HTTP 状态代码：400

 **IncompleteSignature**   
请求签名不符合 AWS 标准。  
HTTP 状态代码：400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
由于未知错误、异常或故障，请求处理失败。  
HTTP 状态代码：500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
所请求的操作无效。确认正确键入了操作。  
HTTP 状态代码：400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
在我们的记录中没有所提供的 X.509 证书或 AWS 访问密钥 ID。  
HTTP 状态代码：403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
您无权执行此操作。  
HTTP 状态代码：400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
AWS 访问密钥 ID 需要订阅服务。  
HTTP 状态代码：403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
请求到达服务的时间超过请求上的日期戳 15 分钟或超过请求到期日期 15 分钟（例如，对于预签名 URL），或者请求上的日期戳比当前时间晚了 15 分钟以上。  
HTTP 状态代码：400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
由于服务器发生临时故障而导致请求失败。  
HTTP 状态代码：503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
由于请求限制而导致请求被拒绝。  
HTTP 状态代码：400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
输入未能满足 AWS 服务指定的约束。  
HTTP 状态代码：400

# 常见参数
<a name="CommonParameters"></a>

以下列表包含所有操作用于使用查询字符串对 Signature Version 4 请求进行签名的参数。任何特定于操作的参数都列在该操作的主题中。有关签名版本 4 的更多信息，请参阅 I *AM 用户指南*中的[签署 AWS API 请求](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)。

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
您用于创建请求签名的哈希算法。  
条件：当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时，请指定此参数。  
类型：字符串  
有效值：`AWS4-HMAC-SHA256`  
必需：条件

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
凭证范围值，该值是一个字符串，其中包含您的访问密钥、日期、您要定位的区域、您请求的服务以及终止字符串（“aws4\$1request”）。值采用以下格式表示：*access\$1key*/*YYYYMMDD*/*region*/*service*/aws4\$1request。  
有关更多信息，请参阅 I *AM 用户指南*中的[创建已签名的 AWS API 请求](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)。  
条件：当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时，请指定此参数。  
类型：字符串  
必需：条件

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
用于创建签名的日期。格式必须为 ISO 8601 基本格式 (YYYYMMDD'T'HHMMSS'Z')。例如，以下日期时间是有效 X-Amz-Date值：`20120325T120000Z`。  
条件： X-Amz-Date 对所有请求而言是可选的；它可以用于覆盖对请求签名所使用的日期。如果日期标题以 ISO 8601 基本格式指定，则 X-Amz-Date不是必填项。使用 X-Amz-Date时，它总是会覆盖 Date 标题的值。有关更多信息，请参阅 I *AM 用户指南*中的 [AWS API 请求签名元素](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html)。  
类型：字符串  
必需：条件

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
通过调用 AWS Security Token Service (AWS STS) 获得的临时安全令牌。有关支持来自 AWS STS的临时安全凭证的服务列表，请参阅《IAM 用户指南》**中的[使用 IAM 的AWS 服务](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。  
条件：如果您使用的是中的临时安全证书 AWS STS，则必须包含安全令牌。  
类型：字符串  
必需：条件

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
指定从要签名的字符串和派生的签名密钥计算的十六进制编码签名。  
条件：当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时，请指定此参数。  
类型：字符串  
必需：条件

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
指定作为规范请求的一部分包含的所有 HTTP 标头。有关指定签名标头的更多信息，请参阅 I *AM 用户指南*中的[创建已签名的 AWS API 请求](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)。  
条件：当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时，请指定此参数。  
类型：字符串  
必需：条件