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.

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