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.

# Aktionen
<a name="API_Operations"></a>

Folgende Aktionen werden unterstützt:
+  [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>

Löscht das angegebene Aussprachelexikon, das in einem gespeichert ist. AWS-Region Ein gelöschtes Lexikon ist nicht für die Sprachsynthese verfügbar, und es ist auch nicht möglich, es mit dem Oder abzurufen. `GetLexicon` `ListLexicon` APIs

Weitere Informationen finden Sie unter [Lexika verwalten](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

## Anforderungssyntax
<a name="API_DeleteLexicon_RequestSyntax"></a>

```
DELETE /v1/lexicons/LexiconName HTTP/1.1
```

## URI-Anfrageparameter
<a name="API_DeleteLexicon_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [LexiconName](#API_DeleteLexicon_RequestSyntax) **   <a name="polly-DeleteLexicon-request-uri-Name"></a>
Der Name des zu löschenden Lexikons. Es muss sich um ein vorhandenes Lexikon in der Region handeln.  
Pattern: `[0-9A-Za-z]{1,20}`   
Erforderlich: Ja

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

Der Anforderung besitzt keinen Anforderungstext.

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

```
HTTP/1.1 200
```

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

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

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

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

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

## Weitere Informationen finden Sie unter:
<a name="API_DeleteLexicon_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/DeleteLexicon) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DeleteLexicon) 

# DescribeVoices
<a name="API_DescribeVoices"></a>

Gibt die Liste der Stimmen zurück, die beim Anfordern von Sprachausgaben verwendet werden können Jede Stimme spricht eine bestimmte Sprache, ist entweder männlich oder weiblich und wird durch eine ID identifiziert, bei der es sich um die ASCII-Version des Sprachnamens handelt. 

Bei der Sprachsynthese (`SynthesizeSpeech`) geben Sie die Stimmen-ID für die gewünschte Stimme aus der Liste der zurückgegebenen Stimmen an. `DescribeVoices`

Sie möchten beispielsweise, dass Ihre News-Reader-Anwendung Nachrichten in einer bestimmten Sprache liest, einem Benutzer aber die Möglichkeit gibt, die Stimme auszuwählen. Mithilfe dieser `DescribeVoices` Funktion können Sie dem Benutzer eine Liste verfügbarer Stimmen zur Auswahl zur Verfügung stellen.

 Sie können optional einen Sprachcode angeben, um die verfügbaren Stimmen zu filtern. Wenn Sie beispielsweise angeben`en-US`, gibt der Vorgang eine Liste aller verfügbaren Stimmen in US-Englisch zurück. 

Diese Operation erfordert zur Ausführung der `polly:DescribeVoices`-Aktion Berechtigungen.

## Anforderungssyntax
<a name="API_DescribeVoices_RequestSyntax"></a>

```
GET /v1/voices?Engine=Engine&IncludeAdditionalLanguageCodes=IncludeAdditionalLanguageCodes&LanguageCode=LanguageCode&NextToken=NextToken HTTP/1.1
```

## URI-Anfrageparameter
<a name="API_DescribeVoices_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [Engine](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-Engine"></a>
Gibt die Engine (`standard`, `long-form` oder`generative`) an`neural`, die von Amazon Polly bei der Verarbeitung von Eingabetext für die Sprachsynthese verwendet wird.   
Zulässige Werte: `standard | neural | long-form | generative` 

 ** [IncludeAdditionalLanguageCodes](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-IncludeAdditionalLanguageCodes"></a>
Boolescher Wert, der angibt, ob zweisprachige Stimmen zurückgegeben werden sollen, die die angegebene Sprache als zusätzliche Sprache verwenden. Wenn Sie beispielsweise alle Sprachen anfordern, in denen US-Englisch (es-US) verwendet wird, und es eine italienische Stimme gibt, die sowohl Italienisch (it-IT) als auch US-Englisch spricht, wird diese Stimme aufgenommen, wenn Sie sie angeben, aber nicht, wenn Sie sie angeben`yes`. `no`

 ** [LanguageCode](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-LanguageCode"></a>
 Das Sprachkennzeichen (ISO-639-Code für den Sprachnamen — ISO-3166-Ländercode) zum Filtern der Liste der zurückgegebenen Stimmen. Wenn Sie diesen optionalen Parameter nicht angeben, werden alle verfügbaren Stimmen zurückgegeben.   
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` 

 ** [NextToken](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-NextToken"></a>
Ein undurchsichtiges Paginierungstoken, das von der vorherigen `DescribeVoices` Operation zurückgegeben wurde. Falls vorhanden, gibt dies an, wo mit der Auflistung fortgefahren werden soll.  
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge von 4096.

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

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<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" ]
      }
   ]
}
```

## Antwortelemente
<a name="API_DescribeVoices_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.

 ** [NextToken](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-NextToken"></a>
Das Paginierungstoken, das in der nächsten Anfrage verwendet werden soll, um die Liste der Stimmen fortzusetzen. `NextToken`wird nur zurückgegeben, wenn die Antwort gekürzt ist.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge von 4096.

 ** [Voices](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-Voices"></a>
Eine Liste von Stimmen mit ihren Eigenschaften.  
Typ: Array von [Voice](API_Voice.md)-Objekten

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

 ** InvalidNextTokenException **   
Das NextToken ist ungültig. Stellen Sie sicher, dass es richtig geschrieben ist, und versuchen Sie es erneut.  
HTTP-Statuscode: 400

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

## Weitere Informationen finden Sie unter:
<a name="API_DescribeVoices_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/DescribeVoices) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DescribeVoices) 

# GetLexicon
<a name="API_GetLexicon"></a>

Gibt den Inhalt des angegebenen Aussprachelexikons zurück, das in einem AWS-Region gespeichert ist. Weitere Informationen finden Sie unter [Lexika verwalten](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

## Anforderungssyntax
<a name="API_GetLexicon_RequestSyntax"></a>

```
GET /v1/lexicons/LexiconName HTTP/1.1
```

## URI-Anfrageparameter
<a name="API_GetLexicon_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [LexiconName](#API_GetLexicon_RequestSyntax) **   <a name="polly-GetLexicon-request-uri-Name"></a>
Name des Lexikons.  
Pattern: `[0-9A-Za-z]{1,20}`   
Erforderlich: Ja

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

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<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
   }
}
```

## Antwortelemente
<a name="API_GetLexicon_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.

 ** [Lexicon](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-Lexicon"></a>
Lexikon-Objekt, das den Namen und den Zeichenketteninhalt des Lexikons bereitstellt.   
Typ: [Lexicon](API_Lexicon.md) Objekt

 ** [LexiconAttributes](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-LexiconAttributes"></a>
Metadaten des Lexikons, einschließlich verwendeter phonetischer Alphabetik, Sprachcode, Lexikon-ARN, Anzahl der im Lexikon definierten Lexeme und Größe des Lexikons in Byte.  
Typ: [LexiconAttributes](API_LexiconAttributes.md) Objekt

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

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

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

## Weitere Informationen finden Sie unter:
<a name="API_GetLexicon_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/GetLexicon) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetLexicon) 

# GetSpeechSynthesisTask
<a name="API_GetSpeechSynthesisTask"></a>

Ruft ein bestimmtes SpeechSynthesisTask Objekt basierend auf seiner TaskID ab. Dieses Objekt enthält Informationen über die angegebene Sprachsynthese-Aufgabe, einschließlich des Status der Aufgabe, und einen Link zum S3-Bucket, der die Ausgabe der Aufgabe enthält.

## Anforderungssyntax
<a name="API_GetSpeechSynthesisTask_RequestSyntax"></a>

```
GET /v1/synthesisTasks/TaskId HTTP/1.1
```

## URI-Anfrageparameter
<a name="API_GetSpeechSynthesisTask_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [TaskId](#API_GetSpeechSynthesisTask_RequestSyntax) **   <a name="polly-GetSpeechSynthesisTask-request-uri-TaskId"></a>
Die von Amazon Polly generierte Kennung für eine Sprachsyntheseaufgabe.  
Pattern: `^[a-zA-Z0-9_-]{1,100}$`   
Erforderlich: Ja

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

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<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"
   }
}
```

## Antwortelemente
<a name="API_GetSpeechSynthesisTask_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.

 ** [SynthesisTask](#API_GetSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-GetSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask Objekt, das Informationen zur angeforderten Aufgabe bereitstellt, einschließlich Ausgabeformat, Erstellungszeit, Aufgabenstatus usw.  
Typ: [SynthesisTask](API_SynthesisTask.md) Objekt

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

 ** InvalidTaskIdException **   
Die angegebene Aufgaben-ID ist nicht gültig. Bitte geben Sie eine gültige Task-ID ein und versuchen Sie es erneut.  
HTTP-Statuscode: 400

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

 ** SynthesisTaskNotFoundException **   
Die Sprachsynthese-Aufgabe mit der angeforderten Task-ID wurde nicht gefunden.  
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_GetSpeechSynthesisTask_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/GetSpeechSynthesisTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetSpeechSynthesisTask) 

# ListLexicons
<a name="API_ListLexicons"></a>

Gibt eine Liste von Aussprachelexika zurück, die in einem AWS-Region gespeichert sind. Weitere Informationen finden Sie unter [Lexika verwalten](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

## Anforderungssyntax
<a name="API_ListLexicons_RequestSyntax"></a>

```
GET /v1/lexicons?NextToken=NextToken HTTP/1.1
```

## URI-Anfrageparameter
<a name="API_ListLexicons_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [NextToken](#API_ListLexicons_RequestSyntax) **   <a name="polly-ListLexicons-request-uri-NextToken"></a>
Ein undurchsichtiges Paginierungstoken, das von einem vorherigen Vorgang zurückgegeben wurde. `ListLexicons` Falls vorhanden, gibt dies an, wo die Liste der Lexika fortgesetzt werden soll.  
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge von 4096.

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

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<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"
}
```

## Antwortelemente
<a name="API_ListLexicons_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.

 ** [Lexicons](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-Lexicons"></a>
Eine Liste von Lexikonnamen und Attributen.  
Typ: Array von [LexiconDescription](API_LexiconDescription.md)-Objekten

 ** [NextToken](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-NextToken"></a>
Das Paginierungstoken, das in der nächsten Anfrage verwendet werden soll, um die Auflistung der Lexika fortzusetzen. `NextToken`wird nur zurückgegeben, wenn die Antwort gekürzt ist.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge von 4096.

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

 ** InvalidNextTokenException **   
Das NextToken ist ungültig. Stellen Sie sicher, dass es richtig geschrieben ist, und versuchen Sie es erneut.  
HTTP-Statuscode: 400

 ** ServiceFailureException **   
Ein unbekannter Zustand hat einen Dienstausfall verursacht.  
HTTP Status Code: 500

## Weitere Informationen finden Sie unter:
<a name="API_ListLexicons_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/ListLexicons) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListLexicons) 

# ListSpeechSynthesisTasks
<a name="API_ListSpeechSynthesisTasks"></a>

Gibt eine Liste von SpeechSynthesisTask Objekten zurück, die nach ihrem Erstellungsdatum sortiert sind. Dieser Vorgang kann die Aufgaben nach ihrem Status filtern, sodass Benutzer beispielsweise nur Aufgaben auflisten können, die abgeschlossen sind.

## Anforderungssyntax
<a name="API_ListSpeechSynthesisTasks_RequestSyntax"></a>

```
GET /v1/synthesisTasks?MaxResults=MaxResults&NextToken=NextToken&Status=Status HTTP/1.1
```

## URI-Anfrageparameter
<a name="API_ListSpeechSynthesisTasks_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [MaxResults](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-MaxResults"></a>
Maximale Anzahl von Sprachsyntheseaufgaben, die bei einem Listenvorgang zurückgegeben wurden.  
Gültiger Bereich: Mindestwert 1. Maximalwert 100.

 ** [NextToken](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-NextToken"></a>
Das Paginierungstoken, das in der nächsten Anforderung verwendet werden soll, um die Auflistung der Sprachsyntheseaufgaben fortzusetzen.   
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge von 4096.

 ** [Status](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-Status"></a>
Status der Sprachsyntheseaufgaben, die in einem Listenvorgang zurückgegeben wurden  
Zulässige Werte: `scheduled | inProgress | completed | failed` 

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

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<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"
      }
   ]
}
```

## Antwortelemente
<a name="API_ListSpeechSynthesisTasks_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.

 ** [NextToken](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-NextToken"></a>
Ein undurchsichtiges Paginierungstoken, das von der vorherigen List-Operation in dieser Anforderung zurückgegeben wurde. Falls vorhanden, gibt es an, wo die Auflistung fortgesetzt werden soll.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge von 4096.

 ** [SynthesisTasks](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-SynthesisTasks"></a>
Liste von SynthesisTask Objekten, die Informationen zur angegebenen Aufgabe in der Listenanforderung bereitstellt, einschließlich Ausgabeformat, Erstellungszeit, Aufgabenstatus usw.  
Typ: Array von [SynthesisTask](API_SynthesisTask.md)-Objekten

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

 ** InvalidNextTokenException **   
Das NextToken ist ungültig. Stellen Sie sicher, dass es richtig geschrieben ist, und versuchen Sie es erneut.  
HTTP-Statuscode: 400

 ** ServiceFailureException **   
Ein unbekannter Zustand hat einen Dienstausfall verursacht.  
HTTP Status Code: 500

## Weitere Informationen finden Sie unter:
<a name="API_ListSpeechSynthesisTasks_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/ListSpeechSynthesisTasks) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListSpeechSynthesisTasks) 

# PutLexicon
<a name="API_PutLexicon"></a>

Speichert ein Aussprachelexikon in einem AWS-Region. Wenn in der Region bereits ein Lexikon mit demselben Namen existiert, wird es durch das neue Lexikon überschrieben. Lexikonoperationen sind letztlich konsistent, daher kann es einige Zeit dauern, bis das Lexikon für die Operation verfügbar ist. SynthesizeSpeech 

[Weitere Informationen finden Sie unter Lexika verwalten.](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)

## Anforderungssyntax
<a name="API_PutLexicon_RequestSyntax"></a>

```
PUT /v1/lexicons/LexiconName HTTP/1.1
Content-type: application/json

{
   "Content": "string"
}
```

## URI-Anfrageparameter
<a name="API_PutLexicon_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [LexiconName](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-uri-Name"></a>
Name des Lexikons. Der Name muss dem regulären Expressformat [0-9a-Za-Z] \$11,20\$1 entsprechen. Das heißt, der Name ist eine alphanumerische Zeichenfolge mit bis zu 20 Zeichen, bei der Groß- und Kleinschreibung beachtet wird.   
Pattern: `[0-9A-Za-z]{1,20}`   
Erforderlich: Ja

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

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [Content](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-Content"></a>
Inhalt des PLS-Lexikons als Zeichenkettendaten.  
Typ: Zeichenfolge  
Erforderlich: Ja

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

```
HTTP/1.1 200
```

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

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

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

 ** InvalidLexiconException **   
Amazon Polly kann das angegebene Lexikon nicht finden. Stellen Sie sicher, dass der Name des Lexikons richtig geschrieben ist, und versuchen Sie es erneut.  
HTTP-Statuscode: 400

 ** LexiconSizeExceededException **   
Die maximale Größe des angegebenen Lexikons würde durch diesen Vorgang überschritten werden.  
HTTP-Statuscode: 400

 ** MaxLexemeLengthExceededException **   
Die maximale Größe des Lexems würde durch diesen Vorgang überschritten werden.  
HTTP-Statuscode: 400

 ** MaxLexiconsNumberExceededException **   
Die maximale Anzahl von Lexika würde durch diesen Vorgang überschritten werden.  
HTTP-Statuscode: 400

 ** ServiceFailureException **   
Ein unbekannter Zustand hat einen Dienstausfall verursacht.  
HTTP Status Code: 500

 ** UnsupportedPlsAlphabetException **   
Das im Lexikon angegebene Alphabet wird nicht unterstützt. Gültige Werte sind `x-sampa` und `ipa`.  
HTTP-Statuscode: 400

 ** UnsupportedPlsLanguageException **   
Die im Lexikon angegebene Sprache wird nicht unterstützt. Eine Liste der unterstützten Sprachen finden Sie unter [Lexikonattribute](https://docs.aws.amazon.com/polly/latest/dg/API_LexiconAttributes.html).  
HTTP-Statuscode: 400

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

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/PutLexicon) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/PutLexicon) 

# 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`   
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) 

# StartSpeechSynthesisTask
<a name="API_StartSpeechSynthesisTask"></a>

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
<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-Anfrageparameter
<a name="API_StartSpeechSynthesisTask_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

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

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [Engine](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Engine"></a>
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) **   <a name="polly-StartSpeechSynthesisTask-request-LanguageCode"></a>
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) **   <a name="polly-StartSpeechSynthesisTask-request-LexiconNames"></a>
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) **   <a name="polly-StartSpeechSynthesisTask-request-OutputFormat"></a>
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) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3BucketName"></a>
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) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3KeyPrefix"></a>
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) **   <a name="polly-StartSpeechSynthesisTask-request-SampleRate"></a>
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) **   <a name="polly-StartSpeechSynthesisTask-request-SnsTopicArn"></a>
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) **   <a name="polly-StartSpeechSynthesisTask-request-SpeechMarkTypes"></a>
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) **   <a name="polly-StartSpeechSynthesisTask-request-Text"></a>
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) **   <a name="polly-StartSpeechSynthesisTask-request-TextType"></a>
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) **   <a name="polly-StartSpeechSynthesisTask-request-VoiceId"></a>
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
<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"
   }
}
```

## Antwortelemente
<a name="API_StartSpeechSynthesisTask_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.

 ** [SynthesisTask](#API_StartSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask Objekt, das Informationen und Attribute zu einer neu eingereichten Sprachsyntheseaufgabe bereitstellt.  
Typ: [SynthesisTask](API_SynthesisTask.md) Objekt

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

 ** 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:
<a name="API_StartSpeechSynthesisTask_SeeAlso"></a>

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) 

# SynthesizeSpeech
<a name="API_SynthesizeSpeech"></a>

Synthetisiert UTF-8-Eingabe, Klartext oder SSML in einen Byte-Stream Die SSML-Eingabe muss gültiges, wohlgeformtes SSML sein. Einige Alphabete sind möglicherweise nicht mit allen Stimmen verfügbar (z. B. wird Kyrillisch möglicherweise von englischen Stimmen überhaupt nicht gelesen), es sei denn, es wird eine Phonemzuordnung verwendet. [Weitere Informationen finden Sie unter So funktioniert es.](https://docs.aws.amazon.com/polly/latest/dg/how-text-to-speech-works.html)

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

Die Anforderung verwendet keine URI-Parameter.

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

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [Engine](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Engine"></a>
Gibt die Engine (`standard`,`neural`, oder`generative`) an`long-form`, die Amazon Polly bei der Verarbeitung von Eingabetext für die Sprachsynthese verwenden soll. Stellen Sie eine Engine bereit, die von der ausgewählten Stimme unterstützt wird. Wenn Sie kein Modul angeben, ist standardmäßig das Standardmodul ausgewählt. Wenn eine gewählte Stimme von der Standard-Engine nicht unterstützt wird, führt dies zu einem Fehler. Informationen zu Amazon Polly-Stimmen und zu den Stimmen, die für die einzelnen Engines verfügbar sind, finden Sie unter [Verfügbare Stimmen](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html).  
Typ: Zeichenfolge  
Zulässige Werte: `standard | neural | long-form | generative`   
Erforderlich: Nein

 ** [LanguageCode](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LanguageCode"></a>
Optionaler Sprachcode für die Synthesize Speech-Anforderung. 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_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LexiconNames"></a>
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. Hinweise zum Speichern von Lexika finden Sie unter. [PutLexicon](https://docs.aws.amazon.com/polly/latest/dg/API_PutLexicon.html)  
Typ: Zeichenfolgen-Array  
Array-Mitglieder: Maximale Anzahl von 5 Elementen.  
Pattern: `[0-9A-Za-z]{1,20}`   
Erforderlich: Nein

 ** [OutputFormat](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-OutputFormat"></a>
 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. Für Sprachzeichen wird dies json sein.   
Wenn pcm verwendet wird, liegt der zurückgegebene Inhalt audio/pcm in einem vorzeichenbehafteten 16-Bit-Little-Endian-Format mit 1 Kanal (mono) vor.   
Typ: Zeichenfolge  
Zulässige Werte: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Erforderlich: Ja

 ** [SampleRate](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SampleRate"></a>
Die in Hz angegebene Audiofrequenz.  
Die gültigen Werte für mp3 und ogg\$1vorbis sind „8000", „16000", „22050", „24000", „44100" und „48000". 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

 ** [SpeechMarkTypes](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SpeechMarkTypes"></a>
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_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Text"></a>
 Geben Sie den zu synthetisierenden Text ein. Wenn Sie `ssml` als angeben`TextType`, folgen Sie dem SSML-Format für den Eingabetext.   
Typ: Zeichenfolge  
Erforderlich: Ja

 ** [TextType](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-TextType"></a>
 Gibt an, ob der Eingabetext Klartext oder SSML ist. Der Standardwert ist Klartext. Weitere Informationen finden Sie unter [Verwenden von SSML](https://docs.aws.amazon.com/polly/latest/dg/ssml.html).  
Typ: Zeichenfolge  
Zulässige Werte: `ssml | text`   
Erforderlich: Nein

 ** [VoiceId](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-VoiceId"></a>
 Sprach-ID, die für die Synthese verwendet werden soll. Sie können eine Liste der verfügbaren Sprachbefehle abrufen, IDs indem Sie den [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)Vorgang aufrufen.   
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
<a name="API_SynthesizeSpeech_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-Type: ContentType
x-amzn-RequestCharacters: RequestCharacters

AudioStream
```

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

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die Antwort gibt die folgenden HTTP-Header zurück.

 ** [ContentType](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-ContentType"></a>
 Gibt den Typ des Audiostreams an. Dies sollte den `OutputFormat` Parameter in Ihrer Anfrage widerspiegeln.   
+  Wenn Sie `mp3` als die anfordern`OutputFormat`, wird `ContentType` audio/mpeg zurückgegeben. 
+  Wenn Sie `ogg_vorbis` als angeben`OutputFormat`, wird Audio/OGG `ContentType` zurückgegeben. 
+  Wenn Sie `ogg_opus` als angeben`OutputFormat`, ist das `ContentType` zurückgegebene Objekt Audio/OGG. 
+  Wenn Sie `pcm` als die anfordern`OutputFormat`, erfolgt die `ContentType` Rückgabe audio/pcm in einem vorzeichenbehafteten 16-Bit-Little-Endian-Format mit 1 Kanal (mono). 
+  Wenn Sie `mu-law` als angeben, ist das zurückgegebene `OutputFormat` Audio/Mulaw. `ContentType` 
+  Wenn Sie `a-law` als die anfordern`OutputFormat`, ist die `ContentType` zurückgegebene Antwort audio/alaw. 
+ Wenn Sie `json` als die anfordern`OutputFormat`, lautet die `ContentType` zurückgegebene Datei application/. x-json-stream
 

 ** [RequestCharacters](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-RequestCharacters"></a>
Anzahl der synthetisierten Zeichen.

Die Antwort gibt folgendes als HTTP-Hauptteil zurück.

 ** [AudioStream](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-AudioStream"></a>
 Stream, der die synthetisierte Sprache enthält. 

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

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

 ** InvalidSampleRateException **   
Die angegebene Samplerate ist nicht gültig.  
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 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, von denen 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:
<a name="API_SynthesizeSpeech_SeeAlso"></a>

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/SynthesizeSpeech) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesizeSpeech)