Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # StartSpeechSynthesisTask Ermöglicht die Erstellung einer asynchronen Synthesetask, indem eine neue `SpeechSynthesisTask` gestartet wird. Dieser Vorgang erfordert alle Standardinformationen, die für die Sprachsynthese benötigt werden, sowie den Namen eines Amazon S3 S3-Buckets, in dem der Service die Ausgabe der Synthese-Aufgabe speichert, und zwei optionale Parameter (`OutputS3KeyPrefix`und`SnsTopicArn`). Sobald die Syntheseaufgabe erstellt wurde, gibt dieser Vorgang ein `SpeechSynthesisTask` Objekt zurück, das eine Kennung dieser Aufgabe sowie den aktuellen Status enthält. Das `SpeechSynthesisTask` Objekt ist nach dem Start der asynchronen Syntheseaufgabe 72 Stunden lang verfügbar. ## Anforderungssyntax ``` 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-Anfrageparameter Die Anforderung verwendet keine URI-Parameter. ## Anforderungstext Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [Engine](#API_StartSpeechSynthesisTask_RequestSyntax) ** Gibt die Engine (`standard`, `long-form` oder`generative`) an`neural`, die Amazon Polly bei der Verarbeitung von Eingabetext für die Sprachsynthese verwenden soll. Die Verwendung einer Stimme, die für die gewählte Engine nicht unterstützt wird, führt zu einem Fehler. Typ: Zeichenfolge Zulässige Werte: `standard | neural | long-form | generative` Erforderlich: Nein ** [LanguageCode](#API_StartSpeechSynthesisTask_RequestSyntax) ** Optionaler Sprachcode für die Sprachsynthese-Anfrage. Dies ist nur erforderlich, wenn Sie eine zweisprachige Stimme wie Aditi verwenden, die entweder für indisches Englisch (en-IN) oder Hindi (Hi-in) verwendet werden kann. Wenn eine zweisprachige Stimme verwendet wird und kein Sprachcode angegeben ist, verwendet Amazon Polly die Standardsprache der zweisprachigen Stimme. Die Standardsprache für jede Stimme ist die Sprache, die bei der Operation für den [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)Parameter zurückgegeben wurde. `LanguageCode` Wenn beispielsweise kein Sprachcode angegeben ist, verwendet Aditi indisches Englisch statt Hindi. Typ: Zeichenfolge Zulässige Werte: `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` Erforderlich: Nein ** [LexiconNames](#API_StartSpeechSynthesisTask_RequestSyntax) ** Liste mit einem oder mehreren Aussprache-Lexikonnamen, die der Dienst bei der Synthese anwenden soll. Lexika werden nur angewendet, wenn die Sprache des Lexikons mit der Sprache der Stimme übereinstimmt. Typ: Zeichenfolgen-Array Array-Mitglieder: Maximale Anzahl von 5 Elementen. Pattern: `[0-9A-Za-z]{1,20}` Erforderlich: Nein ** [OutputFormat](#API_StartSpeechSynthesisTask_RequestSyntax) ** Das Format, in dem die zurückgegebene Ausgabe codiert wird. Für Audiostreams ist dies mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law oder pcm. Bei Sprachzeichen ist dies json. Typ: Zeichenfolge Zulässige Werte: `json | mp3 | ogg_opus | ogg_vorbis | pcm` Erforderlich: Ja ** [OutputS3BucketName](#API_StartSpeechSynthesisTask_RequestSyntax) ** Name des Amazon S3 S3-Buckets, in dem die Ausgabedatei gespeichert wird. Typ: Zeichenfolge Pattern: `^[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]$` Erforderlich: Ja ** [OutputS3KeyPrefix](#API_StartSpeechSynthesisTask_RequestSyntax) ** Das Amazon S3 S3-Schlüsselpräfix für die Sprachausgabedatei. Typ: Zeichenfolge Pattern: `^[0-9a-zA-Z\/\!\-_\.\*\'\(\):;\$@=+\,\?&]{0,800}$` Erforderlich: Nein ** [SampleRate](#API_StartSpeechSynthesisTask_RequestSyntax) ** Die in Hz angegebene Audiofrequenz. Die gültigen Werte für mp3 und ogg\$1vorbis sind „8000", „16000", „22050" und „24000". Der Standardwert für Standardstimmen ist „22050". Der Standardwert für neuronale Stimmen ist „24000". Der Standardwert für Stimmen in Langform ist „24000". Der Standardwert für generative Stimmen ist „24000". Gültige Werte für pcm sind „8000" und „16000". Der Standardwert ist „16000". Der gültige Wert für ogg\$1opus ist „48000". Der gültige Wert für mu-law und a-law ist „8000". Typ: Zeichenfolge Erforderlich: Nein ** [SnsTopicArn](#API_StartSpeechSynthesisTask_RequestSyntax) ** ARN für das SNS-Thema, das optional für die Bereitstellung von Statusbenachrichtigungen für eine Sprachsyntheseaufgabe verwendet wird. Typ: Zeichenfolge Pattern: `^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)$` Erforderlich: Nein ** [SpeechMarkTypes](#API_StartSpeechSynthesisTask_RequestSyntax) ** Der Typ der Sprachzeichen, die für den Eingabetext zurückgegeben wurden. Typ: Zeichenfolgen-Array Array-Mitglieder: Maximale Anzahl von 4 Elementen. Zulässige Werte: `sentence | ssml | viseme | word` Erforderlich: Nein ** [Text](#API_StartSpeechSynthesisTask_RequestSyntax) ** Der zu synthetisierende Eingabetext. Wenn Sie ssml als angeben TextType, folgen Sie dem SSML-Format für den Eingabetext. Typ: Zeichenfolge Erforderlich: Ja ** [TextType](#API_StartSpeechSynthesisTask_RequestSyntax) ** Gibt an, ob der Eingabetext Klartext oder SSML ist. Der Standardwert ist Klartext. Typ: Zeichenfolge Zulässige Werte: `ssml | text` Erforderlich: Nein ** [VoiceId](#API_StartSpeechSynthesisTask_RequestSyntax) ** Sprach-ID, die für die Synthese verwendet werden soll. Typ: Zeichenfolge Zulässige Werte: `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` Erforderlich: Ja ## Antwortsyntax ``` 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" } } ``` ## Antwortelemente Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben. ** [SynthesisTask](#API_StartSpeechSynthesisTask_ResponseSyntax) ** SynthesisTask Objekt, das Informationen und Attribute zu einer neu eingereichten Sprachsyntheseaufgabe bereitstellt. Typ: [SynthesisTask](API_SynthesisTask.md) Objekt ## Fehler ** EngineNotSupportedException ** Diese Engine ist mit der von Ihnen angegebenen Stimme nicht kompatibel. Wählen Sie eine neue Stimme, die mit der Engine kompatibel ist, oder wechseln Sie die Engine und starten Sie den Vorgang erneut. HTTP-Statuscode: 400 ** InvalidS3BucketException ** Der angegebene Amazon S3 S3-Bucket-Name ist ungültig. Bitte überprüfen Sie Ihre Eingabe mit den Anforderungen für die Benennung von S3-Buckets und versuchen Sie es erneut. HTTP-Statuscode: 400 ** InvalidS3KeyException ** Das angegebene Amazon S3 S3-Schlüsselpräfix ist ungültig. Bitte geben Sie einen gültigen S3-Objektschlüsselnamen an. HTTP-Statuscode: 400 ** InvalidSampleRateException ** Die angegebene Samplerate ist nicht gültig. HTTP-Statuscode: 400 ** InvalidSnsTopicArnException ** Der angegebene ARN für das SNS-Thema ist ungültig. Bitte geben Sie einen gültigen SNS-Thema-ARN ein und versuchen Sie es erneut. HTTP-Statuscode: 400 ** InvalidSsmlException ** Die von Ihnen angegebene SSML ist ungültig. Überprüfen Sie die SSML-Syntax sowie die Schreibweise der Tags und Werte, und versuchen Sie es erneut. HTTP-Statuscode: 400 ** LanguageNotSupportedException ** Die angegebene Sprache wird derzeit von Amazon Polly in dieser Funktion nicht unterstützt. HTTP-Statuscode: 400 ** LexiconNotFoundException ** Amazon Polly kann das angegebene Lexikon nicht finden. Dies kann durch ein fehlendes Lexikon, durch einen falsch geschriebenen Namen oder durch die Angabe eines Lexikons in einer anderen Region verursacht werden. Vergewissern Sie sich, dass das Lexikon existiert, sich in der Region befindet (siehe[ListLexicons](API_ListLexicons.md)) und ob Sie den Namen richtig geschrieben haben. Versuchen Sie es dann erneut. HTTP-Statuscode: 404 ** MarksNotSupportedForFormatException ** Sprachzeichen werden für die `OutputFormat` ausgewählten Elemente nicht unterstützt. Sprachzeichen sind nur für Inhalte im `json` Format verfügbar. HTTP-Statuscode: 400 ** ServiceFailureException ** Ein unbekannter Zustand hat zu einem Dienstausfall geführt. HTTP Status Code: 500 ** SsmlMarksNotSupportedForTextTypeException ** SSML-Sprachzeichen werden für Klartexteingaben nicht unterstützt. HTTP-Statuscode: 400 ** TextLengthExceededException ** Der Wert des Parameters „Text“ ist länger als die akzeptierten Grenzwerte. Für die `SynthesizeSpeech` API beträgt das Limit für den Eingabetext insgesamt maximal 6000 Zeichen, von denen nicht mehr als 3000 fakturierte Zeichen sein können. Für die `StartSpeechSynthesisTask` API liegt das Maximum bei 200.000 Zeichen, wovon nicht mehr als 100.000 fakturierte Zeichen sein können. SSML-Tags werden nicht als berechnete Zeichen gezählt. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisTask)