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.

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

Synthetisiert UTF-8-Eingabe, Klartext oder SSML über eine bidirektionale Streaming-Verbindung. Geben Sie Syntheseparameter in HTTP/2-Headern an, senden Sie Text inkrementell als Ereignisse im Eingabestream und empfangen Sie synthetisiertes Audio, sobald es verfügbar ist.

Diese Operation dient als bidirektionales Gegenstück zu: `SynthesizeSpeech`
+  [SynthesizeSpeech](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html) 

## Anforderungssyntax
<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-Anfrageparameter
<a name="API_StartSpeechSynthesisStream_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [Engine](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-Engine"></a>
Gibt die Engine an, die Amazon Polly bei der Verarbeitung von Eingabetext für die Sprachsynthese verwenden soll. Derzeit wird nur die `generative` Engine unterstützt. Wenn Sie eine Stimme angeben, die von der ausgewählten Engine nicht unterstützt wird, gibt Amazon Polly einen Fehler zurück.  
Zulässige Werte: `standard | neural | long-form | generative`   
Erforderlich: Ja

 ** [LanguageCode](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LanguageCode"></a>
Ein optionaler Parameter, der den Sprachcode für die Sprachsyntheseanforderung festlegt. Geben Sie diesen Parameter nur an, wenn Sie eine zweisprachige Stimme verwenden. Wenn eine zweisprachige Stimme verwendet wird und kein Sprachcode angegeben ist, verwendet Amazon Polly die Standardsprache der zweisprachigen Stimme.  
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` 

 ** [LexiconNames](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LexiconNames"></a>
Die Namen eines oder mehrerer Aussprachelexika, die der Service bei der Synthese anwenden soll. Amazon Polly wendet Lexika nur an, wenn die Lexikonsprache mit der Sprachsprache übereinstimmt.  
Array-Mitglieder: Maximale Anzahl von 5 Elementen.  
Pattern: `[0-9A-Za-z]{1,20}` 

 ** [OutputFormat](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-OutputFormat"></a>
Das Audioformat für die synthetisierte Sprache. Derzeit unterstützt Amazon Polly keine JSON-Sprachmarken.  
Zulässige Werte: `json | mp3 | ogg_opus | ogg_vorbis | pcm | mulaw | alaw`   
Erforderlich: Ja

 ** [SampleRate](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-SampleRate"></a>
Die Audiofrequenz, angegeben in Hz.

 ** [VoiceId](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-VoiceId"></a>
Die Stimme, die für die Synthese verwendet werden soll. Verwenden Sie den [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)Vorgang IDs, um eine Liste der verfügbaren Sprachbefehle abzurufen.  
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

## Anforderungstext
<a name="API_StartSpeechSynthesisStream_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [CloseStreamEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-CloseStreamEvent"></a>
Ein Ereignis, das das Ende des Eingabestreams anzeigt.  
Typ: [CloseStreamEvent](API_CloseStreamEvent.md) Objekt  
Erforderlich: Nein

 ** [TextEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-TextEvent"></a>
Ein Textereignis, das Inhalte enthält, die synthetisiert werden sollen.  
Typ: [TextEvent](API_TextEvent.md) Objekt  
Erforderlich: Nein

## Antwortsyntax
<a name="API_StartSpeechSynthesisStream_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_StartSpeechSynthesisStream_ResponseElements"></a>

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.

 ** [AudioEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-AudioEvent"></a>
Ein Audioereignis, das synthetisierte Sprache enthält.  
Typ: [AudioEvent](API_AudioEvent.md) Objekt

 ** [ServiceFailureException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceFailureException"></a>
Ein unbekannter Zustand hat einen Dienstausfall verursacht.  
Typ: Ausnahme  
HTTP Status Code: 500

 ** [ServiceQuotaExceededException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceQuotaExceededException"></a>
Eine Ausnahme, die darauf hinweist, dass ein Dienstkontingent überschritten würde.  
Typ: Ausnahme  
HTTP-Statuscode: 402

 ** [StreamClosedEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-StreamClosedEvent"></a>
Ein Ereignis mit zusammenfassenden Informationen, das darauf hinweist, dass der Stream geschlossen wurde.  
Typ: [StreamClosedEvent](API_StreamClosedEvent.md) Objekt

 ** [ThrottlingException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ThrottlingException"></a>
Eine Ausnahme, die darauf hinweist, dass die Anfrage gedrosselt wurde.  
Typ: Ausnahme  
HTTP-Statuscode: 400

 ** [ValidationException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ValidationException"></a>
Eine Ausnahme, die darauf hinweist, dass die Eingabe nicht validiert wurde.  
Typ: Ausnahme  
HTTP-Statuscode: 400

## Fehler
<a name="API_StartSpeechSynthesisStream_Errors"></a>

 ** ServiceFailureException **   
Ein unbekannter Zustand hat zu einem Dienstausfall geführt.  
HTTP Status Code: 500

 ** ServiceQuotaExceededException **   
Die Anfrage würde dazu führen, dass ein Dienstkontingent überschritten wird.    
 ** quotaCode **   
Der Kontingentcode, der das spezifische Kontingent identifiziert.  
 ** serviceCode **   
Der Dienstcode, der den ursprünglichen Dienst identifiziert.
HTTP-Statuscode: 402

 ** ThrottlingException **   
Die Anfrage wurde aufgrund der Anforderungsdrosselung abgelehnt.    
 ** throttlingReasons **   
Eine Liste von Gründen, die erklären, warum die Anfrage gedrosselt wurde.
HTTP-Statuscode: 400

 ** ValidationException **   
Die Eingabe erfüllt die vom Dienst angegebenen Einschränkungen nicht.    
 ** fields **   
Die Felder, die den Validierungsfehler verursacht haben.  
 ** reason **   
Der Grund, warum die Anfrage nicht validiert werden konnte.
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_StartSpeechSynthesisStream_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStream)