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](https://docs.aws.amazon.com/polly/latest/dg/how-text-to-speech-works.html). ## 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](#API_SynthesizeSpeech_RequestSyntax) ** 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) ** 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) ** 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) ** O formato no qual a saída retornada será codificada. Para transmissão de áudio, serão mp3, ogg\_vorbis, ogg\_opus, 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 | mulaw | alaw` Obrigatório: Sim ** [SampleRate](#API_SynthesizeSpeech_RequestSyntax) ** A frequência de áudio especificada em Hz. Os valores válidos para MP3 e ogg\_vorbis 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\_opus é “48000". O valor válido para mu-law e a-law é “8000". Tipo: string Obrigatório: não ** [SpeechMarkTypes](#API_SynthesizeSpeech_RequestSyntax) ** 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) ** 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) ** 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) ** 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 ``` 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](#API_SynthesizeSpeech_ResponseSyntax) ** 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) ** Número de caracteres sintetizados. A resposta retorna as informações a seguir como corpo HTTP. ** [AudioStream](#API_SynthesizeSpeech_ResponseSyntax) ** 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 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 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\+\+](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)