StartSpeechSynthesisStream - Amazon Polly

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

StartSpeechSynthesisStream

Sintetizza input UTF-8, testo semplice o SSML su una connessione di streaming bidirezionale. Specificate i parametri di sintesi nelle intestazioni HTTP/2, inviate il testo in modo incrementale come eventi sul flusso di input e ricevete l'audio sintetizzato non appena disponibile.

Questa operazione funge da controparte bidirezionale per: SynthesizeSpeech

Sintassi della richiesta

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" } }

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

Engine

Speciifica il motore di Amazon Polly da utilizzare per l'elaborazione del testo di input per la sintesi vocale. Attualmente è supportato solo il generative motore. Se specifichi una voce che il motore selezionato non supporta, Amazon Polly restituisce un errore.

Valori validi: standard | neural | long-form | generative

Obbligatorio: sì

LanguageCode

Un parametro opzionale che imposta il codice della lingua per la richiesta di sintesi vocale. Specificate questo parametro solo quando utilizzate una voce bilingue. Se viene utilizzata una voce bilingue e non viene specificato alcun codice lingua, Amazon Polly utilizza la lingua predefinita della voce bilingue.

Valori validi: 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

I nomi di uno o più lessici di pronuncia del servizio da applicare durante la sintesi. Amazon Polly applica i lessici solo quando la lingua del lessico corrisponde alla lingua vocale.

Membri della matrice: numero massimo di 5 elementi.

Modello: [0-9A-Za-z]{1,20}

OutputFormat

Il formato audio per il parlato sintetizzato. Attualmente, Amazon Polly non supporta i segni vocali JSON.

Valori validi: json | mp3 | ogg_opus | ogg_vorbis | pcm

Obbligatorio: sì

SampleRate

La frequenza audio, specificata in Hz.

VoiceId

La voce da usare in sintesi. Per ottenere un elenco delle voci disponibili IDs, usa l'DescribeVoicesoperazione.

Valori validi: 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

Obbligatorio: sì

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

CloseStreamEvent

Un evento che indica la fine del flusso di input.

Tipo: oggetto CloseStreamEvent

Obbligatorio: no

TextEvent

Un evento di testo contenente contenuti da sintetizzare.

Tipo: oggetto TextEvent

Obbligatorio: no

Sintassi della risposta

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

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

AudioEvent

Un evento audio contenente un discorso sintetizzato.

Tipo: oggetto AudioEvent

ServiceFailureException

Una condizione sconosciuta ha causato un errore di servizio.

Tipo: eccezione

Codice di stato HTTP: 500

ServiceQuotaExceededException

Un'eccezione che indica il superamento di una quota di servizio.

Tipo: eccezione

Codice di stato HTTP: 402

StreamClosedEvent

Un evento, con informazioni di riepilogo, che indica che lo stream è stato chiuso.

Tipo: oggetto StreamClosedEvent

ThrottlingException

Un'eccezione che indica che la richiesta è stata limitata.

Tipo: eccezione

Codice di stato HTTP: 400

ValidationException

Un'eccezione che indica che la convalida dell'input non è riuscita.

Tipo: eccezione

Codice di stato HTTP: 400

Errori

ServiceFailureException

Una condizione sconosciuta ha causato un errore di servizio.

Codice di stato HTTP: 500

ServiceQuotaExceededException

La richiesta comporterebbe il superamento di una quota di servizio.

quotaCode

Il codice di quota che identifica la quota specifica.

serviceCode

Il codice di servizio che identifica il servizio di origine.

Codice di stato HTTP: 402

ThrottlingException

La richiesta è stata rifiutata a causa della limitazione della richiesta.

throttlingReasons

Un elenco di motivi che spiegano il motivo per cui la richiesta è stata limitata.

Codice di stato HTTP: 400

ValidationException

L'input non soddisfa i vincoli specificati dal servizio.

fields

I campi che hanno causato l'errore di convalida.

reason

Il motivo per cui la richiesta non è riuscita a convalidare.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: