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á. # StartSpeechSynthesisTask Permite a criação de uma tarefa de síntese assíncrona, iniciando uma nova `SpeechSynthesisTask`. Essa operação requer todas as informações padrão necessárias para a síntese de fala, além do nome de um bucket do Amazon S3 para que o serviço armazene a saída da tarefa de síntese e dois parâmetros opcionais (`OutputS3KeyPrefix` e `SnsTopicArn`). Depois que a tarefa de síntese for criada, a operação retornará um objeto de `SpeechSynthesisTask` que incluirá um identificador a tarefa e o status atual. O objeto `SpeechSynthesisTask` fica disponível por 72 horas após o início da tarefa de síntese assíncrona. ## Sintaxe da Solicitação ``` POST /v1/synthesisTasks HTTP/1.1 Content-type: application/json { "Engine": "string", "LanguageCode": "string", "LexiconNames": [ "string" ], "OutputFormat": "string", "OutputS3BucketName": "string", "OutputS3KeyPrefix": "string", "SampleRate": "string", "SnsTopicArn": "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_StartSpeechSynthesisTask_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. Usar uma voz que não seja compatível com o mecanismo selecionado resultará em erro. Tipo: string Valores válidos: `standard | neural | long-form | generative` Obrigatório: não ** [LanguageCode](#API_StartSpeechSynthesisTask_RequestSyntax) ** Código de idioma opcional para a solicitação de síntese de 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 [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_StartSpeechSynthesisTask_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. 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_StartSpeechSynthesisTask_RequestSyntax) ** O formato no qual a saída retornada será codificada. Para transmissão de áudio, serão mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law ou pcm. Marcas de fala serão JSON. Tipo: string Valores válidos: `json | mp3 | ogg_opus | ogg_vorbis | pcm` Obrigatório: Sim ** [OutputS3BucketName](#API_StartSpeechSynthesisTask_RequestSyntax) ** Nome do bucket do Amazon S3 no qual o arquivo de saída será salvo. Tipo: sequência Padrão: `^[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]$` Obrigatório: Sim ** [OutputS3KeyPrefix](#API_StartSpeechSynthesisTask_RequestSyntax) ** Prefixo das chaves do Amazon S3 para o arquivo de fala de saída. Tipo: sequência Padrão: `^[0-9a-zA-Z\/\!\-_\.\*\'\(\):;\$@=+\,\?&]{0,800}$` Obrigatório: não ** [SampleRate](#API_StartSpeechSynthesisTask_RequestSyntax) ** A frequência de áudio especificada em Hz. Os valores válidos para MP3 e ogg\$1vorbis são 8000, 16000, 22050 e 24000. 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\$1opus é “48000". O valor válido para mu-law e a-law é “8000". Tipo: string Obrigatório: não ** [SnsTopicArn](#API_StartSpeechSynthesisTask_RequestSyntax) ** O ARN do tópico do SNS é usado opcionalmente para fornecer notificação de status para uma tarefa de síntese de fala. Tipo: sequência Padrão: `^arn:aws(-(cn|iso(-b)?|us-gov))?:sns:[a-z0-9_-]{1,50}:\d{12}:[a-zA-Z0-9_-]{1,251}([a-zA-Z0-9_-]{0,5}|\.fifo)$` Obrigatório: não ** [SpeechMarkTypes](#API_StartSpeechSynthesisTask_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_StartSpeechSynthesisTask_RequestSyntax) ** Texto de entrada a ser sintetizado. Se você especificar ssml como TextType, siga o formato SSML para o texto de entrada. Tipo: String Obrigatório: Sim ** [TextType](#API_StartSpeechSynthesisTask_RequestSyntax) ** Especifica se o texto de entrada é simples ou SSML. O valor padrão é texto sem formatação. Tipo: string Valores válidos: `ssml | text` Obrigatório: não ** [VoiceId](#API_StartSpeechSynthesisTask_RequestSyntax) ** ID de voz a ser usado para a síntese. 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: application/json { "SynthesisTask": { "CreationTime": number, "Engine": "string", "LanguageCode": "string", "LexiconNames": [ "string" ], "OutputFormat": "string", "OutputUri": "string", "RequestCharacters": number, "SampleRate": "string", "SnsTopicArn": "string", "SpeechMarkTypes": [ "string" ], "TaskId": "string", "TaskStatus": "string", "TaskStatusReason": "string", "TextType": "string", "VoiceId": "string" } } ``` ## 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. ** [SynthesisTask](#API_StartSpeechSynthesisTask_ResponseSyntax) ** SynthesisTask objeto que fornece informações e atributos sobre uma tarefa de síntese de fala recém-enviada. Tipo: objeto [SynthesisTask](API_SynthesisTask.md) ## 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 ** InvalidS3BucketException ** O nome do bucket do Amazon S3 fornecido é inválido. Verifique a entrada com os requisitos de nomenclatura do bucket do S3 e tente novamente. Código de status HTTP: 400 ** InvalidS3KeyException ** O prefixo das chaves do Amazon S3 fornecido é inválido. Forneça um nome de chave de objeto S3 válido. Código de status HTTP: 400 ** InvalidSampleRateException ** A taxa de amostragem especificada é inválida. Código de status HTTP: 400 ** InvalidSnsTopicArnException ** O ARN do tópico SNS fornecido é inválido. Forneça um ARN de tópico de SNS válido e tente novamente. 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 linguagem específica AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisTask) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisTask)