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
generativemotor. Si especificas una voz que el motor seleccionado no admite, Amazon Polly devolverá un error.Valores válidos:
standard | neural | long-form | generativeObligatorio: 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 | pcmObligatorio: 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 | TiffanyObligatorio: 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: