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à.

# Azioni
<a name="API_Operations"></a>

Sono supportate le operazioni seguenti:
+  [DeleteLexicon](API_DeleteLexicon.md) 
+  [DescribeVoices](API_DescribeVoices.md) 
+  [GetLexicon](API_GetLexicon.md) 
+  [GetSpeechSynthesisTask](API_GetSpeechSynthesisTask.md) 
+  [ListLexicons](API_ListLexicons.md) 
+  [ListSpeechSynthesisTasks](API_ListSpeechSynthesisTasks.md) 
+  [PutLexicon](API_PutLexicon.md) 
+  [StartSpeechSynthesisStream](API_StartSpeechSynthesisStream.md) 
+  [StartSpeechSynthesisTask](API_StartSpeechSynthesisTask.md) 
+  [SynthesizeSpeech](API_SynthesizeSpeech.md) 

# DeleteLexicon
<a name="API_DeleteLexicon"></a>

Elimina il lessico di pronuncia specificato archiviato in una regione Regione AWS. Un lessico eliminato non è disponibile per la sintesi vocale, né è possibile recuperarlo utilizzando o. `GetLexicon` `ListLexicon` APIs

Per ulteriori informazioni, consulta [Managing Lexicons](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html) (Gestione di lessici).

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

```
DELETE /v1/lexicons/LexiconName HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_DeleteLexicon_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [LexiconName](#API_DeleteLexicon_RequestSyntax) **   <a name="polly-DeleteLexicon-request-uri-Name"></a>
Nome del lessico da eliminare. Deve essere un lessico esistente nella regione.  
Modello: `[0-9A-Za-z]{1,20}`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteLexicon_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

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

```
HTTP/1.1 200
```

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

 ** LexiconNotFoundException **   
Amazon Polly non è in grado di individuare il lessico specificato. Ciò potrebbe essere causato da un lessico mancante, il suo nome è errato o specificando un lessico che si trova in una regione diversa.  
Verificare che il lessico esista, sia nella regione (consulta [ListLexicons](API_ListLexicons.md)) e che hai digitato il suo nome sia corretto. Allora try again.  
Codice di stato HTTP: 404

 ** ServiceFailureException **   
Una condizione sconosciuta ha causato un errore di servizio.  
Codice di stato HTTP: 500

## Vedi anche
<a name="API_DeleteLexicon_SeeAlso"></a>

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

# DescribeVoices
<a name="API_DescribeVoices"></a>

Restituisce l'elenco di voci che sono disponibili per l'uso quando si richiede la sintesi vocale. Ogni voce parla una lingua specificata, è maschile o femminile ed è identificata da un ID, che è la versione ASCII del nome della voce. 

Quando si sintetizza il discorso ( `SynthesizeSpeech` ), si fornisce l'ID vocale per la voce desiderata dall'elenco delle voci restituite da `DescribeVoices`.

Ad esempio, si desidera che l'applicazione per il lettore di notizie legga le notizie in una lingua specifica, ma dando a un utente la possibilità di scegliere la voce. Utilizzando l'operazione `DescribeVoices` è possibile fornire all'utente un elenco di voci disponibili tra cui selezionare.

 È anche possibile specificare un codice della lingua per filtrare le voci disponibili. Se ad esempio si specifica `en-US`, l'operazione restituisce un elenco di tutte le voci disponibili per l'inglese Stati Uniti. 

Questa operazione necessita delle autorizzazioni a eseguire l'operazione `polly:DescribeVoices`.

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

```
GET /v1/voices?Engine=Engine&IncludeAdditionalLanguageCodes=IncludeAdditionalLanguageCodes&LanguageCode=LanguageCode&NextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_DescribeVoices_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [Engine](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-Engine"></a>
Speciifica il motore (`standard`,`neural`, `long-form` or`generative`) utilizzato da Amazon Polly durante l'elaborazione del testo di input per la sintesi vocale.   
Valori validi: `standard | neural | long-form | generative` 

 ** [IncludeAdditionalLanguageCodes](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-IncludeAdditionalLanguageCodes"></a>
Valore booleano che indica se restituire voci bilingue che utilizzano la lingua specificata come lingua aggiuntiva. Ad esempio, se richiedi tutte le lingue che usano l'inglese statunitense (es-US) e c'è una voce italiana che parla sia italiano (it-IT) che inglese americano, tale voce verrà inclusa se specifichi `yes` ma non se si specifica `no`.

 ** [LanguageCode](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-LanguageCode"></a>
 Il tag di identificazione della lingua (codice ISO 639 per il nome della lingua-codice paese ISO 3166) per filtrare l'elenco delle voci restituite. Se non specifichi questo parametro facoltativo, vengono restituite tutte le voci disponibili.   
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` 

 ** [NextToken](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-NextToken"></a>
Un token di impaginazione opaco restituito dal precedente operazione `DescribeVoices`. Se presente, indica dove continuare l'inserzione.  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 4096.

## Corpo della richiesta
<a name="API_DescribeVoices_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

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

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

{
   "NextToken": "string",
   "Voices": [ 
      { 
         "AdditionalLanguageCodes": [ "string" ],
         "Gender": "string",
         "Id": "string",
         "LanguageCode": "string",
         "LanguageName": "string",
         "Name": "string",
         "SupportedEngines": [ "string" ]
      }
   ]
}
```

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

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

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

 ** [NextToken](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-NextToken"></a>
Il token di impaginazione da utilizzare nella richiesta successiva per continuare l'elenco delle voci. `NextToken` viene restituito solo se la risposta viene troncata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 4096.

 ** [Voices](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-Voices"></a>
Un elenco di voci con le loro proprietà.  
Tipo: matrice di oggetti [Voice](API_Voice.md)

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

 ** InvalidNextTokenException **   
Non NextToken è valido. Verificare che sia stato digitato correttamente, quindi riprovare.  
Codice di stato HTTP: 400

 ** ServiceFailureException **   
Una condizione sconosciuta ha causato un errore di servizio.  
Codice di stato HTTP: 500

## Vedi anche
<a name="API_DescribeVoices_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/DescribeVoices) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DescribeVoices) 

# GetLexicon
<a name="API_GetLexicon"></a>

Restituisce i contenuti del lessico di pronuncia specificato archiviato in una regione Regione AWS. Per ulteriori informazioni, consulta [Managing Lexicons](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html) (Gestione di lessici).

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

```
GET /v1/lexicons/LexiconName HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_GetLexicon_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [LexiconName](#API_GetLexicon_RequestSyntax) **   <a name="polly-GetLexicon-request-uri-Name"></a>
Nome del lessico.  
Modello: `[0-9A-Za-z]{1,20}`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetLexicon_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

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

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

{
   "Lexicon": { 
      "Content": "string",
      "Name": "string"
   },
   "LexiconAttributes": { 
      "Alphabet": "string",
      "LanguageCode": "string",
      "LastModified": number,
      "LexemesCount": number,
      "LexiconArn": "string",
      "Size": number
   }
}
```

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

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

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

 ** [Lexicon](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-Lexicon"></a>
Oggetto lessico che fornisce nome e contenuto della stringa del lessico.   
Tipo: oggetto [Lexicon](API_Lexicon.md)

 ** [LexiconAttributes](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-LexiconAttributes"></a>
Metadati del lessico, compreso l'alfabetico fonetico utilizzato, il codice della lingua, il lessico ARN, il numero di lessemi definiti nel lessico e la dimensione del lessico in byte.  
Tipo: oggetto [LexiconAttributes](API_LexiconAttributes.md)

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

 ** LexiconNotFoundException **   
Amazon Polly non è in grado di individuare il lessico specificato. Ciò potrebbe essere causato da un lessico mancante, il suo nome è errato o specificando un lessico che si trova in una regione diversa.  
Verificare che il lessico esista, sia nella regione (consulta [ListLexicons](API_ListLexicons.md)) e che hai digitato il suo nome sia corretto. Allora try again.  
Codice di stato HTTP: 404

 ** ServiceFailureException **   
Una condizione sconosciuta ha causato un errore di servizio.  
Codice di stato HTTP: 500

## Vedi anche
<a name="API_GetLexicon_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/GetLexicon) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetLexicon) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetLexicon) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetLexicon) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetLexicon) 

# GetSpeechSynthesisTask
<a name="API_GetSpeechSynthesisTask"></a>

Recupera un SpeechSynthesisTask oggetto specifico in base al relativo TaskID. Questo oggetto contiene informazioni sull'attività di sintesi vocale data, incluso lo stato dell'attività, e un collegamento al S3 Bucket contenente l'output dell'attività.

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

```
GET /v1/synthesisTasks/TaskId HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_GetSpeechSynthesisTask_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [TaskId](#API_GetSpeechSynthesisTask_RequestSyntax) **   <a name="polly-GetSpeechSynthesisTask-request-uri-TaskId"></a>
Il identificatore unico per il processo di sintesi vocale generato da Amazon Polly.  
Modello: `^[a-zA-Z0-9_-]{1,100}$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetSpeechSynthesisTask_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

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

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

{
   "SynthesisTask": { 
      "CreationTime": number,
      "Engine": "string",
      "LanguageCode": "string",
      "LexiconNames": [ "string" ],
      "OutputFormat": "string",
      "OutputUri": "string",
      "RequestCharacters": number,
      "SampleRate": "string",
      "SnsTopicArn": "string",
      "SpeechMarkTypes": [ "string" ],
      "TaskId": "string",
      "TaskStatus": "string",
      "TaskStatusReason": "string",
      "TextType": "string",
      "VoiceId": "string"
   }
}
```

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

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

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

 ** [SynthesisTask](#API_GetSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-GetSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask oggetto che fornisce informazioni sull'attività richiesta, tra cui il formato di output, l'ora di creazione, lo stato dell'attività e così via.  
Tipo: oggetto [SynthesisTask](API_SynthesisTask.md)

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

 ** InvalidTaskIdException **   
L'ID attività fornito non è valido. Fornisci un ID attività valido e riprova.  
Codice di stato HTTP: 400

 ** ServiceFailureException **   
Una condizione sconosciuta ha causato un errore di servizio.  
Codice di stato HTTP: 500

 ** SynthesisTaskNotFoundException **   
Impossibile trovare l'attività Sintesi vocale con ID attività richiesto.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_GetSpeechSynthesisTask_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/GetSpeechSynthesisTask) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetSpeechSynthesisTask) 

# ListLexicons
<a name="API_ListLexicons"></a>

Restituisce un elenco di lessici di pronuncia archiviati in una regione Regione AWS. Per ulteriori informazioni, consulta [Managing Lexicons](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html) (Gestione di lessici).

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

```
GET /v1/lexicons?NextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListLexicons_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [NextToken](#API_ListLexicons_RequestSyntax) **   <a name="polly-ListLexicons-request-uri-NextToken"></a>
Un token di impaginazione opaco restituito dal precedente operazione `ListLexicons`. Se presente, indica dove continuare l'elenco dei lessiconi.  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 4096.

## Corpo della richiesta
<a name="API_ListLexicons_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

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

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

{
   "Lexicons": [ 
      { 
         "Attributes": { 
            "Alphabet": "string",
            "LanguageCode": "string",
            "LastModified": number,
            "LexemesCount": number,
            "LexiconArn": "string",
            "Size": number
         },
         "Name": "string"
      }
   ],
   "NextToken": "string"
}
```

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

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

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

 ** [Lexicons](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-Lexicons"></a>
Un elenco di nomi e attributi del lessico.  
Tipo: matrice di oggetti [LexiconDescription](API_LexiconDescription.md)

 ** [NextToken](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-NextToken"></a>
Il token di impaginazione da utilizzare nella richiesta successiva per continuare l'elenco dei lessici. `NextToken` viene restituito solo se la risposta viene troncata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 4096.

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

 ** InvalidNextTokenException **   
Non NextToken è valido. Verificare che sia stato digitato correttamente, quindi riprovare.  
Codice di stato HTTP: 400

 ** ServiceFailureException **   
Una condizione sconosciuta ha causato un errore di servizio.  
Codice di stato HTTP: 500

## Vedi anche
<a name="API_ListLexicons_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/ListLexicons) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListLexicons) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListLexicons) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListLexicons) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListLexicons) 

# ListSpeechSynthesisTasks
<a name="API_ListSpeechSynthesisTasks"></a>

Restituisce un elenco di SpeechSynthesisTask oggetti ordinati in base alla data di creazione. Questa operazione consente di filtrare le attività in base al relativo stato, ad esempio consentendo agli utenti di elencare solo le attività completate.

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

```
GET /v1/synthesisTasks?MaxResults=MaxResults&NextToken=NextToken&Status=Status HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListSpeechSynthesisTasks_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [MaxResults](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-MaxResults"></a>
Numero massimo di attività di sintesi vocale restituite in un'operazione List.  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.

 ** [NextToken](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-NextToken"></a>
Il token di impaginazione da utilizzare nella richiesta successiva per continuare l'elenco delle attività di sintesi vocale.   
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 4096.

 ** [Status](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-Status"></a>
Stato delle attività di sintesi vocale restituite in un'operazione List  
Valori validi: `scheduled | inProgress | completed | failed` 

## Corpo della richiesta
<a name="API_ListSpeechSynthesisTasks_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

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

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

{
   "NextToken": "string",
   "SynthesisTasks": [ 
      { 
         "CreationTime": number,
         "Engine": "string",
         "LanguageCode": "string",
         "LexiconNames": [ "string" ],
         "OutputFormat": "string",
         "OutputUri": "string",
         "RequestCharacters": number,
         "SampleRate": "string",
         "SnsTopicArn": "string",
         "SpeechMarkTypes": [ "string" ],
         "TaskId": "string",
         "TaskStatus": "string",
         "TaskStatusReason": "string",
         "TextType": "string",
         "VoiceId": "string"
      }
   ]
}
```

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

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

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

 ** [NextToken](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-NextToken"></a>
Un token di impaginazione opaco restituito dall'operazione List precedente in questa richiesta. Se presente, indica dove continuare l'inserzione.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 4096.

 ** [SynthesisTasks](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-SynthesisTasks"></a>
Elenco di SynthesisTask oggetti che fornisce informazioni sull'attività specificata nella richiesta di elenco, inclusi il formato di output, l'ora di creazione, lo stato dell'attività e così via.  
Tipo: matrice di oggetti [SynthesisTask](API_SynthesisTask.md)

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

 ** InvalidNextTokenException **   
Non NextToken è valido. Verificare che sia stato digitato correttamente, quindi riprovare.  
Codice di stato HTTP: 400

 ** ServiceFailureException **   
Una condizione sconosciuta ha causato un errore di servizio.  
Codice di stato HTTP: 500

## Vedi anche
<a name="API_ListSpeechSynthesisTasks_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/ListSpeechSynthesisTasks) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListSpeechSynthesisTasks) 

# PutLexicon
<a name="API_PutLexicon"></a>

Archivia un lessico di pronuncia in una regione Regione AWS. Se un lessico con lo stesso nome esiste già nella regione, viene sovrascritto dal nuovo lessico. Le operazioni del lessico hanno una certa coerenza, pertanto potrebbe essere necessario del tempo prima che il lessico sia disponibile per l'operazione. SynthesizeSpeech 

Per ulteriori informazioni, consulta [Managing Lexicons](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html) (Gestione di lessici).

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

```
PUT /v1/lexicons/LexiconName HTTP/1.1
Content-type: application/json

{
   "Content": "string"
}
```

## Parametri della richiesta URI
<a name="API_PutLexicon_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [LexiconName](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-uri-Name"></a>
Nome del lessico. Il nome deve seguire il formato espresso normale [0-9A-Za-z]\$11,20\$1. Cioè, il nome è una stringa alfanumerica con distinzione tra maiuscole e minuscole da 20 caratteri.   
Modello: `[0-9A-Za-z]{1,20}`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_PutLexicon_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [Content](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-Content"></a>
Contenuto del lessico PLS come dati stringa.  
Tipo: stringa  
Obbligatorio: sì

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

```
HTTP/1.1 200
```

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

 ** InvalidLexiconException **   
Amazon Polly non è in grado di individuare il lessico specificato. Verificare che il nome del lessico sia stato digitato correttamente, quindi riprovare.  
Codice di stato HTTP: 400

 ** LexiconSizeExceededException **   
La dimensione massima del lessico specificato verrebbe superata da questa operazione.  
Codice di stato HTTP: 400

 ** MaxLexemeLengthExceededException **   
La dimensione massima del lessema verrebbe superata da questa operazione.  
Codice di stato HTTP: 400

 ** MaxLexiconsNumberExceededException **   
Il numero massimo di lessici verrebbe superato da questa operazione.  
Codice di stato HTTP: 400

 ** ServiceFailureException **   
Una condizione sconosciuta ha causato un errore di servizio.  
Codice di stato HTTP: 500

 ** UnsupportedPlsAlphabetException **   
L'alfabeto specificato dal lessico non è un alfabeto supportato. I valori validi sono `x-sampa` e `ipa`.  
Codice di stato HTTP: 400

 ** UnsupportedPlsLanguageException **   
La lingua specificata nel lessico non è supportata. Per un elenco di linguaggi supportati, consulta [Lexicon Attributes](https://docs.aws.amazon.com/polly/latest/dg/API_LexiconAttributes.html) (Attributi del lessico).  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_PutLexicon_SeeAlso"></a>

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

# 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`   
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) 

# StartSpeechSynthesisTask
<a name="API_StartSpeechSynthesisTask"></a>

Consente la creazione di un'attività di sintesi asincrona, avviando un nuovo `SpeechSynthesisTask`. Questa operazione richiede tutte le informazioni standard necessarie per la sintesi vocale, oltre al nome di un bucket Amazon S3 affinché il servizio archivi l'output dell'attività di sintesi e due parametri opzionali (`OutputS3KeyPrefix` e `SnsTopicArn`). Una volta creata l'attività di sintesi, questa operazione restituirà un oggetto `SpeechSynthesisTask`, che includerà un identificatore di questa attività e lo stato corrente. L'oggetto `SpeechSynthesisTask` è disponibile per 72 ore dopo l'avvio dell'attività di sintesi asincrona.

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

```
POST /v1/synthesisTasks HTTP/1.1
Content-type: application/json

{
   "Engine": "string",
   "LanguageCode": "string",
   "LexiconNames": [ "string" ],
   "OutputFormat": "string",
   "OutputS3BucketName": "string",
   "OutputS3KeyPrefix": "string",
   "SampleRate": "string",
   "SnsTopicArn": "string",
   "SpeechMarkTypes": [ "string" ],
   "Text": "string",
   "TextType": "string",
   "VoiceId": "string"
}
```

## Parametri della richiesta URI:
<a name="API_StartSpeechSynthesisTask_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_StartSpeechSynthesisTask_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [Engine](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Engine"></a>
Speciifica il motore (`standard`,`neural`, `long-form` or`generative`) per Amazon Polly da utilizzare durante l'elaborazione del testo di input per la sintesi vocale. Se si utilizza una voce non supportata per il motore selezionato, si verificherà un errore.  
Tipo: String  
Valori validi: `standard | neural | long-form | generative`   
Campo obbligatorio: no

 ** [LanguageCode](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LanguageCode"></a>
Codice lingua facoltativo per la richiesta di sintesi vocale. Ciò è necessario solo se si utilizza una voce bilingue, come Aditi, che può essere utilizzata sia per l'inglese indiano (en-IN) che per l'hindi (hi-IN).   
Se viene utilizzata una voce bilingue e non viene specificato alcun codice lingua, Amazon Polly utilizza la lingua predefinita della voce bilingue. La lingua predefinita per ogni voce è quella restituita dall'[DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operazione per il `LanguageCode` parametro. Ad esempio, se non viene specificato alcun codice di lingua, Aditi utilizzerà l'inglese indiano anziché l'hindi.  
Tipo: String  
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`   
Campo obbligatorio: no

 ** [LexiconNames](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LexiconNames"></a>
Elenco di uno o più nomi di lessico di pronuncia che si desidera applicare il servizio durante la sintesi. I lessici vengono applicati solo se la lingua del lessico corrisponde alla lingua della voce.   
Tipo: array di stringhe  
Membri della matrice: numero massimo di 5 elementi.  
Modello: `[0-9A-Za-z]{1,20}`   
Obbligatorio: no

 ** [OutputFormat](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputFormat"></a>
Il formato in cui verrà codificato l'output restituito. Per lo streaming audio, saranno mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law o pcm. Per i segni vocali, questo sarà json.   
Tipo: String  
Valori validi: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Obbligatorio: sì

 ** [OutputS3BucketName](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3BucketName"></a>
Nome del bucket Amazon S3 in cui viene salvato il file di output.  
Tipo: stringa  
Modello: `^[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]$`   
Obbligatorio: sì

 ** [OutputS3KeyPrefix](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3KeyPrefix"></a>
Prefisso della chiave Amazon S3 per il file vocale di output.  
Tipo: stringa  
Modello: `^[0-9a-zA-Z\/\!\-_\.\*\'\(\):;\$@=+\,\?&]{0,800}$`   
Obbligatorio: no

 ** [SampleRate](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SampleRate"></a>
La frequenza audio specificata in Hz.  
I valori validi per mp3 e ogg\$1vorbis sono "8000", "16000", "22050" e "24000". Il valore predefinito per le voci standard è "22050". Il valore predefinito per le voci neurali è "24000". Il valore predefinito per le voci lunghe è «24000". Il valore predefinito per le voci generative è «24000".  
I valori validi per pcm sono "8000" e "16000". Il valore predefinito è "16000".   
Il valore valido per ogg\$1opus è «48000".   
Il valore valido per mu-law e a-law è «8000".   
▬Tipo: stringa  
Obbligatorio: no

 ** [SnsTopicArn](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SnsTopicArn"></a>
ARN per l'argomento SNS utilizzato facoltativamente per la notifica di stato per un'attività di sintesi vocale.  
Tipo: stringa  
Modello: `^arn:aws(-(cn|iso(-b)?|us-gov))?:sns:[a-z0-9_-]{1,50}:\d{12}:[a-zA-Z0-9_-]{1,251}([a-zA-Z0-9_-]{0,5}|\.fifo)$`   
Obbligatorio: no

 ** [SpeechMarkTypes](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SpeechMarkTypes"></a>
Tipo di segni vocali restituiti per il testo di input.  
Tipo: array di stringhe  
Membri della matrice: numero massimo di 4 elementi.  
Valori validi: `sentence | ssml | viseme | word`   
Campo obbligatorio: no

 ** [Text](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Text"></a>
Testo di input da sintetizzare. Se specificate ssml come TextType, seguite il formato SSML per il testo di input.   
Tipo: stringa  
Obbligatorio: sì

 ** [TextType](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-TextType"></a>
Specifica se il testo di input è testo normale o SSML. Il valore di default è testo normale.   
Tipo: String  
Valori validi: `ssml | text`   
Campo obbligatorio: no

 ** [VoiceId](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-VoiceId"></a>
ID vocale da utilizzare per la sintesi.   
Tipo: String  
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ì

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

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

{
   "SynthesisTask": { 
      "CreationTime": number,
      "Engine": "string",
      "LanguageCode": "string",
      "LexiconNames": [ "string" ],
      "OutputFormat": "string",
      "OutputUri": "string",
      "RequestCharacters": number,
      "SampleRate": "string",
      "SnsTopicArn": "string",
      "SpeechMarkTypes": [ "string" ],
      "TaskId": "string",
      "TaskStatus": "string",
      "TaskStatusReason": "string",
      "TextType": "string",
      "VoiceId": "string"
   }
}
```

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

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

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

 ** [SynthesisTask](#API_StartSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask oggetto che fornisce informazioni e attributi su un compito di sintesi vocale appena inviato.  
Tipo: oggetto [SynthesisTask](API_SynthesisTask.md)

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

 ** EngineNotSupportedException **   
Questo motore non è compatibile con la voce designata. Scegli una nuova voce compatibile con il motore o cambia il motore e riavvia l'operazione.  
Codice di stato HTTP: 400

 ** InvalidS3BucketException **   
Il nome del bucket Amazon S3 non è valido. Controlla il tuo input con i requisiti di denominazione del S3 Bucket e riprova.  
Codice di stato HTTP: 400

 ** InvalidS3KeyException **   
Il prefisso della chiave Amazon S3 non è valido. Fornisci un nome chiave oggetto S3 valido.  
Codice di stato HTTP: 400

 ** InvalidSampleRateException **   
La frequenza di campionamento specificata non è valida.  
Codice di stato HTTP: 400

 ** InvalidSnsTopicArnException **   
L'ARN dell'argomento SNS fornito non è valido. Fornisci un ARN di argomento SNS valido e riprova.  
Codice di stato HTTP: 400

 ** InvalidSsmlException **   
L'SSML fornito non è valido. Verifica la sintassi SSML, l'ortografia dei tag e dei valori, quindi riprova.  
Codice di stato HTTP: 400

 ** LanguageNotSupportedException **   
La lingua specificata non è attualmente supportata da Amazon Polly in questa capacità.  
Codice di stato HTTP: 400

 ** LexiconNotFoundException **   
Amazon Polly non è in grado di individuare il lessico specificato. Ciò potrebbe essere causato da un lessico mancante, il suo nome è errato o specificando un lessico che si trova in una regione diversa.  
Verificare che il lessico esista, sia nella regione (consulta [ListLexicons](API_ListLexicons.md)) e che hai digitato il suo nome sia corretto. Allora try again.  
Codice di stato HTTP: 404

 ** MarksNotSupportedForFormatException **   
I contrassegni vocali non sono supportati per `OutputFormat` selezionato. I contrassegni vocali sono disponibili solo per il contenuto in formato `json`.  
Codice di stato HTTP: 400

 ** ServiceFailureException **   
Una condizione sconosciuta ha causato un errore di servizio.  
Codice di stato HTTP: 500

 ** SsmlMarksNotSupportedForTextTypeException **   
I contrassegni vocali SSML non sono supportati per l'input di tipo testo normale.  
Codice di stato HTTP: 400

 ** TextLengthExceededException **   
Il valore del parametro "Testo" è più lungo dei limiti accettati. Per il API `SynthesizeSpeech`, il limite per il testo di input è un massimo di 6000 caratteri totali, di cui non più di 3000 caratteri possono essere fatturati. Per il API `StartSpeechSynthesisTask`, il massimo è 200.000 caratteri, di cui non più di 100.000 caratteri possono essere fatturati. I tag SSML non vengono conteggiati come caratteri fatturati.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_StartSpeechSynthesisTask_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/StartSpeechSynthesisTask) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisTask) 

# SynthesizeSpeech
<a name="API_SynthesizeSpeech"></a>

Sintetizza input UTF-8, testo normale o SSML in un flusso di byte. L'input SSML deve essere valido e ben formato SSML. Alcuni alfabeti potrebbero non essere disponibili con tutte le voci (ad esempio, il cirillico potrebbe non essere letto affatto dalle voci inglesi) a meno che non venga utilizzata la mappatura dei fonemi. Per ulteriori informazioni, consulta [How it Works](https://docs.aws.amazon.com/polly/latest/dg/how-text-to-speech-works.html) (Come funziona).

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

```
POST /v1/speech HTTP/1.1
Content-type: application/json

{
   "Engine": "string",
   "LanguageCode": "string",
   "LexiconNames": [ "string" ],
   "OutputFormat": "string",
   "SampleRate": "string",
   "SpeechMarkTypes": [ "string" ],
   "Text": "string",
   "TextType": "string",
   "VoiceId": "string"
}
```

## Parametri della richiesta URI:
<a name="API_SynthesizeSpeech_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_SynthesizeSpeech_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [Engine](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Engine"></a>
Speciifica il motore (`standard`, `neural``long-form`, o`generative`) per Amazon Polly da utilizzare durante l'elaborazione del testo di input per la sintesi vocale. Fornisci un motore supportato dalla voce selezionata. Se non fornisci un motore, per impostazione predefinita viene selezionato il motore standard. Se una voce selezionata non è supportata dal motore standard, verrà generato un errore. [Per informazioni sulle voci di Amazon Polly e sulle voci disponibili per ogni motore, consulta Available Voices.](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html)  
Tipo: String  
Valori validi: `standard | neural | long-form | generative`   
Campo obbligatorio: no

 ** [LanguageCode](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LanguageCode"></a>
Codice della lingua facoltativo per la richiesta di sintesi vocale. Ciò è necessario solo se si utilizza una voce bilingue, come Aditi, che può essere utilizzata sia per l'inglese indiano (en-IN) che per l'hindi (hi-IN).   
Se viene utilizzata una voce bilingue e non viene specificato alcun codice lingua, Amazon Polly utilizza la lingua predefinita della voce bilingue. La lingua predefinita per ogni voce è quella restituita dall'[DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operazione per il `LanguageCode` parametro. Ad esempio, se non viene specificato alcun codice di lingua, Aditi utilizzerà l'inglese indiano anziché l'hindi.  
Tipo: String  
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`   
Campo obbligatorio: no

 ** [LexiconNames](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LexiconNames"></a>
Elenco di uno o più nomi di lessico di pronuncia che si desidera applicare il servizio durante la sintesi. I lessici vengono applicati solo se la lingua del lessico corrisponde alla lingua della voce. Per informazioni sulla memorizzazione dei lessici, vedere [PutLexicon](https://docs.aws.amazon.com/polly/latest/dg/API_PutLexicon.html).  
Tipo: array di stringhe  
Membri della matrice: numero massimo di 5 elementi.  
Modello: `[0-9A-Za-z]{1,20}`   
Obbligatorio: no

 ** [OutputFormat](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-OutputFormat"></a>
 Il formato in cui verrà codificato l'output restituito. Per lo streaming audio, saranno mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law o pcm. Per i segni vocali, questo sarà json.   
Quando si usa pcm, il contenuto restituito è audio/pcm in un formato con firma a 16 bit, 1 canale (mono), little-endian.   
Tipo: String  
Valori validi: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Obbligatorio: sì

 ** [SampleRate](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SampleRate"></a>
La frequenza audio specificata in Hz.  
I valori validi per mp3 e ogg\$1vorbis sono «8000", «16000", «22050", «24000", «44100" e «48000". Il valore predefinito per le voci standard è "22050". Il valore predefinito per le voci neurali è "24000". Il valore predefinito per le voci lunghe è «24000". Il valore predefinito per le voci generative è «24000".  
I valori validi per pcm sono "8000" e "16000". Il valore predefinito è "16000".   
Il valore valido per ogg\$1opus è «48000".   
Il valore valido per mu-law e a-law è «8000".   
▬Tipo: stringa  
Obbligatorio: no

 ** [SpeechMarkTypes](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SpeechMarkTypes"></a>
Tipo di segni vocali restituiti per il testo di input.  
Tipo: array di stringhe  
Membri della matrice: numero massimo di 4 elementi.  
Valori validi: `sentence | ssml | viseme | word`   
Campo obbligatorio: no

 ** [Text](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Text"></a>
 Inserisci testo da sintetizzare. Se si specifica `ssml` come `TextType`, seguire il formato SSML per il testo di input.   
Tipo: stringa  
Obbligatorio: sì

 ** [TextType](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-TextType"></a>
 Specifica se il testo di input è testo normale o SSML. Il valore di default è testo normale. Per ulteriori informazioni, consulta [Using SSML](https://docs.aws.amazon.com/polly/latest/dg/ssml.html) (Utilizzo di SSML).  
Tipo: String  
Valori validi: `ssml | text`   
Campo obbligatorio: no

 ** [VoiceId](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-VoiceId"></a>
 ID vocale da utilizzare per la sintesi. È possibile ottenere un elenco delle voci IDs disponibili chiamando l'operazione. [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)   
Tipo: String  
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ì

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

```
HTTP/1.1 200
Content-Type: ContentType
x-amzn-RequestCharacters: RequestCharacters

AudioStream
```

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

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

La risposta restituisce le seguenti intestazioni HTTP.

 ** [ContentType](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-ContentType"></a>
 Specifica il tipo di flusso audio. Questo dovrebbe riflettere il parametro `OutputFormat` nella richiesta.   
+  Se richiedi `mp3` come `OutputFormat`, il `ContentType` restituito è audio/mpeg. 
+  Se richiedi `ogg_vorbis` come `OutputFormat`, il `ContentType` restituito è audio/ogg. 
+  Se richiedi `ogg_opus` come `OutputFormat`, il `ContentType` restituito è audio/ogg. 
+  Se lo richiedi `pcm` come`OutputFormat`, il risultato `ContentType` restituito è audio/pcm in un formato con firma a 16 bit, 1 canale (mono), little-endian. 
+  Se lo richiedi `mu-law` come, il risultato restituito è audio/mulaw`OutputFormat`. `ContentType` 
+  Se lo richiedi `a-law` come`OutputFormat`, il risultato `ContentType` restituito è audio/alaw. 
+ Se lo richiedi `json` come`OutputFormat`, il risultato `ContentType` restituito è application/. x-json-stream
 

 ** [RequestCharacters](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-RequestCharacters"></a>
Numero di caratteri sintetizzati.

La risposta restituisce quanto segue come corpo HTTP.

 ** [AudioStream](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-AudioStream"></a>
 Flusso contenente il discorso sintetizzato. 

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

 ** EngineNotSupportedException **   
Questo motore non è compatibile con la voce designata. Scegli una nuova voce compatibile con il motore o cambia il motore e riavvia l'operazione.  
Codice di stato HTTP: 400

 ** InvalidSampleRateException **   
La frequenza di campionamento specificata non è valida.  
Codice di stato HTTP: 400

 ** InvalidSsmlException **   
L'SSML fornito non è valido. Verifica la sintassi SSML, l'ortografia dei tag e dei valori, quindi riprova.  
Codice di stato HTTP: 400

 ** LanguageNotSupportedException **   
La lingua specificata non è attualmente supportata da Amazon Polly in questa capacità.  
Codice di stato HTTP: 400

 ** LexiconNotFoundException **   
Amazon Polly non è in grado di individuare il lessico specificato. Ciò potrebbe essere causato da un lessico mancante, il suo nome è errato o specificando un lessico che si trova in una regione diversa.  
Verificare che il lessico esista, sia nella regione (consulta [ListLexicons](API_ListLexicons.md)) e che hai digitato il suo nome sia corretto. Allora try again.  
Codice di stato HTTP: 404

 ** MarksNotSupportedForFormatException **   
I contrassegni vocali non sono supportati per `OutputFormat` selezionato. I contrassegni vocali sono disponibili solo per il contenuto in formato `json`.  
Codice di stato HTTP: 400

 ** ServiceFailureException **   
Una condizione sconosciuta ha causato un errore di servizio.  
Codice di stato HTTP: 500

 ** SsmlMarksNotSupportedForTextTypeException **   
I contrassegni vocali SSML non sono supportati per l'input di tipo testo normale.  
Codice di stato HTTP: 400

 ** TextLengthExceededException **   
Il valore del parametro "Testo" è più lungo dei limiti accettati. Per il API `SynthesizeSpeech`, il limite per il testo di input è un massimo di 6000 caratteri totali, di cui non più di 3000 caratteri possono essere fatturati. Per il API `StartSpeechSynthesisTask`, il massimo è 200.000 caratteri, di cui non più di 100.000 caratteri possono essere fatturati. I tag SSML non vengono conteggiati come caratteri fatturati.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_SynthesizeSpeech_SeeAlso"></a>

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