SynthesizeSpeech - Amazon Polly
Sintaxe da SolicitaçãoParâmetros da solicitação de URICorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte também

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

SynthesizeSpeech

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.

Sintaxe da Solicitação

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 solicitação não usa nenhum parâmetro de URI.

Corpo da Solicitação

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

Engine

Especifica o mecanismo (standard, neural ou long-form) que o Amazon Polly usará ao processar texto de entrada para a síntese de fala. Para obter informações sobre as vozes do Amazon Polly e quais estão disponíveis para cada mecanismo, consulte Vozes disponíveis.

Vozes somente de NTTS

Ao usar vozes somente de NTTS, como Kevin (en-US), esse parâmetro é obrigatório e deve ser definido como neural. Se o mecanismo não for especificado ou estiver configurado como standard, resultará em erro.

long-form-only vozes

Ao usar long-form-only vozes como Danielle (en-US), esse parâmetro é obrigatório e deve ser definido como. long-form Se o mecanismo não for especificado ou estiver configurado como standard ou neural, isso resultará em erro.

Tipo: string

Valores válidos: standard | neural | long-form

Obrigatório: Sim

Vozes padrão

Para vozes padrão, isso não é necessário. O parâmetro do mecanismo é standard. Se o mecanismo não for especificado ou estiver configurado como standard e uma voz somente NTTS for selecionada, isso resultará em erro.

Tipo: String

Valores Válidos: standard | neural | long-form

Obrigatório: não

LanguageCode

Código de idioma opcional para a solicitação Sintetizar 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 DescribeVoicesoperação do LanguageCode parâmetro. Por exemplo, se nenhum código de idioma for especificado, o 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

Obrigatório: não

LexiconNames

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 dele for o mesmo que o da voz. Para obter informações sobre como armazenar léxicos, consulte. PutLexicon

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

O formato no qual a saída retornada será codificada. Para transmissão de áudio, será mp3, ogg_vorbis ou pcm. Para marcas de fala, será JSON.

Quando o pcm for usado, o conteúdo retornado é áudio/pcm em formato little-endian assinado de 16 bits e 1 canal (mono).

Tipo: String

Valores Válidos: json | mp3 | ogg_vorbis | pcm

Obrigatório: Sim

SampleRate

Frequência de áudio especificada em Hz.

Os valores válidos para mp3 e ogg_vorbis são 8000, 16000, 22050 e 24000. O 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”.

Os valores válidos para pcm são 8000 e 16000. O valor padrão é 16000.

Tipo: sequência

Obrigatório: não

SpeechMarkTypes

Tipo de marcas de fala retornadas para o texto de entrada.

Tipo: matriz de strings

Membros da matriz: número máximo de seis itens.

Valores Válidos: sentence | ssml | viseme | word

Obrigatório: não

Text

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

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.

Tipo: String

Valores Válidos: ssml | text

Obrigatório: não

VoiceId

Voice ID a ser usado para a síntese. Você pode obter uma lista de IDs de voz disponíveis chamando a DescribeVoicesoperaçã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

Exigido: Sim

Sintaxe da Resposta

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

AudioStream

Elementos de Resposta

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

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 pcm como o OutputFormat, o ContentType retornado será áudio/pcm em um formato little-endian assinado de 16 bits, 1 canal (mono).

  • Se você solicitar json como oOutputFormat, o ContentType retornado é application/x-json-stream.

RequestCharacters

Número de caracteres sintetizados.

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

AudioStream

Fluxo contendo a fala sintetizada.

Erros

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 que você forneceu é inválido. Verifique a sintaxe do SSML, a ortografia das tags e valores e 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) 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 só estão disponíveis 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 simples.

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

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: