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
generativemotore. Se specifichi una voce che il motore selezionato non supporta, Amazon Polly restituisce un errore.Valori validi:
standard | neural | long-form | generativeObbligatorio: 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 | pcmObbligatorio: 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 | TiffanyObbligatorio: 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: