StartSpeechSynthesisStream - Amazon Polly

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

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 | pcm

Obrigató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 | Tiffany

Obrigató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: