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á.

# Referência da API do Amazon Polly
<a name="API_Reference"></a>

O Amazon Polly é um serviço da web que facilita a síntese de fala com base em texto.

O serviço Amazon Polly fornece operações de API para sintetizar voz de alta qualidade com base em texto simples e linguagem SSML (Speech Synthesis Markup Language), além de gerenciar léxicos de pronúncias que permitem que você obtenha os melhores resultados para o domínio da sua aplicação.

Chamadas de API autenticadas devem ser assinadas usando o processo de assinatura do Signature versão 4. Para obter mais informações, consulte [Assinatura de solicitações de AWS API](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) no *Referência geral da Amazon Web Services*.

**Topics**
+ [Ações](API_Operations.md)
+ [Tipos de dados](API_Types.md)
+ [Erros comuns](CommonErrors.md)
+ [Parâmetros gerais](CommonParameters.md)

# Ações
<a name="API_Operations"></a>

As ações a seguir são compatíveis:
+  [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>

Exclui o léxico de pronúncia armazenado em uma Região da AWS. Um léxico que foi excluído não está disponível para síntese de fala, nem é possível recuperá-lo usando o ou. `GetLexicon` `ListLexicon` APIs

Para obter mais informações, consulte [Gerenciamento de léxicos](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

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

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

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

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

 ** [LexiconName](#API_DeleteLexicon_RequestSyntax) **   <a name="polly-DeleteLexicon-request-uri-Name"></a>
Nome da conexão a ser excluída. Deve ser um léxico existente na região.  
Padrão: `[0-9A-Za-z]{1,20}`   
Obrigatório: Sim

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

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_DeleteLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de Resposta
<a name="API_DeleteLexicon_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

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

 ** LexiconNotFoundException **   
O Amazon Polly não encontrou o léxico especificado. Isso pode ser causado por um léxico inexistente, pelo nome escrito incorretamente ou pela especificação de um léxico que está em uma região diferente.  
Verifique se o léxico existe, se está na região (consulte [ListLexicons](API_ListLexicons.md)) e se o nome dele está escrito corretamente. Tente novamente.  
Código de status HTTP: 404

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

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

# 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\$1\$1](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) 

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

Retorna o conteúdo do léxico de pronúncia especificado armazenado em uma Região da AWS. Para obter mais informações, consulte [Gerenciamento de léxicos](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

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

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

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

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

 ** [LexiconName](#API_GetLexicon_RequestSyntax) **   <a name="polly-GetLexicon-request-uri-Name"></a>
Nome do léxico.  
Padrão: `[0-9A-Za-z]{1,20}`   
Obrigatório: Sim

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

Essa solicitação não tem corpo.

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

## Elementos de resposta
<a name="API_GetLexicon_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.

 ** [Lexicon](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-Lexicon"></a>
Objeto de léxico que fornece o nome e o conteúdo da string do léxico.   
Tipo: objeto [Lexicon](API_Lexicon.md)

 ** [LexiconAttributes](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-LexiconAttributes"></a>
Metadados do léxico, incluindo alfabeto fonético usado, código do idioma, ARN do léxico, número de lexemas definidos nele e tamanho em bytes.  
Tipo: objeto [LexiconAttributes](API_LexiconAttributes.md)

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

 ** LexiconNotFoundException **   
O Amazon Polly não encontrou o léxico especificado. Isso pode ser causado por um léxico inexistente, pelo nome escrito incorretamente ou pela especificação de um léxico que está em uma região diferente.  
Verifique se o léxico existe, se está na região (consulte [ListLexicons](API_ListLexicons.md)) e se o nome dele está escrito corretamente. Tente novamente.  
Código de status HTTP: 404

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

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

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

Recupera um SpeechSynthesisTask objeto específico com base em seu TaskID. Esse objeto contém informações sobre determinada tarefa de síntese de fala, incluindo o status da tarefa e um link para o bucket do S3 contendo a saída da tarefa.

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

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

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

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

 ** [TaskId](#API_GetSpeechSynthesisTask_RequestSyntax) **   <a name="polly-GetSpeechSynthesisTask-request-uri-TaskId"></a>
O identificador gerado pelo Amazon Polly para uma tarefa de síntese de fala.  
Padrão: `^[a-zA-Z0-9_-]{1,100}$`   
Obrigatório: Sim

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

Essa solicitação não tem corpo.

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

## Elementos de resposta
<a name="API_GetSpeechSynthesisTask_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.

 ** [SynthesisTask](#API_GetSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-GetSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask objeto que fornece informações da tarefa solicitada, incluindo formato de saída, hora de criação, status da tarefa e assim por diante.  
Tipo: objeto [SynthesisTask](API_SynthesisTask.md)

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

 ** InvalidTaskIdException **   
O ID da tarefa fornecido não é válido. Forneça um ID de tarefa válido e tente novamente.  
Código de status HTTP: 400

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

 ** SynthesisTaskNotFoundException **   
A tarefa de Síntese de Fala com o ID de tarefa solicitado não foi encontrada.  
Código de Status HTTP: 400

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

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

Retorna uma lista de léxicos de pronúncia armazenados em uma Região da AWS. Para obter mais informações, consulte [Gerenciamento de léxicos](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

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

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

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

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

 ** [NextToken](#API_ListLexicons_RequestSyntax) **   <a name="polly-ListLexicons-request-uri-NextToken"></a>
Um token de paginação opaco retornado da operação `ListLexicons` anterior. Se presente, indica de onde continuar a lista de léxicos.  
Restrições de tamanho: tamanho mínimo 0. Comprimento máximo de 4.096.

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

Essa solicitação não tem corpo.

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

## Elementos de resposta
<a name="API_ListLexicons_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.

 ** [Lexicons](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-Lexicons"></a>
Uma lista de nomes e atributos do léxico.  
Tipo: matriz de objetos [LexiconDescription](API_LexiconDescription.md)

 ** [NextToken](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-NextToken"></a>
O token de paginação a ser usado na próxima solicitação para continuar a listagem de léxicos. Retornará `NextToken` somente se a resposta estiver truncada.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 0. Comprimento máximo de 4.096.

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

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

Retorna uma lista de SpeechSynthesisTask objetos ordenados pela data de criação. Essa operação pode filtrar as tarefas pelo status. Por exemplo, permitindo que os usuários listem somente as tarefas concluídas.

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

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

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

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

 ** [MaxResults](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-MaxResults"></a>
Número máximo de tarefas de síntese de voz retornadas em uma operação de lista.  
Faixa válida: valor mínimo de 1. Valor máximo de 100.

 ** [NextToken](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-NextToken"></a>
O token de paginação a ser usado na próxima solicitação para continuar a listagem das tarefas de síntese de fala.   
Restrições de tamanho: tamanho mínimo 0. Comprimento máximo de 4.096.

 ** [Status](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-Status"></a>
Status das tarefas de síntese de fala retornadas em uma operação de Lista  
Valores válidos: `scheduled | inProgress | completed | failed` 

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

Essa solicitação não tem corpo.

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

## Elementos de resposta
<a name="API_ListSpeechSynthesisTasks_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_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-NextToken"></a>
Um token de paginação opaco retornado da operação de Lista anterior nessa solicitação. Se presente, indica onde continuar a listagem.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 0. Comprimento máximo de 4.096.

 ** [SynthesisTasks](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-SynthesisTasks"></a>
Lista de SynthesisTask objetos que fornece informações da tarefa especificada na solicitação de lista, incluindo formato de saída, hora de criação, status da tarefa e assim por diante.  
Tipo: matriz de objetos [SynthesisTask](API_SynthesisTask.md)

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

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

Armazena um léxico de pronúncia em uma Região da AWS. Se um léxico com o mesmo nome já existir na região, ele será substituído pelo novo léxico. As operações do léxico têm consistência eventual, portanto, pode levar algum tempo até que o léxico esteja disponível para a operação. SynthesizeSpeech 

Para obter mais informações, consulte [Gerenciamento de léxicos](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

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

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

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

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

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

 ** [LexiconName](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-uri-Name"></a>
Nome do léxico. O nome deve seguir o formato expresso regular [0-9A-Za-z]\$11,20\$1. Ou seja, o nome é uma sequência alfanumérica com distinção entre maiúsculas e minúsculas de até 20 caracteres.   
Padrão: `[0-9A-Za-z]{1,20}`   
Obrigatório: Sim

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

A solicitação aceita os dados a seguir no formato JSON.

 ** [Content](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-Content"></a>
Conteúdo do léxico PLS como dados de string.  
Tipo: sequência  
Obrigatório: sim

## Sintaxe da resposta
<a name="API_PutLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de Resposta
<a name="API_PutLexicon_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

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

 ** InvalidLexiconException **   
O Amazon Polly não encontrou o léxico especificado. Verifique se o nome do léxico está escrito corretamente e tente de novo.  
Código de status HTTP: 400

 ** LexiconSizeExceededException **   
O tamanho máximo do léxico especificado seria excedido por essa operação.  
Código de status HTTP: 400

 ** MaxLexemeLengthExceededException **   
O tamanho máximo do lexema seria excedido por essa operação.  
Código de status HTTP: 400

 ** MaxLexiconsNumberExceededException **   
O número máximo de léxicos seria excedido por essa operação.  
Código de status HTTP: 400

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

 ** UnsupportedPlsAlphabetException **   
O alfabeto especificado pelo léxico não é um alfabeto compatível. Os valores válidos são `x-sampa` e `ipa`.  
Código de status HTTP: 400

 ** UnsupportedPlsLanguageException **   
O idioma especificado no léxico não é compatível. Para ver uma lista dos idiomas compatíveis, consulte [Atributos do léxico](https://docs.aws.amazon.com/polly/latest/dg/API_LexiconAttributes.html).  
Código de Status HTTP: 400

## Consulte também
<a name="API_PutLexicon_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/PutLexicon) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/PutLexicon) 

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

Sintetiza entrada UTF-8, texto simples ou SSML em uma conexão de streaming bidirecional. Especifique os parâmetros de síntese nos cabeçalhos HTTP/2, envie texto incrementalmente como eventos no fluxo de entrada e receba áudio sintetizado assim que estiver disponível.

Essa operação serve como uma contrapartida bidirecional para: `SynthesizeSpeech`
+  [SynthesizeSpeech](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html) 

## Sintaxe da Solicitação
<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"
   }
}
```

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

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

 ** [Engine](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-Engine"></a>
Especifica o mecanismo que o Amazon Polly deve usar ao processar texto de entrada para síntese de fala. Atualmente, somente o `generative` motor é suportado. Se você especificar uma voz que o mecanismo selecionado não suporta, o Amazon Polly retornará um erro.  
Valores válidos: `standard | neural | long-form | generative`   
Obrigatório: Sim

 ** [LanguageCode](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LanguageCode"></a>
Um parâmetro opcional que define o código do idioma para a solicitação de síntese de fala. Especifique esse parâmetro somente ao usar uma voz bilíngue. Se uma voz bilíngue for usada e nenhum código de idioma for especificado, o Amazon Polly usará o idioma padrão da voz bilíngue.  
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` 

 ** [LexiconNames](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LexiconNames"></a>
Os nomes de um ou mais léxicos de pronúncia para o serviço aplicar durante a síntese. O Amazon Polly aplica léxicos somente quando o idioma do léxico corresponde ao idioma da voz.  
Membros da matriz: número máximo de 5 itens.  
Padrão: `[0-9A-Za-z]{1,20}` 

 ** [OutputFormat](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-OutputFormat"></a>
O formato de áudio para a fala sintetizada. Atualmente, o Amazon Polly não oferece suporte a marcas de fala JSON.  
Valores válidos: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Obrigatório: Sim

 ** [SampleRate](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-SampleRate"></a>
A frequência de áudio, especificada em Hz.

 ** [VoiceId](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-VoiceId"></a>
A voz a ser usada em síntese. Para obter uma lista das vozes disponíveis IDs, use a [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operação.  
Valores válidos: `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`   
Obrigatório: Sim

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

A solicitação aceita os dados a seguir no formato JSON.

 ** [CloseStreamEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-CloseStreamEvent"></a>
Um evento que indica o fim do fluxo de entrada.  
Tipo: objeto [CloseStreamEvent](API_CloseStreamEvent.md)  
Obrigatório: não

 ** [TextEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-TextEvent"></a>
Um evento de texto contendo conteúdo a ser sintetizado.  
Tipo: objeto [TextEvent](API_TextEvent.md)  
Obrigatório: não

## Sintaxe da resposta
<a name="API_StartSpeechSynthesisStream_ResponseSyntax"></a>

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

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

## Elementos de resposta
<a name="API_StartSpeechSynthesisStream_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.

 ** [AudioEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-AudioEvent"></a>
Um evento de áudio contendo fala sintetizada.  
Tipo: objeto [AudioEvent](API_AudioEvent.md)

 ** [ServiceFailureException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceFailureException"></a>
Uma condição desconhecida causou uma falha no serviço.  
Tipo: Exceção  
Código de status HTTP: 500

 ** [ServiceQuotaExceededException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceQuotaExceededException"></a>
Uma exceção indicando que uma cota de serviço seria excedida.  
Tipo: Exceção  
Código de status HTTP: 402

 ** [StreamClosedEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-StreamClosedEvent"></a>
Um evento, com informações resumidas, indicando que o stream foi encerrado.  
Tipo: objeto [StreamClosedEvent](API_StreamClosedEvent.md)

 ** [ThrottlingException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ThrottlingException"></a>
Uma exceção indicando que a solicitação foi limitada.  
Tipo: Exceção  
Código de status HTTP: 400

 ** [ValidationException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ValidationException"></a>
Uma exceção indicando falha na validação da entrada.  
Tipo: Exceção  
Código de status HTTP: 400

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

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

 ** ServiceQuotaExceededException **   
A solicitação faria com que uma cota de serviço fosse excedida.    
 ** quotaCode **   
O código da cota que identifica a cota específica.  
 ** serviceCode **   
O código do serviço que identifica o serviço de origem.
Código de status HTTP: 402

 ** ThrottlingException **   
A solicitação foi negada devido à limitação da solicitação.    
 ** throttlingReasons **   
Uma lista de motivos que explicam por que a solicitação foi suspensa.
Código de status HTTP: 400

 ** ValidationException **   
A entrada não atende às restrições especificadas pelo serviço da .    
 ** fields **   
Os campos que causaram o erro de validação.  
 ** reason **   
O motivo pelo qual a solicitação falhou na validação.
Código de Status HTTP: 400

## Consulte também
<a name="API_StartSpeechSynthesisStream_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/StartSpeechSynthesisStream) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStream) 

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

Permite a criação de uma tarefa de síntese assíncrona, iniciando uma nova `SpeechSynthesisTask`. Essa operação requer todas as informações padrão necessárias para a síntese de fala, além do nome de um bucket do Amazon S3 para que o serviço armazene a saída da tarefa de síntese e dois parâmetros opcionais (`OutputS3KeyPrefix` e `SnsTopicArn`). Depois que a tarefa de síntese for criada, a operação retornará um objeto de `SpeechSynthesisTask` que incluirá um identificador a tarefa e o status atual. O objeto `SpeechSynthesisTask` fica disponível por 72 horas após o início da tarefa de síntese assíncrona.

## Sintaxe da Solicitação
<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"
}
```

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

A solicitação não usa nenhum parâmetro de URI.

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

A solicitação aceita os dados a seguir no formato JSON.

 ** [Engine](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Engine"></a>
Especifica o mecanismo (`standard`, `neural`, `long-form` ou `generative`) que o Amazon Polly usará ao processar texto de entrada para a síntese de fala. Usar uma voz que não seja compatível com o mecanismo selecionado resultará em erro.  
Tipo: string  
Valores válidos: `standard | neural | long-form | generative`   
Obrigatório: não

 ** [LanguageCode](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LanguageCode"></a>
Código de idioma opcional para a solicitação de síntese de fala. É necessário apenas se estiver usando uma voz bilíngue, como Aditi, que pode ser usada para inglês indiano (en-IN) ou hindi (hi-IN).   
Se uma voz bilíngue for usada e nenhum código de idioma for especificado, o Amazon Polly usará o idioma padrão da voz bilíngue. O idioma padrão para qualquer voz é aquele retornado pela [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operação do `LanguageCode` parâmetro. Por exemplo, se nenhum código de idioma for especificado, Aditi usará inglês indiano em vez de hindi.  
Tipo: string  
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`   
Obrigatório: não

 ** [LexiconNames](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LexiconNames"></a>
Lista de um ou mais nomes de léxico de pronúncia que você deseja que o serviço aplique durante a síntese. O léxico só será aplicado ao texto se o idioma especificado nele for o mesmo que o da voz.   
Tipo: matriz de strings  
Membros da matriz: número máximo de 5 itens.  
Padrão: `[0-9A-Za-z]{1,20}`   
Obrigatório: não

 ** [OutputFormat](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputFormat"></a>
O formato no qual a saída retornada será codificada. Para transmissão de áudio, serão mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law ou pcm. Marcas de fala serão JSON.   
Tipo: string  
Valores válidos: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Obrigatório: Sim

 ** [OutputS3BucketName](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3BucketName"></a>
Nome do bucket do Amazon S3 no qual o arquivo de saída será salvo.  
Tipo: sequência  
Padrão: `^[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]$`   
Obrigatório: Sim

 ** [OutputS3KeyPrefix](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3KeyPrefix"></a>
Prefixo das chaves do Amazon S3 para o arquivo de fala de saída.  
Tipo: sequência  
Padrão: `^[0-9a-zA-Z\/\!\-_\.\*\'\(\):;\$@=+\,\?&]{0,800}$`   
Obrigatório: não

 ** [SampleRate](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SampleRate"></a>
A frequência de áudio especificada em Hz.  
Os valores válidos para MP3 e ogg\$1vorbis são 8000, 16000, 22050 e 24000. O valor padrão para vozes padrão é 22050. O valor padrão para vozes neurais é 24000. O valor padrão para vozes em formato longo é “24.000”. O valor padrão para vozes generativas é “24000”.  
Os valores válidos para pcm são 8000 e 16000. O valor padrão é 16000.   
O valor válido para ogg\$1opus é “48000".   
O valor válido para mu-law e a-law é “8000".   
Tipo: string  
Obrigatório: não

 ** [SnsTopicArn](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SnsTopicArn"></a>
O ARN do tópico do SNS é usado opcionalmente para fornecer notificação de status para uma tarefa de síntese de fala.  
Tipo: sequência  
Padrão: `^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)$`   
Obrigatório: não

 ** [SpeechMarkTypes](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SpeechMarkTypes"></a>
Tipo de marcas de fala retornadas para o texto de entrada.  
Tipo: matriz de strings  
Membros da matriz: número máximo de 4 itens.  
Valores válidos: `sentence | ssml | viseme | word`   
Obrigatório: não

 ** [Text](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Text"></a>
Texto de entrada a ser sintetizado. Se você especificar ssml como TextType, siga o formato SSML para o texto de entrada.   
Tipo: String  
Obrigatório: Sim

 ** [TextType](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-TextType"></a>
Especifica se o texto de entrada é simples ou SSML. O valor padrão é texto sem formatação.   
Tipo: string  
Valores válidos: `ssml | text`   
Obrigatório: não

 ** [VoiceId](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-VoiceId"></a>
ID de voz a ser usado para a síntese.   
Tipo: string  
Valores válidos: `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`   
Obrigatório: sim

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

## Elementos de resposta
<a name="API_StartSpeechSynthesisTask_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.

 ** [SynthesisTask](#API_StartSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask objeto que fornece informações e atributos sobre uma tarefa de síntese de fala recém-enviada.  
Tipo: objeto [SynthesisTask](API_SynthesisTask.md)

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

 ** EngineNotSupportedException **   
Esse mecanismo não é compatível com a voz que você designou. Escolha uma nova voz compatível com o mecanismo ou troque-o e reinicie a operação.  
Código de status HTTP: 400

 ** InvalidS3BucketException **   
O nome do bucket do Amazon S3 fornecido é inválido. Verifique a entrada com os requisitos de nomenclatura do bucket do S3 e tente novamente.  
Código de status HTTP: 400

 ** InvalidS3KeyException **   
O prefixo das chaves do Amazon S3 fornecido é inválido. Forneça um nome de chave de objeto S3 válido.  
Código de status HTTP: 400

 ** InvalidSampleRateException **   
A taxa de amostragem especificada é inválida.  
Código de status HTTP: 400

 ** InvalidSnsTopicArnException **   
O ARN do tópico SNS fornecido é inválido. Forneça um ARN de tópico de SNS válido e tente novamente.  
Código de status HTTP: 400

 ** InvalidSsmlException **   
O SSML fornecido é inválido. Verifique a sintaxe do SSML, a ortografia e valores das tags tente novamente.  
Código de status HTTP: 400

 ** LanguageNotSupportedException **   
O idioma especificado não é compatível com o Amazon Polly nessa capacidade.  
Código de status HTTP: 400

 ** LexiconNotFoundException **   
O Amazon Polly não encontrou o léxico especificado. Isso pode ser causado por um léxico inexistente, pelo nome escrito incorretamente ou pela especificação de um léxico que está em uma região diferente.  
Verifique se o léxico existe, se está na região (consulte [ListLexicons](API_ListLexicons.md)) e se o nome dele está escrito corretamente. Tente novamente.  
Código de status HTTP: 404

 ** MarksNotSupportedForFormatException **   
As marcas de fala não são compatíveis com o `OutputFormat` selecionado. As marcas de fala estão disponíveis apenas para conteúdo em formato `json`.  
Código de status HTTP: 400

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

 ** SsmlMarksNotSupportedForTextTypeException **   
As marcas de fala SSML não são compatíveis com a entrada de texto sem formatação.  
Código de status HTTP: 400

 ** TextLengthExceededException **   
O valor do parâmetro Texto é maior que os limites aceitos. Para a API do `SynthesizeSpeech`, o limite para texto de entrada é de no máximo 6 mil caracteres, dos quais não mais do que 3 mil podem ser faturados. Para a API `StartSpeechSynthesisTask`, o máximo é de 200 mil caracteres, dos quais não mais do que 100 mil podem ser faturados. Tags SSML não são contadas como caracteres cobrados.  
Código de Status HTTP: 400

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

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

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

Sintetiza entrada UTF-8, texto sem formatação ou SSML em um fluxo de bytes. A entrada SSML deve ser válida e bem formada. Alguns alfabetos podem não estar disponíveis com todas as vozes (por exemplo, o cirílico pode não ser lido pelas vozes em inglês), a menos que o mapeamento de fonemas seja usado. Para obter mais informações, consulte [Como funciona](https://docs.aws.amazon.com/polly/latest/dg/how-text-to-speech-works.html).

## Sintaxe da Solicitação
<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"
}
```

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

A solicitação não usa nenhum parâmetro de URI.

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

A solicitação aceita os dados a seguir no formato JSON.

 ** [Engine](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Engine"></a>
Especifica o mecanismo (`standard`, `neural`, `long-form` ou `generative`) que o Amazon Polly usará ao processar texto de entrada para a síntese de fala. Forneça um mecanismo compatível com a voz selecionada. Se você não fornecer um mecanismo, será selecionado o mecanismo padrão. Se a voz escolhida não for compatível com o mecanismo padrão, ocorrerá um erro. Para obter informações sobre as vozes do Amazon Polly e quais estão disponíveis para cada mecanismo, consulte [Vozes disponíveis](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html).  
Tipo: string  
Valores válidos: `standard | neural | long-form | generative`   
Obrigatório: não

 ** [LanguageCode](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LanguageCode"></a>
Código de idioma opcional para a solicitação Synthesize Speech. É necessário apenas se estiver usando uma voz bilíngue, como Aditi, que pode ser usada para inglês indiano (en-IN) ou hindi (hi-IN).   
Se uma voz bilíngue for usada e nenhum código de idioma for especificado, o Amazon Polly usará o idioma padrão da voz bilíngue. O idioma padrão para qualquer voz é aquele retornado pela [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operação do `LanguageCode` parâmetro. Por exemplo, se nenhum código de idioma for especificado, Aditi usará inglês indiano em vez de hindi.  
Tipo: string  
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`   
Obrigatório: não

 ** [LexiconNames](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LexiconNames"></a>
Lista de um ou mais nomes de léxico de pronúncia que você deseja que o serviço aplique durante a síntese. O léxico só será aplicado ao texto se o idioma especificado nele for o mesmo que o da voz. Para obter informações sobre como armazenar léxicos, consulte. [PutLexicon](https://docs.aws.amazon.com/polly/latest/dg/API_PutLexicon.html)  
Tipo: matriz de strings  
Membros da matriz: número máximo de 5 itens.  
Padrão: `[0-9A-Za-z]{1,20}`   
Obrigatório: não

 ** [OutputFormat](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-OutputFormat"></a>
 O formato no qual a saída retornada será codificada. Para transmissão de áudio, serão mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law ou pcm. Marcas de fala serão JSON.   
Quando o pcm é usado, o conteúdo retornado está audio/pcm em um formato little-endian assinado de 16 bits, 1 canal (mono).   
Tipo: string  
Valores válidos: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Obrigatório: Sim

 ** [SampleRate](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SampleRate"></a>
A frequência de áudio especificada em Hz.  
Os valores válidos para MP3 e ogg\$1vorbis são “8000”, “16000”, “22050”, “24000”, “44100” e “48000”. O valor padrão para vozes padrão é 22050. O valor padrão para vozes neurais é 24000. O valor padrão para vozes em formato longo é “24.000”. O valor padrão para vozes generativas é “24000”.  
Os valores válidos para pcm são 8000 e 16000. O valor padrão é 16000.   
O valor válido para ogg\$1opus é “48000".   
O valor válido para mu-law e a-law é “8000".   
Tipo: string  
Obrigatório: não

 ** [SpeechMarkTypes](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SpeechMarkTypes"></a>
Tipo de marcas de fala retornadas para o texto de entrada.  
Tipo: matriz de strings  
Membros da matriz: número máximo de 4 itens.  
Valores válidos: `sentence | ssml | viseme | word`   
Obrigatório: não

 ** [Text](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Text"></a>
 Insira texto para sintetizar. Se você especificar `ssml` como `TextType`, siga o formato SSML para o texto de entrada.   
Tipo: String  
Obrigatório: Sim

 ** [TextType](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-TextType"></a>
 Especifica se o texto de entrada é simples ou SSML. O valor padrão é texto sem formatação. Para obter mais informações, consulte [Using SSML](https://docs.aws.amazon.com/polly/latest/dg/ssml.html).  
Tipo: string  
Valores válidos: `ssml | text`   
Obrigatório: não

 ** [VoiceId](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-VoiceId"></a>
 ID de voz a ser usado para a síntese. Você pode obter uma lista das vozes disponíveis IDs chamando a [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operação.   
Tipo: string  
Valores válidos: `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`   
Obrigatório: sim

## Sintaxe da resposta
<a name="API_SynthesizeSpeech_ResponseSyntax"></a>

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

AudioStream
```

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

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

A resposta retorna os cabeçalhos HTTP a seguir.

 ** [ContentType](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-ContentType"></a>
 Especifica o tipo de fluxo de áudio. Isso deve refletir o `OutputFormat` parâmetro em sua solicitação.   
+  Se você solicitar `mp3` como o `OutputFormat`, o `ContentType` retornado será áudio/mpeg. 
+  Se você solicitar `ogg_vorbis` como o `OutputFormat`, o `ContentType` retornado será audio/ogg. 
+  Se você solicitar `ogg_opus` como o `OutputFormat`, o `ContentType` retornado será audio/ogg. 
+  Se você solicitar `pcm` como o`OutputFormat`, o `ContentType` retornado estará audio/pcm em um formato little-endian assinado de 16 bits, 1 canal (mono). 
+  Se você solicitar `mu-law` como o`OutputFormat`, o `ContentType` retornado é áudio/mulaw. 
+  Se você solicitar `a-law` como o`OutputFormat`, o `ContentType` retornado é áudio/alaw. 
+ Se você solicitar `json` como o`OutputFormat`, o `ContentType` retornado é application/x-json-stream.
 

 ** [RequestCharacters](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-RequestCharacters"></a>
Número de caracteres sintetizados.

A resposta retorna as informações a seguir como corpo HTTP.

 ** [AudioStream](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-AudioStream"></a>
 Fluxo contendo a fala sintetizada. 

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

 ** EngineNotSupportedException **   
Esse mecanismo não é compatível com a voz que você designou. Escolha uma nova voz compatível com o mecanismo ou troque-o e reinicie a operação.  
Código de status HTTP: 400

 ** InvalidSampleRateException **   
A taxa de amostragem especificada é inválida.  
Código de status HTTP: 400

 ** InvalidSsmlException **   
O SSML fornecido é inválido. Verifique a sintaxe do SSML, a ortografia e valores das tags tente novamente.  
Código de status HTTP: 400

 ** LanguageNotSupportedException **   
O idioma especificado não é compatível com o Amazon Polly nessa capacidade.  
Código de status HTTP: 400

 ** LexiconNotFoundException **   
O Amazon Polly não encontrou o léxico especificado. Isso pode ser causado por um léxico inexistente, pelo nome escrito incorretamente ou pela especificação de um léxico que está em uma região diferente.  
Verifique se o léxico existe, se está na região (consulte [ListLexicons](API_ListLexicons.md)) e se o nome dele está escrito corretamente. Tente novamente.  
Código de status HTTP: 404

 ** MarksNotSupportedForFormatException **   
As marcas de fala não são compatíveis com o `OutputFormat` selecionado. As marcas de fala estão disponíveis apenas para conteúdo em formato `json`.  
Código de status HTTP: 400

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

 ** SsmlMarksNotSupportedForTextTypeException **   
As marcas de fala SSML não são compatíveis com a entrada de texto sem formatação.  
Código de status HTTP: 400

 ** TextLengthExceededException **   
O valor do parâmetro Texto é maior que os limites aceitos. Para a API do `SynthesizeSpeech`, o limite para texto de entrada é de no máximo 6 mil caracteres, dos quais não mais do que 3 mil podem ser faturados. Para a API `StartSpeechSynthesisTask`, o máximo é de 200 mil caracteres, dos quais não mais do que 100 mil podem ser faturados. Tags SSML não são contadas como caracteres cobrados.  
Código de Status HTTP: 400

## Consulte também
<a name="API_SynthesizeSpeech_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/SynthesizeSpeech) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesizeSpeech) 

# Tipos de dados
<a name="API_Types"></a>

Os seguintes tipos de dados são compatíveis:
+  [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>

Contém uma parte dos dados de áudio sintetizados.

## Conteúdo
<a name="API_AudioEvent_Contents"></a>

 ** AudioChunk **   <a name="polly-Type-AudioEvent-AudioChunk"></a>
Uma parte dos dados de áudio sintetizados codificados no formato especificado pelo parâmetro. `OutputFormat`  
Tipo: Objeto de dados binários codificado em Base64  
Obrigatório: Não

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

Para obter mais informações sobre como usar essa API em uma linguagem específica AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/AudioEvent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/AudioEvent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/AudioEvent) 

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

Indica o fim do fluxo de entrada. Depois de enviar esse evento, o stream de entrada será fechado e todo o áudio será retornado.

## Conteúdo
<a name="API_CloseStreamEvent_Contents"></a>

Os membros dessa estrutura de exceção dependem do contexto.

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/CloseStreamEvent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/CloseStreamEvent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/CloseStreamEvent) 

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

Configuração que controla quando os dados de áudio sintetizados são enviados no fluxo de saída.

## Conteúdo
<a name="API_FlushStreamConfiguration_Contents"></a>

 ** Force **   <a name="polly-Type-FlushStreamConfiguration-Force"></a>
Especifica se o mecanismo de síntese deve ser forçado a gravar imediatamente dados de áudio em buffer no fluxo de saída.  
Tipo: booliano  
Obrigatório: não

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/FlushStreamConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/FlushStreamConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/FlushStreamConfiguration) 

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

Fornece o nome e o conteúdo do léxico em formato de string. Para mais informações, consulte [Especificação do léxico de pronúncia (PLS) Versão 1.0](https://www.w3.org/TR/pronunciation-lexicon/) no site do W3C.

## Conteúdo
<a name="API_Lexicon_Contents"></a>

 ** Content **   <a name="polly-Type-Lexicon-Content"></a>
Conteúdo do léxico em formato de string. O conteúdo de um léxico deve estar no formato PLS.  
Tipo: sequência  
Obrigatório: Não

 ** Name **   <a name="polly-Type-Lexicon-Name"></a>
Nome do léxico.  
Tipo: sequência  
Padrão: : `[0-9A-Za-z]{1,20}`   
Obrigatório: Não

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

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para 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 para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Lexicon) 

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

Contém metadados que descrevem o léxico, como o número de lexemas, o código do idioma e assim por diante. Para mais informações, consulte [Gerenciamento de léxicos](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

## Conteúdo
<a name="API_LexiconAttributes_Contents"></a>

 ** Alphabet **   <a name="polly-Type-LexiconAttributes-Alphabet"></a>
Alfabeto fonético usado no léxico. Os valores válidos são `ipa` e `x-sampa`.  
Tipo: sequência  
Obrigatório: não

 ** LanguageCode **   <a name="polly-Type-LexiconAttributes-LanguageCode"></a>
Código de idioma ao qual o léxico se aplica. Um léxico com um código de idioma como “en” seria aplicado a todos os idiomas ingleses (en-GB, en-US, en-AUS, en-WLS e assim por diante).  
Tipo: sequência  
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`   
Obrigatório: não

 ** LastModified **   <a name="polly-Type-LexiconAttributes-LastModified"></a>
Quando o léxico da data foi modificado pela última vez (um valor de carimbo de data/hora).  
Tipo: carimbo de data/hora  
Obrigatório: não

 ** LexemesCount **   <a name="polly-Type-LexiconAttributes-LexemesCount"></a>
Número de lexemas no léxico.  
Tipo: inteiro  
Obrigatório: não

 ** LexiconArn **   <a name="polly-Type-LexiconAttributes-LexiconArn"></a>
O Nome do recurso da Amazon (ARN) da função.  
Tipo: sequência  
Obrigatório: não

 ** Size **   <a name="polly-Type-LexiconAttributes-Size"></a>
O tamanho total do léxico, em caracteres.  
Tipo: inteiro  
Obrigatório: não

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconAttributes) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconAttributes) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconAttributes) 

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

Descreve o conteúdo do léxico.

## Conteúdo
<a name="API_LexiconDescription_Contents"></a>

 ** Attributes **   <a name="polly-Type-LexiconDescription-Attributes"></a>
Fornece metadados do léxico.  
Tipo: objeto [LexiconAttributes](API_LexiconAttributes.md)  
Obrigatório: Não

 ** Name **   <a name="polly-Type-LexiconDescription-Name"></a>
Nome do léxico.  
Tipo: sequência  
Padrão: : `[0-9A-Za-z]{1,20}`   
Obrigatório: Não

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

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para 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 para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconDescription) 

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

Fluxo de eventos de entrada para enviar eventos de entrada e controle para gerenciar a síntese bidirecional da fala.

## Conteúdo
<a name="API_StartSpeechSynthesisStreamActionStream_Contents"></a>

 ** CloseStreamEvent **   <a name="polly-Type-StartSpeechSynthesisStreamActionStream-CloseStreamEvent"></a>
Um evento que indica o fim do fluxo de entrada.  
Tipo: objeto [CloseStreamEvent](API_CloseStreamEvent.md)  
Obrigatório: não

 ** TextEvent **   <a name="polly-Type-StartSpeechSynthesisStreamActionStream-TextEvent"></a>
Um evento de texto contendo conteúdo a ser sintetizado.  
Tipo: objeto [TextEvent](API_TextEvent.md)  
Obrigatório: não

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

Para obter mais informações sobre como usar essa API em uma linguagem específica AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 

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

Fluxo de eventos de saída que contém dados de áudio sintetizados e eventos de status do fluxo.

## Conteúdo
<a name="API_StartSpeechSynthesisStreamEventStream_Contents"></a>

 ** AudioEvent **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-AudioEvent"></a>
Um evento de áudio contendo fala sintetizada.  
Tipo: objeto [AudioEvent](API_AudioEvent.md)  
Obrigatório: não

 ** ServiceFailureException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceFailureException"></a>
Uma condição desconhecida causou uma falha no serviço.  
Tipo: Exceção  
Código de status HTTP: 500  
Obrigatório: não

 ** ServiceQuotaExceededException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceQuotaExceededException"></a>
Uma exceção indicando que uma cota de serviço seria excedida.  
Tipo: Exceção  
Código de status HTTP: 402  
Obrigatório: não

 ** StreamClosedEvent **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-StreamClosedEvent"></a>
Um evento, com informações resumidas, indicando que o stream foi encerrado.  
Tipo: objeto [StreamClosedEvent](API_StreamClosedEvent.md)  
Obrigatório: não

 ** ThrottlingException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ThrottlingException"></a>
Uma exceção indicando que a solicitação foi limitada.  
Tipo: Exceção  
Código de status HTTP: 400  
Obrigatório: não

 ** ValidationException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ValidationException"></a>
Uma exceção indicando falha na validação da entrada.  
Tipo: Exceção  
Código de status HTTP: 400  
Obrigatório: Não

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 

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

Indica que o fluxo de síntese está fechado e fornece informações resumidas.

## Conteúdo
<a name="API_StreamClosedEvent_Contents"></a>

 ** RequestCharacters **   <a name="polly-Type-StreamClosedEvent-RequestCharacters"></a>
O número total de caracteres sintetizados durante a sessão de streaming.  
Tipo: inteiro  
Obrigatório: não

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StreamClosedEvent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StreamClosedEvent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StreamClosedEvent) 

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

SynthesisTask objeto que fornece informações sobre uma tarefa de síntese de fala.

## Conteúdo
<a name="API_SynthesisTask_Contents"></a>

 ** CreationTime **   <a name="polly-Type-SynthesisTask-CreationTime"></a>
Carimbo de data/hora em que a tarefa de síntese foi iniciada.  
Tipo: carimbo de data/hora  
Obrigatório: não

 ** Engine **   <a name="polly-Type-SynthesisTask-Engine"></a>
Especifica o mecanismo (`standard`, `neural`, `long-form` ou `generative`) que o Amazon Polly usará ao processar texto de entrada para a síntese de fala. Usar uma voz que não seja compatível com o mecanismo selecionado resultará em erro.  
Tipo: string  
Valores válidos: `standard | neural | long-form | generative`   
Obrigatório: não

 ** LanguageCode **   <a name="polly-Type-SynthesisTask-LanguageCode"></a>
Código de idioma opcional para uma tarefa de síntese. É necessário apenas se estiver usando uma voz bilíngue, como Aditi, que pode ser usada para inglês indiano (en-IN) ou hindi (hi-IN).   
Se uma voz bilíngue for usada e nenhum código de idioma for especificado, o Amazon Polly usará o idioma padrão da voz bilíngue. O idioma padrão para qualquer voz é aquele retornado pela [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operação do `LanguageCode` parâmetro. Por exemplo, se nenhum código de idioma for especificado, Aditi usará inglês indiano em vez de hindi.  
Tipo: string  
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`   
Obrigatório: não

 ** LexiconNames **   <a name="polly-Type-SynthesisTask-LexiconNames"></a>
Lista de um ou mais nomes de léxico de pronúncia que você deseja que o serviço aplique durante a síntese. O léxico só será aplicado ao texto se o idioma especificado nele for o mesmo que o da voz.   
Tipo: matriz de strings  
Membros da matriz: número máximo de 5 itens.  
Padrão: `[0-9A-Za-z]{1,20}`   
Obrigatório: não

 ** OutputFormat **   <a name="polly-Type-SynthesisTask-OutputFormat"></a>
O formato no qual a saída retornada será codificada. Para transmissão de áudio, serão mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law ou pcm. Marcas de fala serão JSON.   
Tipo: string  
Valores válidos: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Obrigatório: não

 ** OutputUri **   <a name="polly-Type-SynthesisTask-OutputUri"></a>
Caminho para o arquivo de fala de saída.  
Tipo: string  
Obrigatório: não

 ** RequestCharacters **   <a name="polly-Type-SynthesisTask-RequestCharacters"></a>
Número de caracteres faturáveis sintetizados.  
Tipo: inteiro  
Obrigatório: não

 ** SampleRate **   <a name="polly-Type-SynthesisTask-SampleRate"></a>
A frequência de áudio especificada em Hz.  
Os valores válidos para MP3 e ogg\$1vorbis são 8000, 16000, 22050 e 24000. O valor padrão para vozes padrão é 22050. O valor padrão para vozes neurais é 24000. O valor padrão para vozes em formato longo é “24.000”. O valor padrão para vozes generativas é “24000”.  
Os valores válidos para pcm são 8000 e 16000. O valor padrão é 16000.   
O valor válido para ogg\$1opus é “48000".   
O valor válido para mu-law e a-law é “8000".   
Tipo: string  
Obrigatório: não

 ** SnsTopicArn **   <a name="polly-Type-SynthesisTask-SnsTopicArn"></a>
O ARN do tópico do SNS é usado opcionalmente para fornecer notificação de status para uma tarefa de síntese de fala.  
Tipo: sequência  
Padrão: `^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)$`   
Obrigatório: não

 ** SpeechMarkTypes **   <a name="polly-Type-SynthesisTask-SpeechMarkTypes"></a>
Tipo de marcas de fala retornadas para o texto de entrada.  
Tipo: matriz de strings  
Membros da matriz: número máximo de 4 itens.  
Valores válidos: `sentence | ssml | viseme | word`   
Obrigatório: não

 ** TaskId **   <a name="polly-Type-SynthesisTask-TaskId"></a>
O identificador gerado pelo Amazon Polly para a tarefa de síntese de fala.  
Tipo: sequência  
Padrão: `^[a-zA-Z0-9_-]{1,100}$`   
Obrigatório: não

 ** TaskStatus **   <a name="polly-Type-SynthesisTask-TaskStatus"></a>
Status atual da tarefa de síntese de fala individual.  
Tipo: string  
Valores válidos: `scheduled | inProgress | completed | failed`   
Obrigatório: não

 ** TaskStatusReason **   <a name="polly-Type-SynthesisTask-TaskStatusReason"></a>
Motivo do status atual de uma tarefa de síntese de fala específica, incluindo erros se a tarefa falhar.  
Tipo: string  
Obrigatório: não

 ** TextType **   <a name="polly-Type-SynthesisTask-TextType"></a>
Especifica se o texto de entrada é simples ou SSML. O valor padrão é texto sem formatação.   
Tipo: string  
Valores válidos: `ssml | text`   
Obrigatório: não

 ** VoiceId **   <a name="polly-Type-SynthesisTask-VoiceId"></a>
ID de voz a ser usado para a síntese.   
Tipo: string  
Valores válidos: `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`   
Obrigatório: não

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesisTask) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesisTask) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesisTask) 

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

Contém conteúdo de texto para ser sintetizado em fala.

## Conteúdo
<a name="API_TextEvent_Contents"></a>

 ** Text **   <a name="polly-Type-TextEvent-Text"></a>
O conteúdo do texto a ser sintetizado. Se você especificar `ssml` como `TextType`, siga o formato SSML para o texto de entrada.  
Tipo: String  
Obrigatório: Sim

 ** FlushStreamConfiguration **   <a name="polly-Type-TextEvent-FlushStreamConfiguration"></a>
Configuração para controlar quando o áudio sintetizado é liberado para o fluxo de saída.  
Tipo: objeto [FlushStreamConfiguration](API_FlushStreamConfiguration.md)  
Obrigatório: não

 ** TextType **   <a name="polly-Type-TextEvent-TextType"></a>
Especifica se o texto de entrada é simples ou SSML. Padrão: texto sem formatação.  
Tipo: string  
Valores válidos: `ssml | text`   
Obrigatório: não

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/TextEvent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/TextEvent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/TextEvent) 

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

Fornece informações sobre um motivo específico de limitação.

## Conteúdo
<a name="API_ThrottlingReason_Contents"></a>

 ** reason **   <a name="polly-Type-ThrottlingReason-reason"></a>
O código do motivo que explica por que a solicitação foi limitada.  
Tipo: string  
Obrigatório: não

 ** resource **   <a name="polly-Type-ThrottlingReason-resource"></a>
O recurso que causou a limitação.  
Tipo: string  
Obrigatório: não

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ThrottlingReason) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ThrottlingReason) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ThrottlingReason) 

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

Informações sobre um campo que falhou na validação.

## Conteúdo
<a name="API_ValidationExceptionField_Contents"></a>

 ** message **   <a name="polly-Type-ValidationExceptionField-message"></a>
Uma mensagem descrevendo por que o campo falhou na validação.  
Tipo: String  
Obrigatório: Sim

 ** name **   <a name="polly-Type-ValidationExceptionField-name"></a>
O nome do campo que falhou na validação.  
Tipo: String  
Obrigatório: Sim

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ValidationExceptionField) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ValidationExceptionField) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ValidationExceptionField) 

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

Descrição da voz.

## Conteúdo
<a name="API_Voice_Contents"></a>

 ** AdditionalLanguageCodes **   <a name="polly-Type-Voice-AdditionalLanguageCodes"></a>
Códigos adicionais para idiomas disponíveis para a voz especificada, além do idioma padrão.   
Por exemplo, o idioma padrão para Aditi é o inglês indiano (en-IN) porque ele foi usado pela primeira vez para esse idioma. Como Aditi é bilíngue e fluente em inglês indiano e hindi, esse parâmetro mostraria o código `hi-IN`.  
Tipo: matriz de strings  
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`   
Obrigatório: não

 ** Gender **   <a name="polly-Type-Voice-Gender"></a>
Gênero da voz.  
Tipo: sequências  
Valores válidos: `Female | Male`   
Obrigatório: não

 ** Id **   <a name="polly-Type-Voice-Id"></a>
ID de voz atribuída ao Amazon Polly. Esse é o ID que você especifica ao chamar a operação `SynthesizeSpeech`.  
Tipo: sequência  
Valores válidos: `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`   
Obrigatório: não

 ** LanguageCode **   <a name="polly-Type-Voice-LanguageCode"></a>
Código de idioma da voz.  
Tipo: sequência  
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`   
Obrigatório: não

 ** LanguageName **   <a name="polly-Type-Voice-LanguageName"></a>
O nome legível do idioma em inglês.  
Tipo: sequência  
Obrigatório: não

 ** Name **   <a name="polly-Type-Voice-Name"></a>
Nome da voz (por exemplo, Salli, Kendra, etc.). Isso fornece um nome de voz legível por humanos que você pode exibir no aplicativo.  
Tipo: sequência  
Obrigatório: não

 ** SupportedEngines **   <a name="polly-Type-Voice-SupportedEngines"></a>
Especifica quais mecanismos (`standard`, `neural`, `long-form` ou `generative`) são compatíveis com determinada voz.  
Tipo: matriz de strings  
Valores válidos: `standard | neural | long-form | generative`   
Obrigatório: não

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Voice) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Voice) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Voice) 

# Erros comuns
<a name="CommonErrors"></a>

Esta seção lista os erros comuns às ações de API de todos os serviços da AWS. Para saber os erros específicos de uma ação de API para esse serviço, consulte o tópico sobre a ação de API em questão.

 **AccessDeniedException**   
Você não tem acesso suficiente para executar essa ação.  
Código de Status HTTP: 400

 **IncompleteSignature**   
A assinatura da solicitação não segue os padrões da AWS.  
Código de Status HTTP: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
O processamento da solicitação falhou por causa de um erro, uma exceção ou uma falha desconhecida.  
Código de Status HTTP: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
A ação ou operação solicitada é inválida. Verifique se a ação foi digitada corretamente.  
Código de Status HTTP: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
O certificado X.509 ou o ID de chave de acesso da AWS fornecido não existe em nossos registros.  
Código de status HTTP: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
Você não tem permissão para realizar esta ação.  
Código de Status HTTP: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
O ID da chave de acesso da AWS precisa de uma assinatura do serviço.  
Código de status HTTP: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
A solicitação atingiu o serviço mais de 15 minutos após a data na solicitação ou mais de 15 minutos após a data de expiração da solicitação (como para URLs predeterminados), ou a data na solicitação está a mais de 15 minutos no futuro.  
Código de Status HTTP: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
Falha na solicitação devido a um erro temporário do servidor.  
Código de status HTTP: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
A solicitação foi negada devido à limitação da solicitação.  
Código de Status HTTP: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
A entrada não atende às restrições especificadas por um serviço da AWS.  
Código de Status HTTP: 400

# Parâmetros gerais
<a name="CommonParameters"></a>

A lista a seguir contém os parâmetros que todas as ações usam para assinar solicitações do Signature versão 4 com uma string de consulta. Todos os parâmetros específicos de uma ação são listados no tópico para a ação. Para obter mais informações sobre o Signature versão 4, consulte [Solicitações de AWS API de assinatura](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) no *Guia do usuário do IAM*.

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
O algoritmo de hash que foi usado para criar a assinatura da solicitação.  
Condição: especifique esse parâmetro quando incluir as informações de autenticação em uma string de consulta em vez de no cabeçalho da autorização HTTP.  
Tipo: string  
Valores válidos: `AWS4-HMAC-SHA256`   
Obrigatório: condicional

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
O valor de escopo da credencial, uma string que inclui a sua chave de acesso, a data, a região visada, o serviço que está sendo solicitado e uma sequência de encerramento ("aws4\$1request"). O valor é expresso no seguinte formato: *chave\$1acesso*/*AAAAMMDD*/*região*/*serviço*/aws4\$1request.  
Para obter mais informações, consulte [Criar uma solicitação de AWS API assinada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) no *Guia do usuário do IAM*.  
Condição: especifique esse parâmetro quando incluir as informações de autenticação em uma string de consulta em vez de no cabeçalho da autorização HTTP.  
Tipo: string  
Obrigatório: Condicional

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
A data usada para criar a assinatura. O formato deve ser o formato básico ISO 8601 (AAAAMMDD'T'HHMMSS'Z'). Por exemplo, a data e hora a seguir é um X-Amz-Date valor válido:`20120325T120000Z`.  
Condição: X-Amz-Date é opcional para todas as solicitações; ele pode ser usado para substituir a data usada em solicitações de assinatura. Se o cabeçalho da data for especificado no formato básico ISO 8601, não X-Amz-Date é necessário. Quando X-Amz-Date usado, ele sempre substitui o valor do cabeçalho da data. Para obter mais informações, consulte [Elementos de uma assinatura de solicitação de AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) no *Guia do usuário do IAM*.  
Tipo: string  
Obrigatório: Condicional

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
O token de segurança temporário obtido por meio de uma chamada para AWS Security Token Service (AWS STS). Para obter uma lista de serviços que oferecem suporte a credenciais de segurança temporárias do AWS STS, consulte [Serviços da AWS que funcionam com o IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) no *Guia do usuário do IAM*.  
Condição: se você estiver usando credenciais de segurança temporárias do AWS STS, deverá incluir o token de segurança.  
Tipo: string  
Obrigatório: Condicional

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Especifica a assinatura com codificação hexadecimal que foi calculada com base na string a ser assinada e na chave de assinatura derivada.  
Condição: especifique esse parâmetro quando incluir as informações de autenticação em uma string de consulta em vez de no cabeçalho da autorização HTTP.  
Tipo: string  
Obrigatório: Condicional

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Especifica todos os cabeçalhos HTTP que foram incluídos como parte da solicitação canônica. Para obter mais informações sobre a especificação de cabeçalhos assinados, consulte [Criar uma solicitação de AWS API assinada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) no Guia do *usuário do IAM*.  
Condição: especifique esse parâmetro quando incluir as informações de autenticação em uma string de consulta em vez de no cabeçalho da autorização HTTP.  
Tipo: string  
Obrigatório: Condicional