StartSpeechSynthesisStream - Amazon Polly

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.

StartSpeechSynthesisStream

Sintetiza entradas UTF-8, texto sin formato o SSML a través de una conexión de streaming bidireccional. Especifique los parámetros de síntesis en los encabezados HTTP/2, envíe texto de forma incremental como eventos en el flujo de entrada y reciba audio sintetizado a medida que esté disponible.

Esta operación sirve como contraparte bidireccional de: SynthesizeSpeech

Sintaxis de la solicitud

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 de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

Engine

Especifica el motor que utilizará Amazon Polly al procesar el texto de entrada para la síntesis de voz. Actualmente, solo se admite el generative motor. Si especificas una voz que el motor seleccionado no admite, Amazon Polly devolverá un error.

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

Obligatorio: sí

LanguageCode

Parámetro opcional que establece el código de idioma de la solicitud de síntesis de voz. Especifique este parámetro solo cuando utilice una voz bilingüe. 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.

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

Los nombres de uno o más léxicos de pronunciación para que el servicio los aplique durante la síntesis. Amazon Polly aplica los léxicos solo cuando el idioma del léxico coincide con el idioma de la voz.

Miembros de la matriz: número máximo de 5 elementos.

Patrón: [0-9A-Za-z]{1,20}

OutputFormat

El formato de audio de la voz sintetizada. Actualmente, Amazon Polly no admite las marcas de voz JSON.

Valores válidos: json | mp3 | ogg_opus | ogg_vorbis | pcm

Obligatorio: sí

SampleRate

La frecuencia de audio, especificada en Hz.

VoiceId

La voz que se utilizará en la síntesis. Para obtener una lista de las voces disponibles IDs, utilice la DescribeVoicesoperación.

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í

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

CloseStreamEvent

Un evento que indica el final del flujo de entrada.

Tipo: objeto CloseStreamEvent

Obligatorio: no

TextEvent

Un evento de texto que contiene contenido que se va a sintetizar.

Tipo: objeto TextEvent

Obligatorio: no

Sintaxis de la respuesta

HTTP/1.1 200 Content-type: application/json { "AudioEvent": { "AudioChunk": blob }, "ServiceFailureException": { }, "ServiceQuotaExceededException": { }, "StreamClosedEvent": { "RequestCharacters": number }, "ThrottlingException": { }, "ValidationException": { } }

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.

AudioEvent

Evento de audio que contiene voz sintetizada.

Tipo: objeto AudioEvent

ServiceFailureException

Una condición desconocida ha provocado un fallo en el servicio.

Tipo: Excepción

Código de estado HTTP: 500

ServiceQuotaExceededException

Una excepción que indica que se superaría una cuota de servicio.

Tipo: excepción

Código de estado HTTP: 402

StreamClosedEvent

Un evento, con información resumida, que indica que la transmisión se ha cerrado.

Tipo: objeto StreamClosedEvent

ThrottlingException

Una excepción que indica que la solicitud se ha limitado.

Tipo: excepción

Código de estado HTTP: 400

ValidationException

Una excepción que indica que la entrada no se validó correctamente.

Tipo: excepción

Código de estado HTTP: 400

Errores

ServiceFailureException

Una condición desconocida ha provocado un fallo en el servicio.

Código de estado HTTP: 500

ServiceQuotaExceededException

La solicitud provocaría que se superara una cuota de servicio.

quotaCode

El código de cuota que identifica la cuota específica.

serviceCode

El código de servicio que identifica el servicio de origen.

Código de estado HTTP: 402

ThrottlingException

La solicitud se denegó debido a la limitación de las solicitudes.

throttlingReasons

Una lista de los motivos que explican por qué se ha limitado la solicitud.

Código de estado HTTP: 400

ValidationException

La entrada no satisface las limitaciones que especifica el servicio de .

fields

Los campos que provocaron el error de validación.

reason

El motivo por el que la solicitud no se validó.

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, consulta lo siguiente: