

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.

# Amazon Polly API-Referenz
<a name="API_Reference"></a>

Amazon Polly ist ein Webservice, der es einfach macht, Sprache aus Text zu synthetisieren.

Der Amazon Polly Polly-Service bietet API-Operationen für die Synthese hochwertiger Sprache aus Klartext und Speech Synthesis Markup Language (SSML) sowie die Verwaltung von Aussprachelexika, mit denen Sie die besten Ergebnisse für Ihre Anwendungsdomäne erzielen können.

Authentifizierte API-Aufrufe müssen mithilfe dem Signature Version 4-Signaturprozess signiert werden. [Weitere Informationen finden Sie unter Signieren von API-Anfragen in der. AWS*Allgemeine Amazon Web Services-Referenz*](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html)

**Topics**
+ [Aktionen](API_Operations.md)
+ [Datentypen](API_Types.md)
+ [Häufige Fehler](CommonErrors.md)
+ [Geläufige Parameter](CommonParameters.md)

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

# Datentypen
<a name="API_Types"></a>

Die folgenden Datentypen werden unterstützt:
+  [AudioEvent](API_AudioEvent.md) 
+  [CloseStreamEvent](API_CloseStreamEvent.md) 
+  [FlushStreamConfiguration](API_FlushStreamConfiguration.md) 
+  [Lexicon](API_Lexicon.md) 
+  [LexiconAttributes](API_LexiconAttributes.md) 
+  [LexiconDescription](API_LexiconDescription.md) 
+  [StartSpeechSynthesisStreamActionStream](API_StartSpeechSynthesisStreamActionStream.md) 
+  [StartSpeechSynthesisStreamEventStream](API_StartSpeechSynthesisStreamEventStream.md) 
+  [StreamClosedEvent](API_StreamClosedEvent.md) 
+  [SynthesisTask](API_SynthesisTask.md) 
+  [TextEvent](API_TextEvent.md) 
+  [ThrottlingReason](API_ThrottlingReason.md) 
+  [ValidationExceptionField](API_ValidationExceptionField.md) 
+  [Voice](API_Voice.md) 

# AudioEvent
<a name="API_AudioEvent"></a>

Enthält einen Teil synthetisierter Audiodaten.

## Inhalt
<a name="API_AudioEvent_Contents"></a>

 ** AudioChunk **   <a name="polly-Type-AudioEvent-AudioChunk"></a>
Ein Teil synthetisierter Audiodaten, die in dem durch den Parameter angegebenen Format codiert sind. `OutputFormat`  
Typ: Base64-kodiertes Binärdatenobjekt  
Erforderlich: Nein

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/AudioEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/AudioEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/AudioEvent) 

# CloseStreamEvent
<a name="API_CloseStreamEvent"></a>

Zeigt das Ende des Eingabestreams an. Nach dem Senden dieses Ereignisses wird der Eingabestream geschlossen und alle Audiodaten werden zurückgegeben.

## Inhalt
<a name="API_CloseStreamEvent_Contents"></a>

Die Mitglieder dieser Ausnahmestruktur sind kontextabhängig.

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/CloseStreamEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/CloseStreamEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/CloseStreamEvent) 

# FlushStreamConfiguration
<a name="API_FlushStreamConfiguration"></a>

Konfiguration, die steuert, wann synthetisierte Audiodaten an den Ausgangsstream gesendet werden.

## Inhalt
<a name="API_FlushStreamConfiguration_Contents"></a>

 ** Force **   <a name="polly-Type-FlushStreamConfiguration-Force"></a>
Gibt an, ob die Synthese-Engine gezwungen werden soll, gepufferte Audiodaten sofort in den Ausgabestrom zu schreiben.  
Typ: Boolesch  
Erforderlich: Nein

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/FlushStreamConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/FlushStreamConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/FlushStreamConfiguration) 

# Lexicon
<a name="API_Lexicon"></a>

Stellt den Lexikonnamen und den Lexikoninhalt im Zeichenkettenformat bereit. Weitere Informationen finden Sie unter [Pronunciation Lexicon Specification (PLS](https://www.w3.org/TR/pronunciation-lexicon/)) Version 1.0.

## Inhalt
<a name="API_Lexicon_Contents"></a>

 ** Content **   <a name="polly-Type-Lexicon-Content"></a>
Inhalt des Lexikons im Zeichenkettenformat. Der Inhalt eines Lexikons muss im PLS-Format vorliegen.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** Name **   <a name="polly-Type-Lexicon-Name"></a>
Name des Lexikons.  
Typ: Zeichenfolge  
Pattern: `[0-9A-Za-z]{1,20}`   
Erforderlich: Nein

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Lexicon) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Lexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Lexicon) 

# LexiconAttributes
<a name="API_LexiconAttributes"></a>

Enthält Metadaten, die das Lexikon beschreiben, z. B. die Anzahl der Lexeme, den Sprachcode usw. [Weitere Informationen finden Sie unter Lexika verwalten.](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html)

## Inhalt
<a name="API_LexiconAttributes_Contents"></a>

 ** Alphabet **   <a name="polly-Type-LexiconAttributes-Alphabet"></a>
Im Lexikon verwendetes phonetisches Alphabet. Gültige Werte sind `ipa` und `x-sampa`.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** LanguageCode **   <a name="polly-Type-LexiconAttributes-LanguageCode"></a>
Sprachcode, für den das Lexikon gilt. Ein Lexikon mit einem Sprachcode wie „en“ würde auf alle englischen Sprachen (en-GB, en-US, en-AUS, en-WLS usw.) angewendet werden.  
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

 ** LastModified **   <a name="polly-Type-LexiconAttributes-LastModified"></a>
Datum, an dem das Lexikon zuletzt geändert wurde (ein Zeitstempelwert).  
Typ: Zeitstempel  
Erforderlich: Nein

 ** LexemesCount **   <a name="polly-Type-LexiconAttributes-LexemesCount"></a>
Anzahl der Lexeme im Lexikon.  
Typ: Ganzzahl  
Erforderlich: Nein

 ** LexiconArn **   <a name="polly-Type-LexiconAttributes-LexiconArn"></a>
Amazon-Ressourcenname (ARN) des Lexikons.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** Size **   <a name="polly-Type-LexiconAttributes-Size"></a>
Gesamtgröße des Lexikons in Zeichen.  
Typ: Ganzzahl  
Erforderlich: Nein

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconAttributes) 

# LexiconDescription
<a name="API_LexiconDescription"></a>

Beschreibt den Inhalt des Lexikons.

## Inhalt
<a name="API_LexiconDescription_Contents"></a>

 ** Attributes **   <a name="polly-Type-LexiconDescription-Attributes"></a>
Stellt Lexikon-Metadaten bereit.  
Typ: [LexiconAttributes](API_LexiconAttributes.md) Objekt  
Erforderlich: Nein

 ** Name **   <a name="polly-Type-LexiconDescription-Name"></a>
Name des Lexikons.  
Typ: Zeichenfolge  
Pattern: `[0-9A-Za-z]{1,20}`   
Erforderlich: Nein

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconDescription) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconDescription) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconDescription) 

# StartSpeechSynthesisStreamActionStream
<a name="API_StartSpeechSynthesisStreamActionStream"></a>

Eingehender Eventstream zum Senden von Eingabe- und Steuerereignissen zur Verwaltung der bidirektionalen Sprachsynthese.

## Inhalt
<a name="API_StartSpeechSynthesisStreamActionStream_Contents"></a>

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

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

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 

# StartSpeechSynthesisStreamEventStream
<a name="API_StartSpeechSynthesisStreamEventStream"></a>

Ausgehender Event-Stream, der synthetisierte Audiodaten und Stream-Statusereignisse enthält.

## Inhalt
<a name="API_StartSpeechSynthesisStreamEventStream_Contents"></a>

 ** AudioEvent **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-AudioEvent"></a>
Ein Audioereignis, das synthetisierte Sprache enthält.  
Typ: [AudioEvent](API_AudioEvent.md) Objekt  
Erforderlich: Nein

 ** ServiceFailureException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceFailureException"></a>
Ein unbekannter Zustand hat einen Dienstausfall verursacht.  
Typ: Ausnahme  
HTTP Status Code: 500  
Erforderlich: Nein

 ** ServiceQuotaExceededException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceQuotaExceededException"></a>
Eine Ausnahme, die darauf hinweist, dass ein Dienstkontingent überschritten würde.  
Typ: Ausnahme  
HTTP-Statuscode: 402  
Erforderlich: Nein

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

 ** ThrottlingException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ThrottlingException"></a>
Eine Ausnahme, die darauf hinweist, dass die Anfrage gedrosselt wurde.  
Typ: Ausnahme  
HTTP-Statuscode: 400  
Erforderlich: Nein

 ** ValidationException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ValidationException"></a>
Eine Ausnahme, die darauf hinweist, dass die Eingabe nicht validiert wurde.  
Typ: Ausnahme  
HTTP-Statuscode: 400  
Erforderlich: Nein

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 

# StreamClosedEvent
<a name="API_StreamClosedEvent"></a>

Zeigt an, dass der Synthesestream geschlossen ist, und bietet zusammenfassende Informationen.

## Inhalt
<a name="API_StreamClosedEvent_Contents"></a>

 ** RequestCharacters **   <a name="polly-Type-StreamClosedEvent-RequestCharacters"></a>
Die Gesamtzahl der während der Streaming-Sitzung synthetisierten Zeichen.  
Typ: Ganzzahl  
Erforderlich: Nein

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StreamClosedEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StreamClosedEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StreamClosedEvent) 

# SynthesisTask
<a name="API_SynthesisTask"></a>

SynthesisTask Objekt, das Informationen über eine Sprachsyntheseaufgabe bereitstellt.

## Inhalt
<a name="API_SynthesisTask_Contents"></a>

 ** CreationTime **   <a name="polly-Type-SynthesisTask-CreationTime"></a>
Zeitstempel für den Zeitpunkt, zu dem die Syntheseaufgabe gestartet wurde.  
Typ: Zeitstempel  
Erforderlich: Nein

 ** Engine **   <a name="polly-Type-SynthesisTask-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 **   <a name="polly-Type-SynthesisTask-LanguageCode"></a>
Optionaler Sprachcode für eine Syntheseaufgabe. 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 **   <a name="polly-Type-SynthesisTask-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 **   <a name="polly-Type-SynthesisTask-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: Nein

 ** OutputUri **   <a name="polly-Type-SynthesisTask-OutputUri"></a>
Pfad für die Sprachausgabedatei.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** RequestCharacters **   <a name="polly-Type-SynthesisTask-RequestCharacters"></a>
Anzahl der synthetisierten fakturierbaren Zeichen.  
Typ: Ganzzahl  
Erforderlich: Nein

 ** SampleRate **   <a name="polly-Type-SynthesisTask-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 **   <a name="polly-Type-SynthesisTask-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 **   <a name="polly-Type-SynthesisTask-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

 ** TaskId **   <a name="polly-Type-SynthesisTask-TaskId"></a>
Die von Amazon Polly generierte Kennung für eine Sprachsyntheseaufgabe.  
Typ: Zeichenfolge  
Pattern: `^[a-zA-Z0-9_-]{1,100}$`   
Erforderlich: Nein

 ** TaskStatus **   <a name="polly-Type-SynthesisTask-TaskStatus"></a>
Aktueller Status der einzelnen Sprachsyntheseaufgabe.  
Typ: Zeichenfolge  
Zulässige Werte: `scheduled | inProgress | completed | failed`   
Erforderlich: Nein

 ** TaskStatusReason **   <a name="polly-Type-SynthesisTask-TaskStatusReason"></a>
Grund für den aktuellen Status einer bestimmten Sprachsyntheseaufgabe, einschließlich Fehler, wenn die Aufgabe fehlgeschlagen ist.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** TextType **   <a name="polly-Type-SynthesisTask-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 **   <a name="polly-Type-SynthesisTask-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: Nein

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesisTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesisTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesisTask) 

# TextEvent
<a name="API_TextEvent"></a>

Enthält Textinhalte, die zu Sprache synthetisiert werden sollen.

## Inhalt
<a name="API_TextEvent_Contents"></a>

 ** Text **   <a name="polly-Type-TextEvent-Text"></a>
Der Textinhalt, der synthetisiert werden soll. Wenn Sie `ssml` als angeben`TextType`, folgen Sie dem SSML-Format für den Eingabetext.  
Typ: Zeichenfolge  
Erforderlich: Ja

 ** FlushStreamConfiguration **   <a name="polly-Type-TextEvent-FlushStreamConfiguration"></a>
Konfiguration zur Steuerung, wann synthetisiertes Audio in den Ausgangsstream übertragen wird.  
Typ: [FlushStreamConfiguration](API_FlushStreamConfiguration.md) Objekt  
Erforderlich: Nein

 ** TextType **   <a name="polly-Type-TextEvent-TextType"></a>
Gibt an, ob der Eingabetext Klartext oder SSML ist. Standard: Klartext.  
Typ: Zeichenfolge  
Zulässige Werte: `ssml | text`   
Erforderlich: Nein

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/TextEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/TextEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/TextEvent) 

# ThrottlingReason
<a name="API_ThrottlingReason"></a>

Stellt Informationen zu einem bestimmten Drosselungsgrund bereit.

## Inhalt
<a name="API_ThrottlingReason_Contents"></a>

 ** reason **   <a name="polly-Type-ThrottlingReason-reason"></a>
Der Ursachencode, der erklärt, warum die Anfrage gedrosselt wurde.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** resource **   <a name="polly-Type-ThrottlingReason-resource"></a>
Die Ressource, die die Drosselung verursacht hat.  
Typ: Zeichenfolge  
Erforderlich: Nein

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ThrottlingReason) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ThrottlingReason) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ThrottlingReason) 

# ValidationExceptionField
<a name="API_ValidationExceptionField"></a>

Informationen zu einem Feld, bei dem die Überprüfung fehlgeschlagen ist.

## Inhalt
<a name="API_ValidationExceptionField_Contents"></a>

 ** message **   <a name="polly-Type-ValidationExceptionField-message"></a>
Eine Meldung, in der beschrieben wird, warum das Feld nicht validiert werden konnte.  
Typ: Zeichenfolge  
Erforderlich: Ja

 ** name **   <a name="polly-Type-ValidationExceptionField-name"></a>
Der Name des Felds, bei dem die Überprüfung fehlgeschlagen ist.  
Typ: Zeichenfolge  
Erforderlich: Ja

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ValidationExceptionField) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ValidationExceptionField) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ValidationExceptionField) 

# Voice
<a name="API_Voice"></a>

Beschreibung der Stimme.

## Inhalt
<a name="API_Voice_Contents"></a>

 ** AdditionalLanguageCodes **   <a name="polly-Type-Voice-AdditionalLanguageCodes"></a>
Zusätzliche Codes für Sprachen, die für die angegebene Stimme zusätzlich zur Standardsprache verfügbar sind.   
Die Standardsprache für Aditi ist beispielsweise Indisches Englisch (en-IN), weil es zuerst für diese Sprache verwendet wurde. Da Aditi zweisprachig ist und sowohl indisches Englisch als auch Hindi fließend spricht, würde dieser Parameter den Code anzeigen. `hi-IN`  
Typ: Zeichenfolgen-Array  
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

 ** Gender **   <a name="polly-Type-Voice-Gender"></a>
Geschlecht der Stimme.  
Typ: Zeichenfolge  
Zulässige Werte: `Female | Male`   
Erforderlich: Nein

 ** Id **   <a name="polly-Type-Voice-Id"></a>
Amazon Polly hat die Sprach-ID zugewiesen. Dies ist die ID, die Sie beim Aufrufen des `SynthesizeSpeech` Vorgangs angeben.  
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: Nein

 ** LanguageCode **   <a name="polly-Type-Voice-LanguageCode"></a>
Sprachcode der Stimme.  
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

 ** LanguageName **   <a name="polly-Type-Voice-LanguageName"></a>
Für Menschen lesbarer Name der Sprache in Englisch.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** Name **   <a name="polly-Type-Voice-Name"></a>
Name der Stimme (zum Beispiel Salli, Kendra usw.). Dadurch wird ein für Menschen lesbarer Sprachname bereitgestellt, den Sie möglicherweise in Ihrer Anwendung anzeigen.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** SupportedEngines **   <a name="polly-Type-Voice-SupportedEngines"></a>
Gibt an, welche Engines (`standard``neural`, `long-form` oder`generative`) von einer bestimmten Stimme unterstützt werden.  
Typ: Zeichenfolgen-Array  
Zulässige Werte: `standard | neural | long-form | generative`   
Erforderlich: Nein

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

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Voice) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Voice) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Voice) 

# Häufige Fehler
<a name="CommonErrors"></a>

In diesem Abschnitt werden die Fehler aufgeführt, die bei den API-Aktionen aller AWS Dienste häufig auftreten. Informationen zu Fehlern, die spezifisch für eine API-Aktion für diesen Service sind, finden Sie unter dem Thema für diese API-Aktion.

 **AccessDeniedException**   
Sie haben keinen ausreichenden Zugriff zum Durchführen dieser Aktion.  
HTTP Status Code: 400

 **IncompleteSignature**   
Die Anforderungssignatur entspricht nicht den AWS Standards.  
HTTP Status Code: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
Die Anforderungsverarbeitung ist fehlgeschlagen, da ein unbekannter Fehler, eine Ausnahme oder ein Fehler aufgetreten ist.  
HTTP Status Code: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
Die angeforderte Aktion oder Operation ist ungültig. Überprüfen Sie, ob die Aktion ordnungsgemäß eingegeben wurde.  
HTTP Status Code: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
Das angegebene X.509-Zertifikat oder die angegebene AWS Zugriffsschlüssel-ID ist in unseren Aufzeichnungen nicht vorhanden.  
HTTP Status Code: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
Sie haben keine Berechtigung zum Ausführen dieser Aktion.  
HTTP Status Code: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
Für die AWS Zugriffsschlüssel-ID ist ein Abonnement für den Dienst erforderlich.  
HTTP Status Code: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
Die Anfrage erreichte den Service mehr als 15 Minuten nach dem Datumsstempel auf der Anfrage oder mehr als 15 Minuten nach dem Ablaufdatum der Anfrage (z. B. bei vorsignierter Anfrage URLs), oder der Datumsstempel auf der Anfrage liegt mehr als 15 Minuten in der future.  
HTTP Status Code: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.  
HTTP Status Code: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
Die Anforderung wurde aufgrund der Drosselung von Anforderungen abgelehnt.  
HTTP Status Code: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
Die Eingabe erfüllt nicht die von einem AWS Dienst angegebenen Einschränkungen.  
HTTP Status Code: 400

# Geläufige Parameter
<a name="CommonParameters"></a>

Die folgende Liste enthält die Parameter, die alle Aktionen zum Signieren von Signature-Version-4-Anforderungen mit einer Abfragezeichenfolge verwenden. Alle aktionsspezifischen Parameter werden im Thema für diese Aktion aufgelistet. Weitere Informationen zu Signature Version 4 finden Sie unter [Signieren von AWS API-Anfragen](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) im *IAM-Benutzerhandbuch*.

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
Der Hashalgorithmus, den Sie zum Erstellen der Anforderungssignatur verwendet haben.  
Bedingung: Geben Sie diesen Parameter an, wenn Sie Authentifizierungsinformationen in eine Abfragezeichenfolge anstatt in den HTTP-Autorisierungsheader aufnehmen.  
Type: Zeichenkette  
Zulässige Werte: `AWS4-HMAC-SHA256`   
Required: Conditional

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
Der Wert des Anmeldeinformationsumfangs. Dabei handelt es sich um eine Zeichenfolge, die Ihren Zugriffsschlüssel, das Datum, die gewünschte Region und eine Zeichenfolge zur Beendigung („aws4\$1request“) beinhaltet. Der Wert wird im folgenden Format ausgedrückt: *Zugriffsschlüssel*/*JJJJMMTT*/*Region*/*Service*/aws4\$1request.  
Weitere Informationen finden Sie im *IAM-Benutzerhandbuch* unter [Erstellen einer signierten AWS API-Anfrage](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html).  
Bedingung: Geben Sie diesen Parameter an, wenn Sie Authentifizierungsinformationen in eine Abfragezeichenfolge anstatt in den HTTP-Autorisierungsheader aufnehmen.  
Type: Zeichenkette  
Required: Conditional

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
Das Datum, das zum Erstellen der Signatur verwendet wird. Das Format muss das ISO 8601-Basisformat (JJJJMMTT'T'SSMMSS'Z') sein. Beispielsweise ist das folgende Datum und Uhrzeit ein gültiger X-Amz-Date Wert:`20120325T120000Z`.  
Bedingung: X-Amz-Date ist bei allen Anforderungen optional. Damit kann das Datum überschrieben werden, das zum Signieren von Anforderungen verwendet wird. Wenn der Date-Header im ISO 8601-Grundformat angegeben ist, X-Amz-Date ist dies nicht erforderlich. Wenn verwendet X-Amz-Date wird, überschreibt er immer den Wert des Date-Headers. Weitere Informationen finden Sie unter [Elemente einer AWS API-Anforderungssignatur](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) im *IAM-Benutzerhandbuch*.  
Type: Zeichenkette  
Required: Conditional

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
Das temporäre Sicherheitstoken, das durch einen Aufruf von AWS -Security-Token-Service (AWS STS) abgerufen wurde. Eine Liste der Services, die temporäre Sicherheits-Anmeldeinformationen von AWS STS unterstützen, finden Sie im *IAM-Benutzerhandbuch* unter [AWS-Services , die mit IAM funktionieren](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html).  
Bedingung: Wenn Sie temporäre Sicherheitsanmeldedaten von verwenden AWS STS, müssen Sie das Sicherheitstoken angeben.  
Type: Zeichenkette  
Required: Conditional

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Gibt die hex-codierte Signatur an, die aus der zu signierenden Zeichenfolge und dem abgeleiteten Signaturschlüssel berechnet wurde.  
Bedingung: Geben Sie diesen Parameter an, wenn Sie Authentifizierungsinformationen in eine Abfragezeichenfolge anstatt in den HTTP-Autorisierungsheader aufnehmen.  
Type: Zeichenkette  
Required: Conditional

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Gibt alle HTTP-Header an, die als Teil der kanonischen Anforderung enthalten waren. Weitere Informationen zur Angabe signierter Header finden Sie unter [Erstellen einer signierten AWS API-Anfrage](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) im *IAM-Benutzerhandbuch*.  
Bedingung: Geben Sie diesen Parameter an, wenn Sie Authentifizierungsinformationen in eine Abfragezeichenfolge anstatt in den HTTP-Autorisierungsheader aufnehmen.  
Type: Zeichenkette  
Required: Conditional