本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

Amazon Polly 是一種 Web 服務，可讓您輕鬆地從文字合成語音。

Amazon Polly 服務提供從純文字和語音合成標記語言 (SSML) 合成高品質語音的 API 操作，以及管理發音語彙，讓您能夠取得應用程式網域的最佳結果。

已驗證的 API 呼叫必須使用簽章第 4 版簽署程序簽署。如需詳細資訊，請參閱《》中的[簽署 AWS API 請求](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html)*Amazon Web Services 一般參考*。

**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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DeleteLexicon) 
+  [AWS 適用於 .NET V4 的 SDK](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 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS 適用於 JavaScript V3 的 SDK](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 V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS 適用於 Python 的 SDK](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`) 時，您可以從 傳回的語音清單中，提供所需語音的語音 ID`DescribeVoices`。

例如，您希望新聞閱讀器應用程式讀取特定語言的新聞，但提供使用者選擇語音的選項。使用 `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 3166 國家/地區代碼的 ISO 639 代碼），用於篩選傳回的語音清單。如果您未指定此選用參數，則會傳回所有可用的語音。  
有效值:`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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DescribeVoices) 
+  [AWS 適用於 .NET V4 的 SDK](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 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DescribeVoices) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices) 
+  [AWS 適用於 JavaScript V3 的 SDK](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 V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DescribeVoices) 
+  [AWS 適用於 Python 的 SDK](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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/GetLexicon) 
+  [AWS 適用於 .NET V4 的 SDK](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 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetLexicon) 
+  [AWS 適用於 Java V2 的 SDK](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 V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetLexicon) 
+  [AWS 適用於 Python 的 SDK](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>

根據其 TaskID 擷取特定的 SpeechSynthesisTask 物件。此物件包含指定語音合成任務的相關資訊，包括任務的狀態，以及包含任務輸出的 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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS 適用於 .NET V4 的 SDK](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 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS 適用於 JavaScript V3 的 SDK](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 V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS 適用於 Python 的 SDK](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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/ListLexicons) 
+  [AWS 適用於 .NET V4 的 SDK](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 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListLexicons) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListLexicons) 
+  [AWS 適用於 JavaScript V3 的 SDK](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 V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListLexicons) 
+  [AWS 適用於 Python 的 SDK](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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS 適用於 .NET V4 的 SDK](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 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS 適用於 JavaScript V3 的 SDK](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 V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS 適用於 Python 的 SDK](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 **   
此操作會超過 lexeme 的大小上限。  
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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/PutLexicon) 
+  [AWS 適用於 .NET V4 的 SDK](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 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/PutLexicon) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/PutLexicon) 
+  [AWS 適用於 JavaScript V3 的 SDK](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 V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/PutLexicon) 
+  [AWS 適用於 Python 的 SDK](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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS 適用於 .NET V4 的 SDK](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 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS 適用於 JavaScript V3 的 SDK](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 V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS 適用於 Python 的 SDK](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 時才需要，可用於印度英文 (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\$1vorbis 的有效值為 "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 **   
"Text" 參數的值超過接受的限制。對於 `SynthesizeSpeech` API，輸入文字的限制總計最多為 6000 個字元，其中不超過 3000 個字元可以計費。對於 `StartSpeechSynthesisTask` API，上限為 200，000 個字元，其中不超過 100，000 個字元可以計費。SSML 標籤不計為收費字元。  
HTTP 狀態碼：400

## 另請參閱
<a name="API_StartSpeechSynthesisTask_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS 適用於 .NET V4 的 SDK](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 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS 適用於 JavaScript V3 的 SDK](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 V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS 適用於 Python 的 SDK](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。除非使用音素映射，否則某些字母可能無法用於所有語音 （例如，英文語音可能完全無法讀取 Cyrillic)。如需詳細資訊，請參閱[其運作方式](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 在處理語音合成的輸入文字時要使用的引擎 (`long-form`、、`standard` `neural`或 `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 等雙語語音時，才需要此語音，可用於印度英文 (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 時，傳回的內容會以帶正負號的 16 位元、1 聲道 （單聲道）、小端格式顯示音訊/pcm。  
類型：字串  
有效值:`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。您可以呼叫 [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html) 操作，以取得可用語音 IDs 的清單。  
類型：字串  
有效值:`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_opus`身分請求 `OutputFormat`，則`ContentType`傳回的 是音訊/混音。
+  如果您以 `pcm`身分請求 `OutputFormat`，則`ContentType`傳回的 是帶正負號的 16 位元 1 聲道 （單聲道） 小端格式的音訊/pcm。
+  如果您以 `mu-law`身分請求 `OutputFormat`，則`ContentType`傳回的 是音訊/mulaw。
+  如果您以 `a-law`身分請求 `OutputFormat`，則`ContentType`傳回的 為音訊/隔離。
+ 如果您以 `json`身分請求 `OutputFormat`，則`ContentType`傳回的 是 application/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 **   
"Text" 參數的值超過接受的限制。對於 `SynthesizeSpeech` API，輸入文字的限制總計最多為 6000 個字元，其中不超過 3000 個字元可以計費。對於 `StartSpeechSynthesisTask` API，上限為 200，000 個字元，其中不超過 100，000 個字元可以計費。SSML 標籤不計為收費字元。  
HTTP 狀態碼：400

## 另請參閱
<a name="API_SynthesizeSpeech_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS 適用於 .NET V4 的 SDK](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 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS 適用於 JavaScript V3 的 SDK](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 V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS 適用於 Python 的 SDK](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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/AudioEvent) 
+  [AWS 適用於 Java V2 的 SDK](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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/CloseStreamEvent) 
+  [AWS 適用於 Java V2 的 SDK](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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/FlushStreamConfiguration) 
+  [AWS 適用於 Java V2 的 SDK](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 SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Lexicon) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Lexicon) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Lexicon) 

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

包含描述語彙的中繼資料，例如 lexemes 數目、語言程式碼等。如需詳細資訊，請參閱[管理語彙](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>
語彙上次修改的日期 （時間戳記值）。  
類型：Timestamp  
必要：否

 ** LexemesCount **   <a name="polly-Type-LexiconAttributes-LexemesCount"></a>
語彙中的 lexemes 數目。  
類型：整數  
必要：否

 ** LexiconArn **   <a name="polly-Type-LexiconAttributes-LexiconArn"></a>
語彙的 Amazon Resource Name (ARN)。  
類型：字串  
必要：否

 ** Size **   <a name="polly-Type-LexiconAttributes-Size"></a>
語彙的總大小，以字元為單位。  
類型：整數  
必要：否

## 另請參閱
<a name="API_LexiconAttributes_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconAttributes) 
+  [AWS 適用於 Java 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 SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconDescription) 
+  [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconDescription) 
+  [AWS 適用於 Ruby V3 的 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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 
+  [AWS 適用於 Java V2 的 SDK](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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 
+  [AWS 適用於 Java V2 的 SDK](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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StreamClosedEvent) 
+  [AWS 適用於 Java V2 的 SDK](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>
合成任務啟動時間的時間戳記。  
類型：Timestamp  
必要：否

 ** 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 等雙語語音時，才需要此語音，可用於印度英文 (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\$1vorbis 的有效值為 "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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesisTask) 
+  [AWS 適用於 Java V2 的 SDK](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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/TextEvent) 
+  [AWS 適用於 Java V2 的 SDK](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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ThrottlingReason) 
+  [AWS 適用於 Java V2 的 SDK](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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ValidationExceptionField) 
+  [AWS 適用於 Java V2 的 SDK](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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Voice) 
+  [AWS 適用於 Java V2 的 SDK](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 第 4 版請求的參數以及查詢字串。任何專屬於特定動作的參數則列於該動作的主題中。如需 Signature 第 4 版的詳細資訊，請參閱《*IAM 使用者指南*》中的[簽署 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。  
如需詳細資訊，請參閱《*IAM 使用者指南*》中的[建立已簽署的 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 時，其一律會覆寫日期標頭的值。如需詳細資訊，請參閱《*IAM 使用者指南*[》中的 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 標頭。如需指定已簽章標頭的詳細資訊，請參閱《*IAM 使用者指南*》中的[建立已簽章的 AWS API 請求](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)。  
條件：當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時，應指定此參數。  
類型：字串  
必要：有條件