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

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