As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Retorna a lista de vozes disponíveis para uso ao solicitar uma síntese de fala. Cada voz fala um idioma específico, é masculina ou feminina e é identificada por um ID, que é a versão ASCII do nome da voz. 

Ao sintetizar a fala (`SynthesizeSpeech`), você fornece o ID de voz para a voz desejada na lista de vozes exibidas em `DescribeVoices`.

Por exemplo, você deseja que seu aplicativo leitor de notícias leia notícias em um idioma específico, mas ofereça ao usuário a opção de escolher a voz. Usando a operação `DescribeVoices`, você pode fornecer ao usuário uma lista de vozes disponíveis para seleção.

 Opcionalmente, você pode especificar um código de idioma para filtrar as vozes disponíveis. Por exemplo, se você especificar `en-US`, a operação retornará uma lista de todas as vozes disponíveis em inglês dos EUA. 

Essa operação exige permissões para executar a ação `polly:DescribeVoices`.

## Sintaxe da Solicitação
<a name="API_DescribeVoices_RequestSyntax"></a>

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

## Parâmetros da Solicitação de URI
<a name="API_DescribeVoices_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [Engine](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-Engine"></a>
Especifica o mecanismo (`standard`, `neural`, `long-form` ou `generative`) usado pelo Amazon Polly ao processar o texto de entrada para síntese de fala.   
Valores válidos: `standard | neural | long-form | generative` 

 ** [IncludeAdditionalLanguageCodes](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-IncludeAdditionalLanguageCodes"></a>
Valor booleano que indica se deve retornar alguma voz bilíngue que use o idioma especificado como idioma adicional. Por exemplo, se você solicitar todos os idiomas que usam inglês dos EUA (en-US) e houver uma voz em italiano que fale italiano (it-IT) e inglês dos EUA, essa voz será incluída se você especificar, `yes` mas não se você especificar `no`.

 ** [LanguageCode](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-LanguageCode"></a>
 A tag de identificação do idioma (código ISO 639 para o nome do idioma-código ISO 3166 para o país) para filtrar a lista de vozes retornadas. Se você não especificar esse parâmetro opcional todas as vozes disponíveis serão retornadas.   
Valores válidos: `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>
Um token de paginação opaco retornou da operação `DescribeVoices` anterior. Se presente, indica de onde continuar a listagem.  
Restrições de tamanho: tamanho mínimo 0. Comprimento máximo de 4.096.

## Corpo da Solicitação
<a name="API_DescribeVoices_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<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" ]
      }
   ]
}
```

## Elementos de resposta
<a name="API_DescribeVoices_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [NextToken](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-NextToken"></a>
O token de paginação a ser usado na próxima solicitação para continuar a listagem de vozes. `NextToken` retorna apenas quando a resposta está truncada.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 0. Comprimento máximo de 4.096.

 ** [Voices](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-Voices"></a>
Lista de vozes com suas propriedades.  
Tipo: matriz de objetos [Voice](API_Voice.md)

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

 ** InvalidNextTokenException **   
O NextToken é inválido. Verifique se ele está escrito corretamente e tente de novo.  
Código de status HTTP: 400

 ** ServiceFailureException **   
Uma condição desconhecida causou uma falha no serviço.  
Código de status HTTP: 500

## Consulte também
<a name="API_DescribeVoices_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DescribeVoices)