本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # StartSpeechSynthesisTask 允許透過啟動新的來建立非同步合成任務`SpeechSynthesisTask`。此操作需要語音合成所需的所有標準資訊，加上服務 Amazon S3 儲存貯體的名稱，以存放合成任務的輸出和兩個選用參數 (`OutputS3KeyPrefix` 和 `SnsTopicArn`)。合成任務建立後，此操作會傳回`SpeechSynthesisTask`物件，其中包含此任務的識別符以及目前狀態。`SpeechSynthesisTask` 物件會在啟動非同步合成任務後 72 小時內可用。 ## 請求語法 ``` 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 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [Engine](#API_StartSpeechSynthesisTask_RequestSyntax) ** 指定 Amazon Polly 在處理語音合成的輸入文字時要使用的引擎 (`standard``neural`、 `long-form`或 `generative`)。使用所選引擎不支援的語音會導致錯誤。類型：字串有效值:`standard | neural | long-form | generative` 必要：否 ** [LanguageCode](#API_StartSpeechSynthesisTask_RequestSyntax) ** 語音合成請求的選用語言代碼。這只有在使用雙語語音，例如 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) ** 您希望服務在合成期間套用的一或多個發音語彙名稱清單。只有在語彙的語言與語音的語言相同時，才會套用語彙。類型：字串陣列陣列成員：最多 5 個項目。模式：`[0-9A-Za-z]{1,20}` 必要：否 ** [OutputFormat](#API_StartSpeechSynthesisTask_RequestSyntax) ** 將編碼傳回輸出的格式。對於音訊串流，這會是 mp3、ogg\$1vorbis、ogg\$1opus、mu-law、a-law 或 pcm。對於語音標記，這會是 json。類型：字串有效值:`json | mp3 | ogg_opus | ogg_vorbis | pcm` 必要：是 ** [OutputS3BucketName](#API_StartSpeechSynthesisTask_RequestSyntax) ** 將輸出檔案儲存到的 Amazon S3 儲存貯體名稱。類型：字串模式：`^[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]$` 必要：是 ** [OutputS3KeyPrefix](#API_StartSpeechSynthesisTask_RequestSyntax) ** 輸出語音檔案的 Amazon S3 金鑰字首。類型：字串模式：`^[0-9a-zA-Z\/\!\-_\.\*\':;\$@=+\,\?&]{0,800}$` 必要：否 ** [SampleRate](#API_StartSpeechSynthesisTask_RequestSyntax) ** 以 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) ** 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) ** 針對輸入文字傳回的語音標記類型。類型：字串陣列陣列成員：最多 4 個項目。有效值:`sentence | ssml | viseme | word` 必要：否 ** [Text](#API_StartSpeechSynthesisTask_RequestSyntax) ** 要合成的輸入文字。如果您將 ssml 指定為 TextType，請遵循輸入文字的 SSML 格式。類型：字串必要：是 ** [TextType](#API_StartSpeechSynthesisTask_RequestSyntax) ** 指定輸入文字是純文字還是 SSML。預設值為純文字。類型：字串有效值:`ssml | text` 必要：否 ** [VoiceId](#API_StartSpeechSynthesisTask_RequestSyntax) ** 用於合成的語音 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` 必要：是 ## 回應語法 ``` 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" } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [SynthesisTask](#API_StartSpeechSynthesisTask_ResponseSyntax) ** SynthesisTask 物件，可提供新提交語音合成任務的相關資訊和屬性。類型：[SynthesisTask](API_SynthesisTask.md) 物件 ## 錯誤 ** 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 ## 另請參閱如需在其中一種語言特定 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)