Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # StartSpeechSynthesisTask Permite crear una tarea de síntesis asíncrona, iniciando una nueva `SpeechSynthesisTask`. Esta operación requiere toda la información estándar necesaria para la síntesis de voz, además del nombre de un bucket de Amazon S3 para que el servicio almacene el resultado de la tarea de síntesis y dos parámetros opcionales (`OutputS3KeyPrefix` y `SnsTopicArn`). Una vez creada la tarea de síntesis, esta operación devolverá un objeto `SpeechSynthesisTask`, que incluirá un identificador de la tarea y su estado actual. El objeto `SpeechSynthesisTask` estará disponible durante 72 horas después de iniciar la tarea de síntesis asíncrona. ## Sintaxis de la solicitud ``` 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 de solicitud del URI La solicitud no utiliza ningún parámetro de URI. ## Cuerpo de la solicitud La solicitud acepta los siguientes datos en formato JSON. ** [Engine](#API_StartSpeechSynthesisTask_RequestSyntax) ** Especifica el motor (`standard`, `neural`, `long-form` o `generative`) que utilizará Amazon Polly al procesar el texto de entrada para la síntesis de voz. El uso de una voz que no sea compatible con el motor seleccionado provocará un error. Tipo: cadena Valores válidos: `standard | neural | long-form | generative` Obligatorio: no ** [LanguageCode](#API_StartSpeechSynthesisTask_RequestSyntax) ** Código de idioma opcional para la solicitud de síntesis de voz. Esto solo es necesario si se utiliza una voz bilingüe, como Aditi, que se puede utilizar tanto en inglés indio (en-IN) como en hindi (hi-IN). Si se utiliza una voz bilingüe y no se especifica ningún código de idioma, Amazon Polly utilizará el idioma predeterminado de la voz bilingüe. El idioma predeterminado de cualquier voz es el que devuelve la [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operación para el `LanguageCode` parámetro. Por ejemplo, si no se especifica ningún código de idioma, Aditi utilizará el inglés indio en lugar del hindi. Tipo: cadena 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` Obligatorio: no ** [LexiconNames](#API_StartSpeechSynthesisTask_RequestSyntax) ** Enumere uno o más nombres de lexicones de pronunciación que desee que el servicio aplique durante la síntesis. Los lexicones solamente se aplican al texto si el idioma especificado en ellos es el mismo que el idioma elegido. Tipo: matriz de cadenas Miembros de la matriz: número máximo de 5 elementos. Patrón: `[0-9A-Za-z]{1,20}` Obligatorio: no ** [OutputFormat](#API_StartSpeechSynthesisTask_RequestSyntax) ** Formato en el que se codificará la salida devuelta. Para la transmisión de audio, será mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law o pcm. Para las marcas de voz, será json. Tipo: cadena Valores válidos: `json | mp3 | ogg_opus | ogg_vorbis | pcm` Obligatorio: sí ** [OutputS3BucketName](#API_StartSpeechSynthesisTask_RequestSyntax) ** Nombre del bucket de Amazon S3 en el que se guardará el archivo de salida. Tipo: cadena Patrón: `^[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]$` Obligatorio: sí ** [OutputS3KeyPrefix](#API_StartSpeechSynthesisTask_RequestSyntax) ** El prefijo de clave de Amazon S3 para el archivo de voz de salida. Tipo: cadena Patrón: `^[0-9a-zA-Z\/\!\-_\.\*\'\(\):;\$@=+\,\?&]{0,800}$` Obligatorio: no ** [SampleRate](#API_StartSpeechSynthesisTask_RequestSyntax) ** La frecuencia de audio especificada en Hz. Los valores válidos para mp3 y ogg\$1vorbis son “8000”, “16 000”, “22 050” y “24 000”. El valor predeterminado para las voces estándar es “22 050". El valor predeterminado para las voces neuronales es "24 000". El valor predeterminado para las voces de formato largo es “24 000”. El valor predeterminado para las voces generativas es "24 000". Los valores válidos para el pcm son "8000" y "16 000". El valor por defecto es "16 000". El valor válido para ogg\$1opus es «48000". El valor válido para mu-law y a-law es «8000". Tipo: cadena Requerido: no ** [SnsTopicArn](#API_StartSpeechSynthesisTask_RequestSyntax) ** El ARN para el tema de SNS se usa opcionalmente para proporcionar una notificación de estado para una tarea de síntesis de voz. Tipo: cadena Patrón: `^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)$` Obligatorio: no ** [SpeechMarkTypes](#API_StartSpeechSynthesisTask_RequestSyntax) ** El tipo de marcas de voz devueltas para el texto de entrada. Tipo: matriz de cadenas Miembros de la matriz: número máximo de 4 elementos. Valores válidos: `sentence | ssml | viseme | word` Obligatorio: no ** [Text](#API_StartSpeechSynthesisTask_RequestSyntax) ** El texto de entrada que se va a sintetizar. Si especifica ssml como TextType, siga el formato SSML para el texto de entrada. Tipo: cadena Obligatorio: sí ** [TextType](#API_StartSpeechSynthesisTask_RequestSyntax) ** Especifica si el texto de entrada es texto sin formato o SSML. El valor predeterminado es texto sin formato. Tipo: cadena Valores válidos: `ssml | text` Obligatorio: no ** [VoiceId](#API_StartSpeechSynthesisTask_RequestSyntax) ** ID de voz que se usará para la síntesis. Tipo: cadena 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` Obligatorio: sí ## Sintaxis de la respuesta ``` 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 respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200. El servicio devuelve los datos siguientes en formato JSON. ** [SynthesisTask](#API_StartSpeechSynthesisTask_ResponseSyntax) ** SynthesisTask objeto que proporciona información y atributos sobre una tarea de síntesis de voz recién enviada. Tipo: objeto [SynthesisTask](API_SynthesisTask.md) ## Errores ** EngineNotSupportedException ** Este motor no es compatible con la voz que ha designado. Elija una voz nueva que sea compatible con el motor o cámbielo y reinicie la operación. Código de estado HTTP: 400 ** InvalidS3BucketException ** El nombre de bucket de Amazon S3 proporcionado no es válido. Compruebe lo que ha introducido con los requisitos de denominación del bucket de S3 e inténtelo de nuevo. Código de estado HTTP: 400 ** InvalidS3KeyException ** El prefijo de clave de Amazon S3 no es válido. Proporcione un nombre de clave de objeto de S3 válido. Código de estado HTTP: 400 ** InvalidSampleRateException ** La frecuencia de muestreo especificada no es válida. Código de estado HTTP: 400 ** InvalidSnsTopicArnException ** El ARN del tema de SNS proporcionado no es válido. Introduzca un ARN de tema de SNS válido e inténtelo de nuevo. Código de estado HTTP: 400 ** InvalidSsmlException ** El SSML que ha proporcionado no es válido. Compruebe la sintaxis de SSML y la ortografía de las etiquetas y los valores y, a continuación, vuelva a intentarlo. Código de estado HTTP: 400 ** LanguageNotSupportedException ** Actualmente, el idioma especificado en esta capacidad no es compatible con Amazon Polly. Código de estado HTTP: 400 ** LexiconNotFoundException ** Amazon Polly no encuentra el lexicón especificado. Esto puede deberse a la falta de un lexicón, a que su nombre esté mal escrito o a que se especifique un lexicón que se encuentra en una región diferente. Compruebe que el lexicón existe, se encuentra en la región (consulte [ListLexicons](API_ListLexicons.md)) y que ha escrito su nombre correctamente. Inténtelo de nuevo. Código de estado HTTP: 404 ** MarksNotSupportedForFormatException ** Las marcas de voz no son compatibles con el `OutputFormat` seleccionado. Las marcas de voz solo están disponibles para el contenido en formato `json`. Código de estado HTTP: 400 ** ServiceFailureException ** Una condición desconocida ha provocado un fallo en el servicio. Código de estado HTTP: 500 ** SsmlMarksNotSupportedForTextTypeException ** Las marcas de voz SSML no son compatibles con la entrada de texto simple. Código de estado HTTP: 400 ** TextLengthExceededException ** El valor del parámetro "Text" supera los límites aceptados. Para la API `SynthesizeSpeech`, el límite de entrada de texto es de un máximo de 6000 caracteres en total, de los cuales no se pueden facturar más de 3000 caracteres. Para la API `StartSpeechSynthesisTask`, el máximo es de 200 000 caracteres, de los cuales no se pueden facturar más de 100 000 caracteres. Las etiquetas SSML no cuentan como caracteres contabilizados. Código de estado HTTP: 400 ## Véase también Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: + [AWS Interfaz de línea de comandos 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)