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

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