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
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
Sintaxe da Solicitação
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 solicitação usa os seguintes parâmetros de URI:
- Engine
-
Especifica o mecanismo que o Amazon Polly deve usar ao processar texto de entrada para síntese de fala. Atualmente, somente o
generativemotor é 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 | generativeObrigatório: Sim
- LanguageCode
-
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
-
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
-
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 | pcmObrigatório: Sim
- SampleRate
-
A frequência de áudio, especificada em Hz.
- VoiceId
-
A voz a ser usada em síntese. Para obter uma lista das vozes disponíveis IDs, use a DescribeVoicesoperaçã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 | TiffanyObrigatório: Sim
Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
- CloseStreamEvent
-
Um evento que indica o fim do fluxo de entrada.
Tipo: objeto CloseStreamEvent
Obrigatório: não
- TextEvent
-
Um evento de texto contendo conteúdo a ser sintetizado.
Tipo: objeto TextEvent
Obrigatório: não
Sintaxe da resposta
HTTP/1.1 200
Content-type: application/json
{
"AudioEvent": {
"AudioChunk": blob
},
"ServiceFailureException": {
},
"ServiceQuotaExceededException": {
},
"StreamClosedEvent": {
"RequestCharacters": number
},
"ThrottlingException": {
},
"ValidationException": {
}
}
Elementos de resposta
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
-
Um evento de áudio contendo fala sintetizada.
Tipo: objeto AudioEvent
- ServiceFailureException
-
Uma condição desconhecida causou uma falha no serviço.
Tipo: Exceção
Código de status HTTP: 500
- ServiceQuotaExceededException
-
Uma exceção indicando que uma cota de serviço seria excedida.
Tipo: Exceção
Código de status HTTP: 402
- StreamClosedEvent
-
Um evento, com informações resumidas, indicando que o stream foi encerrado.
Tipo: objeto StreamClosedEvent
- ThrottlingException
-
Uma exceção indicando que a solicitação foi limitada.
Tipo: Exceção
Código de status HTTP: 400
- ValidationException
-
Uma exceção indicando falha na validação da entrada.
Tipo: Exceção
Código de status HTTP: 400
Erros
- 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
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: