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
<a name="API_StartSpeechSynthesisStream"></a>

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`
+  [SynthesizeSpeech](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html) 

## Sintassi della richiesta
<a name="API_StartSpeechSynthesisStream_RequestSyntax"></a>

```
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
<a name="API_StartSpeechSynthesisStream_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [Engine](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-Engine"></a>
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](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LanguageCode"></a>
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](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LexiconNames"></a>
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](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-OutputFormat"></a>
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 | mulaw | alaw`   
Obbligatorio: sì

 ** [SampleRate](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-SampleRate"></a>
La frequenza audio, specificata in Hz.

 ** [VoiceId](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-VoiceId"></a>
La voce da usare in sintesi. Per ottenere un elenco delle voci disponibili IDs, usa l'[DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operazione.  
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
<a name="API_StartSpeechSynthesisStream_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [CloseStreamEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-CloseStreamEvent"></a>
Un evento che indica la fine del flusso di input.  
Tipo: oggetto [CloseStreamEvent](API_CloseStreamEvent.md)  
Obbligatorio: no

 ** [TextEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-TextEvent"></a>
Un evento di testo contenente contenuti da sintetizzare.  
Tipo: oggetto [TextEvent](API_TextEvent.md)  
Obbligatorio: no

## Sintassi della risposta
<a name="API_StartSpeechSynthesisStream_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AudioEvent": { 
      "AudioChunk": blob
   },
   "ServiceFailureException": { 
   },
   "ServiceQuotaExceededException": { 
   },
   "StreamClosedEvent": { 
      "RequestCharacters": number
   },
   "ThrottlingException": { 
   },
   "ValidationException": { 
   }
}
```

## Elementi di risposta
<a name="API_StartSpeechSynthesisStream_ResponseElements"></a>

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

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

 ** [AudioEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-AudioEvent"></a>
Un evento audio contenente un discorso sintetizzato.  
Tipo: oggetto [AudioEvent](API_AudioEvent.md)

 ** [ServiceFailureException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceFailureException"></a>
Una condizione sconosciuta ha causato un errore di servizio.  
Tipo: eccezione  
Codice di stato HTTP: 500

 ** [ServiceQuotaExceededException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceQuotaExceededException"></a>
Un'eccezione che indica il superamento di una quota di servizio.  
Tipo: eccezione  
Codice di stato HTTP: 402

 ** [StreamClosedEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-StreamClosedEvent"></a>
Un evento, con informazioni di riepilogo, che indica che lo stream è stato chiuso.  
Tipo: oggetto [StreamClosedEvent](API_StreamClosedEvent.md)

 ** [ThrottlingException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ThrottlingException"></a>
Un'eccezione che indica che la richiesta è stata limitata.  
Tipo: eccezione  
Codice di stato HTTP: 400

 ** [ValidationException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ValidationException"></a>
Un'eccezione che indica che la convalida dell'input non è riuscita.  
Tipo: eccezione  
Codice di stato HTTP: 400

## Errori
<a name="API_StartSpeechSynthesisStream_Errors"></a>

 ** 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
<a name="API_StartSpeechSynthesisStream_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStream)