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à. # Informazioni di riferimento delle API Amazon Polly Amazon Polly è un servizio Web che semplifica la sintesi vocale dal testo. Il servizio Amazon Polly fornisce operazioni API per la sintesi di voci di alta qualità da testo semplice e Speech Synthesis Markup Language (SSML), oltre a gestire i lessici delle pronunce che consentono di ottenere i migliori risultati per il dominio dell'applicazione. Le chiamate API autenticate devono essere registrate tramite il processo di firma Signature Version 4. [Per ulteriori informazioni, consulta Firmare le richieste API in. AWS*Riferimenti generali di Amazon Web Services*](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) **Topics** + [ # Azioni ](API_Operations.md) + [ # Tipi di dati ](API_Types.md) + [ # Errori comuni ](CommonErrors.md) + [ # Parametri comuni ](CommonParameters.md) # Azioni 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 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 ``` DELETE /v1/lexicons/LexiconName HTTP/1.1 ``` ## Parametri della richiesta URI La richiesta utilizza i seguenti parametri URI. ** [LexiconName](#API_DeleteLexicon_RequestSyntax) ** Nome del lessico da eliminare. Deve essere un lessico esistente nella regione. Modello: `[0-9A-Za-z]{1,20}` Obbligatorio: sì ## Corpo della richiesta La richiesta non ha un corpo della richiesta. ## Sintassi della risposta ``` HTTP/1.1 200 ``` ## Elementi di risposta Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto. ## Errori ** 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 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 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 ``` GET /v1/voices?Engine=Engine&IncludeAdditionalLanguageCodes=IncludeAdditionalLanguageCodes&LanguageCode=LanguageCode&NextToken=NextToken HTTP/1.1 ``` ## Parametri della richiesta URI La richiesta utilizza i seguenti parametri URI. ** [Engine](#API_DescribeVoices_RequestSyntax) ** 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) ** 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) ** 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) ** 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 La richiesta non ha un corpo della richiesta. ## Sintassi della risposta ``` 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 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) ** 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) ** Un elenco di voci con le loro proprietà. Tipo: matrice di oggetti [Voice](API_Voice.md) ## Errori ** 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 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 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 ``` GET /v1/lexicons/LexiconName HTTP/1.1 ``` ## Parametri della richiesta URI La richiesta utilizza i seguenti parametri URI. ** [LexiconName](#API_GetLexicon_RequestSyntax) ** Nome del lessico. Modello: `[0-9A-Za-z]{1,20}` Obbligatorio: sì ## Corpo della richiesta La richiesta non ha un corpo della richiesta. ## Sintassi della risposta ``` 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 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) ** Oggetto lessico che fornisce nome e contenuto della stringa del lessico. Tipo: oggetto [Lexicon](API_Lexicon.md) ** [LexiconAttributes](#API_GetLexicon_ResponseSyntax) ** 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 ** 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 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 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 ``` GET /v1/synthesisTasks/TaskId HTTP/1.1 ``` ## Parametri della richiesta URI La richiesta utilizza i seguenti parametri URI. ** [TaskId](#API_GetSpeechSynthesisTask_RequestSyntax) ** 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 La richiesta non ha un corpo della richiesta. ## Sintassi della risposta ``` 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 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) ** 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 ** 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 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 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 ``` GET /v1/lexicons?NextToken=NextToken HTTP/1.1 ``` ## Parametri della richiesta URI La richiesta utilizza i seguenti parametri URI. ** [NextToken](#API_ListLexicons_RequestSyntax) ** 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 La richiesta non ha un corpo della richiesta. ## Sintassi della risposta ``` 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 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) ** Un elenco di nomi e attributi del lessico. Tipo: matrice di oggetti [LexiconDescription](API_LexiconDescription.md) ** [NextToken](#API_ListLexicons_ResponseSyntax) ** 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 ** 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 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 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 ``` GET /v1/synthesisTasks?MaxResults=MaxResults&NextToken=NextToken&Status=Status HTTP/1.1 ``` ## Parametri della richiesta URI La richiesta utilizza i seguenti parametri URI. ** [MaxResults](#API_ListSpeechSynthesisTasks_RequestSyntax) ** 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) ** 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) ** Stato delle attività di sintesi vocale restituite in un'operazione List Valori validi: `scheduled | inProgress | completed | failed` ## Corpo della richiesta La richiesta non ha un corpo della richiesta. ## Sintassi della risposta ``` 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 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) ** 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) ** 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 ** 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 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 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 ``` PUT /v1/lexicons/LexiconName HTTP/1.1 Content-type: application/json { "Content": "string" } ``` ## Parametri della richiesta URI La richiesta utilizza i seguenti parametri URI. ** [LexiconName](#API_PutLexicon_RequestSyntax) ** 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 La richiesta accetta i seguenti dati in formato JSON. ** [Content](#API_PutLexicon_RequestSyntax) ** Contenuto del lessico PLS come dati stringa. Tipo: stringa Obbligatorio: sì ## Sintassi della risposta ``` HTTP/1.1 200 ``` ## Elementi di risposta Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto. ## Errori ** 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 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 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 ``` 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](#API_StartSpeechSynthesisStream_RequestSyntax) ** 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) ** 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) ** 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) ** 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) ** La frequenza audio, specificata in Hz. ** [VoiceId](#API_StartSpeechSynthesisStream_RequestSyntax) ** 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 La richiesta accetta i seguenti dati in formato JSON. ** [CloseStreamEvent](#API_StartSpeechSynthesisStream_RequestSyntax) ** Un evento che indica la fine del flusso di input. Tipo: oggetto [CloseStreamEvent](API_CloseStreamEvent.md) Obbligatorio: no ** [TextEvent](#API_StartSpeechSynthesisStream_RequestSyntax) ** Un evento di testo contenente contenuti da sintetizzare. Tipo: oggetto [TextEvent](API_TextEvent.md) 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](#API_StartSpeechSynthesisStream_ResponseSyntax) ** Un evento audio contenente un discorso sintetizzato. Tipo: oggetto [AudioEvent](API_AudioEvent.md) ** [ServiceFailureException](#API_StartSpeechSynthesisStream_ResponseSyntax) ** Una condizione sconosciuta ha causato un errore di servizio. Tipo: eccezione Codice di stato HTTP: 500 ** [ServiceQuotaExceededException](#API_StartSpeechSynthesisStream_ResponseSyntax) ** Un'eccezione che indica il superamento di una quota di servizio. Tipo: eccezione Codice di stato HTTP: 402 ** [StreamClosedEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) ** Un evento, con informazioni di riepilogo, che indica che lo stream è stato chiuso. Tipo: oggetto [StreamClosedEvent](API_StreamClosedEvent.md) ** [ThrottlingException](#API_StartSpeechSynthesisStream_ResponseSyntax) ** Un'eccezione che indica che la richiesta è stata limitata. Tipo: eccezione Codice di stato HTTP: 400 ** [ValidationException](#API_StartSpeechSynthesisStream_ResponseSyntax) ** 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: + [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 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 ``` 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: La richiesta non utilizza parametri URI. ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [Engine](#API_StartSpeechSynthesisTask_RequestSyntax) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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 ``` 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 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) ** SynthesisTask oggetto che fornisce informazioni e attributi su un compito di sintesi vocale appena inviato. Tipo: oggetto [SynthesisTask](API_SynthesisTask.md) ## Errori ** 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 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 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 ``` 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: La richiesta non utilizza parametri URI. ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [Engine](#API_SynthesizeSpeech_RequestSyntax) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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 ``` HTTP/1.1 200 Content-Type: ContentType x-amzn-RequestCharacters: RequestCharacters AudioStream ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. La risposta restituisce le seguenti intestazioni HTTP. ** [ContentType](#API_SynthesizeSpeech_ResponseSyntax) ** 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) ** Numero di caratteri sintetizzati. La risposta restituisce quanto segue come corpo HTTP. ** [AudioStream](#API_SynthesizeSpeech_ResponseSyntax) ** Flusso contenente il discorso sintetizzato. ## Errori ** 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 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) # Tipi di dati Sono supportati i tipi di dati seguenti: + [AudioEvent](API_AudioEvent.md) + [CloseStreamEvent](API_CloseStreamEvent.md) + [FlushStreamConfiguration](API_FlushStreamConfiguration.md) + [Lexicon](API_Lexicon.md) + [LexiconAttributes](API_LexiconAttributes.md) + [LexiconDescription](API_LexiconDescription.md) + [StartSpeechSynthesisStreamActionStream](API_StartSpeechSynthesisStreamActionStream.md) + [StartSpeechSynthesisStreamEventStream](API_StartSpeechSynthesisStreamEventStream.md) + [StreamClosedEvent](API_StreamClosedEvent.md) + [SynthesisTask](API_SynthesisTask.md) + [TextEvent](API_TextEvent.md) + [ThrottlingReason](API_ThrottlingReason.md) + [ValidationExceptionField](API_ValidationExceptionField.md) + [Voice](API_Voice.md) # AudioEvent Contiene una parte di dati audio sintetizzati. ## Indice ** AudioChunk ** Un blocco di dati audio sintetizzati codificati nel formato specificato dal parametro. `OutputFormat` Tipo: oggetto dati binari con codifica Base64 Campo obbligatorio: no ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/AudioEvent) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/AudioEvent) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/AudioEvent) # CloseStreamEvent Indica la fine del flusso di input. Dopo l'invio di questo evento, il flusso di input verrà chiuso e verrà restituito tutto l'audio. ## Indice I membri di questa struttura di eccezioni dipendono dal contesto. ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/CloseStreamEvent) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/CloseStreamEvent) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/CloseStreamEvent) # FlushStreamConfiguration Configurazione che controlla quando i dati audio sintetizzati vengono inviati al flusso di uscita. ## Indice ** Force ** Speciifica se forzare il motore di sintesi a scrivere immediatamente dati audio bufferizzati nel flusso di uscita. Tipo: Booleano Campo obbligatorio: no ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consultate quanto segue AWS SDKs: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/FlushStreamConfiguration) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/FlushStreamConfiguration) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/FlushStreamConfiguration) # Lexicon Fornisce il nome del lessico e il contenuto del lessico in formato stringa. Per ulteriori informazioni, consulta [Pronunciation Lexicon Specification (PLS) Version 1.0](https://www.w3.org/TR/pronunciation-lexicon/). ## Indice ** Content ** Contenuto lessico in formato stringa. Il contenuto di un lessico deve essere in formato PLS. Tipo: string Campo obbligatorio: no ** Name ** Nome del lessico. Tipo: stringa Modello: `[0-9A-Za-z]{1,20}` Campo obbligatorio: no ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Lexicon) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Lexicon) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Lexicon) # LexiconAttributes Contiene metadati che descrivono il lessico, ad esempio il numero di lessemi, il codice della lingua e così via. Per ulteriori informazioni, consulta [Managing Lexicons](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html) (Gestione di lessici). ## Indice ** Alphabet ** Alfabeto fonetico usato nel lessico. I valori validi sono `ipa` e `x-sampa`. ▬Tipo: stringa Obbligatorio: no ** LanguageCode ** Codice della lingua a cui si applica il lessico. Un lessico con un codice di lingua come "en" verrebbe applicato a tutte le lingue inglesi (en-GB, en-US, en-AUS, en-WLS e così via. 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 ** LastModified ** Data dell'ultima modifica del lessico (un valore timestamp). Tipo: Timestamp Obbligatorio: no ** LexemesCount ** Numero di lessemi nel lessico. Tipo: Integer Obbligatorio: no ** LexiconArn ** Amazon Resource Name (ARN) del lessico. ▬Tipo: stringa Obbligatorio: no ** Size ** Dimensione totale del lessico, espressa in caratteri. Tipo: Integer Campo obbligatorio: no ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconAttributes) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconAttributes) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconAttributes) # LexiconDescription Descrive i contenuti del lessico. ## Indice ** Attributes ** Fornisce i metadati del lessico. Tipo: oggetto [LexiconAttributes](API_LexiconAttributes.md) Campo obbligatorio: no ** Name ** Nome del lessico. Tipo: stringa Modello: `[0-9A-Za-z]{1,20}` Campo obbligatorio: no ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconDescription) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconDescription) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconDescription) # StartSpeechSynthesisStreamActionStream Flusso di eventi in entrata per l'invio di eventi di input e controllo per gestire la sintesi vocale bidirezionale. ## Indice ** CloseStreamEvent ** Un evento che indica la fine del flusso di input. Tipo: oggetto [CloseStreamEvent](API_CloseStreamEvent.md) Obbligatorio: no ** TextEvent ** Un evento di testo contenente contenuti da sintetizzare. Tipo: oggetto [TextEvent](API_TextEvent.md) Campo obbligatorio: no ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) # StartSpeechSynthesisStreamEventStream Flusso di eventi in uscita che contiene dati audio sintetizzati ed eventi sullo stato del flusso. ## Indice ** AudioEvent ** Un evento audio contenente voce sintetizzata. Tipo: oggetto [AudioEvent](API_AudioEvent.md) Obbligatorio: no ** ServiceFailureException ** Una condizione sconosciuta ha causato un errore di servizio. Tipo: eccezione Codice di stato HTTP: 500 Obbligatorio: no ** ServiceQuotaExceededException ** Un'eccezione che indica il superamento di una quota di servizio. Tipo: eccezione Codice di stato HTTP: 402 Obbligatorio: no ** StreamClosedEvent ** Un evento, con informazioni di riepilogo, che indica che lo stream è stato chiuso. Tipo: oggetto [StreamClosedEvent](API_StreamClosedEvent.md) Obbligatorio: no ** ThrottlingException ** Un'eccezione che indica che la richiesta è stata limitata. Tipo: eccezione Codice di stato HTTP: 400 Obbligatorio: no ** ValidationException ** Un'eccezione che indica che la convalida dell'input non è riuscita. Tipo: eccezione Codice di stato HTTP: 400 Campo obbligatorio: no ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) # StreamClosedEvent Indica che il flusso di sintesi è chiuso e fornisce informazioni di riepilogo. ## Indice ** RequestCharacters ** Il numero totale di caratteri sintetizzati durante la sessione di streaming. Tipo: Integer Campo obbligatorio: no ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StreamClosedEvent) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StreamClosedEvent) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StreamClosedEvent) # SynthesisTask SynthesisTask oggetto che fornisce informazioni su un'attività di sintesi vocale. ## Indice ** CreationTime ** Indicatore orario per l'ora in cui è stato avviato il processo di sintesi. Tipo: Timestamp Obbligatorio: no ** Engine ** 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 ** Codice lingua facoltativo per un processo di sintesi. 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 ** 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 ** 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` Campo obbligatorio: no ** OutputUri ** Percorso per il file di sintesi vocale di output. ▬Tipo: stringa Obbligatorio: no ** RequestCharacters ** Numero di caratteri fatturabili sintetizzati. Tipo: Integer Obbligatorio: no ** SampleRate ** 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 ** 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 ** 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 ** TaskId ** Il identificatore unico per l'attività di sintesi vocale generato da Amazon Polly. Tipo: stringa Modello: `^[a-zA-Z0-9_-]{1,100}$` Obbligatorio: no ** TaskStatus ** Stato corrente dell'attività di sintesi vocale individuale. Tipo: String Valori validi: `scheduled | inProgress | completed | failed` Campo obbligatorio: no ** TaskStatusReason ** Motivo dello stato corrente di un'attività di sintesi vocale specifica, inclusi gli errori se l'attività non è riuscita. ▬Tipo: stringa Obbligatorio: no ** TextType ** 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 ** 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` Campo obbligatorio: no ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesisTask) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesisTask) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesisTask) # TextEvent Contiene contenuti testuali da sintetizzare in voce. ## Indice ** Text ** Il contenuto del testo da sintetizzare. Se si specifica `ssml` come `TextType`, seguire il formato SSML per il testo di input. Tipo: stringa Obbligatorio: sì ** FlushStreamConfiguration ** Configurazione per controllare quando l'audio sintetizzato arriva al flusso di uscita. Tipo: oggetto [FlushStreamConfiguration](API_FlushStreamConfiguration.md) Obbligatorio: no ** TextType ** Specifica se il testo di input è testo normale o SSML. Impostazione predefinita: testo semplice. Tipo: String Valori validi: `ssml | text` Campo obbligatorio: no ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/TextEvent) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/TextEvent) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/TextEvent) # ThrottlingReason Fornisce informazioni su uno specifico motivo di limitazione. ## Indice ** reason ** Il codice del motivo che spiega il motivo per cui la richiesta è stata limitata. ▬Tipo: stringa Obbligatorio: no ** resource ** La risorsa che ha causato la limitazione. ▬Tipo: stringa Obbligatorio: no ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ThrottlingReason) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ThrottlingReason) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ThrottlingReason) # ValidationExceptionField Informazioni su un campo la cui convalida non è riuscita. ## Indice ** message ** Un messaggio che descrive il motivo per cui la convalida del campo non è riuscita. Tipo: stringa Obbligatorio: sì ** name ** Il nome del campo che non è riuscito a convalidare. Tipo: stringa Obbligatorio: sì ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ValidationExceptionField) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ValidationExceptionField) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ValidationExceptionField) # Voice Descrizione del voce. ## Indice ** AdditionalLanguageCodes ** Codici aggiuntivi per le lingue disponibili per la voce specificata oltre alla lingua predefinita. Ad esempio, la lingua predefinita per Aditi è l'inglese indiano (en-IN) perché è stato utilizzato per la prima volta per quella lingua. Poiché Aditi è bilingue e fluente in inglese indiano e hindi, questo parametro mostrerebbe il codice `hi-IN`. Tipo: array di stringhe 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 ** Gender ** Sesso della voce. Tipo: String Valori validi: `Female | Male` Campo obbligatorio: no ** Id ** Amazon Polly ha assegnato l'ID della voce. Questo è l'ID che si specifica quando si chiama la operazione `SynthesizeSpeech`. 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` Campo obbligatorio: no ** LanguageCode ** Codice della lingua della voce. 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 ** LanguageName ** Nome leggibile della lingua in inglese. ▬Tipo: stringa Obbligatorio: no ** Name ** Nome della voce (ad esempio, Salli, Kendra, ecc.). Questo fornisce un nome della voce leggibile dall'utente che potrebbe essere visualizzato nell'applicazione. ▬Tipo: stringa Obbligatorio: no ** SupportedEngines ** Speciifica quali motori (`standard`,`neural`, `long-form` or`generative`) sono supportati da una determinata voce. Tipo: array di stringhe Valori validi: `standard | neural | long-form | generative` Campo obbligatorio: no ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Voice) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Voice) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Voice) # Errori comuni Questa sezione elenca gli errori comuni alle azioni API di tutti i AWS servizi. Per gli errori specifici di un'azione API per questo servizio, consulta l'argomento per quell'azione API. **AccessDeniedException** Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione. Codice di stato HTTP: 400 **IncompleteSignature** La firma della richiesta non è conforme agli AWS standard. Codice di stato HTTP: 400 **InternalFailure** L'elaborazione della richiesta non è riuscita a causa di un errore, un'eccezione o un guasto interno sconosciuto. Codice di stato HTTP: 500 **InvalidAction** L'azione o l'operazione richiesta non è valida. Verifica che l'operazione sia digitata correttamente. Codice di stato HTTP: 400 **InvalidClientTokenId** Il certificato X.509 o AWS l'ID della chiave di accesso fornito non esiste nei nostri archivi. Codice di stato HTTP: 403 **NotAuthorized** Non disponi delle autorizzazioni per eseguire questa azione. Codice di stato HTTP: 400 **OptInRequired** L'ID della chiave di AWS accesso richiede un abbonamento al servizio. Codice di stato HTTP: 403 **RequestExpired** La richiesta ha raggiunto il servizio più di 15 minuti dopo la data indicata sulla richiesta o più di 15 minuti dopo la data di scadenza della richiesta (ad esempio nel caso di pre-firmata URLs), oppure la data indicata sulla richiesta è tra più di 15 minuti. Codice di stato HTTP: 400 **ServiceUnavailable** La richiesta non è riuscita a causa di un errore temporaneo del server. Codice di stato HTTP: 503 **ThrottlingException** La richiesta è stata negata a causa del throttling della richiesta. Codice di stato HTTP: 400 **ValidationError** L'input non soddisfa i vincoli specificati da un servizio. AWS Codice di stato HTTP: 400 # Parametri comuni L'elenco seguente contiene i parametri utilizzati da tutte le azioni per firmare le richieste di Signature Version 4 con una stringa di query. Qualsiasi parametro specifico di un'operazione è riportato nell'argomento relativo all'operazione. Per ulteriori informazioni sulla versione 4 di Signature, consulta [Signing AWS API requests](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) nella *IAM User Guide*. **X-Amz-Algorithm** Algoritmo hash utilizzato per creare la firma della richiesta. Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP. Tipo: stringa Valori validi: `AWS4-HMAC-SHA256` Obbligatorio: condizionale **X-Amz-Credential** Il valore dell'ambito delle credenziali, che è una stringa che include la chiave di accesso, la data, la regione di destinazione, il servizio richiesto e una stringa di terminazione ("aws4\$1request"). Il valore viene espresso nel seguente formato: *chiave\$1accesso*/*AAAAMMGG*/*regione*/*servizio*/aws4\$1request. Per ulteriori informazioni, consulta [Creare una richiesta AWS API firmata](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) nella *Guida per l'utente IAM*. Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP. Tipo: stringa Obbligatorio: condizionale **X-Amz-Date** La data utilizzata per creare la firma. Il formato deve essere il formato di base ISO 8601 (YYYYMMDD'T'HHMMSS'Z'). Per esempio, la data e l'ora seguenti è un X-Amz-Date valore valido:`20120325T120000Z`. Condizione: X-Amz-Date è facoltativa per tutte le richieste; può essere utilizzata per sovrascrivere la data utilizzata per firmare le richieste. Se l'intestazione Date è specificata nel formato base ISO 8601, non X-Amz-Date è obbligatoria. Quando X-Amz-Date viene utilizzata, sovrascrive sempre il valore dell'intestazione Date. Per ulteriori informazioni, consulta [Elementi di una firma di richiesta AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) nella Guida per l'utente *IAM*. Tipo: stringa Obbligatorio: condizionale **X-Amz-Security-Token** Il token di sicurezza temporaneo ottenuto tramite una chiamata a AWS Security Token Service (AWS STS). Per un elenco di servizi che supportano le credenziali di sicurezza temporanee da AWS STS, consulta la pagina [Servizi AWS che funzionano con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) nella *Guida per l'utente di IAM*. Condizione: se utilizzi credenziali di sicurezza temporanee di AWS STS, devi includere il token di sicurezza. Tipo: stringa Obbligatorio: condizionale **X-Amz-Signature** Specifica la firma con codifica esadecimale calcolata dalla stringa da firmare e dalla chiave di firma derivata. Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP. Tipo: stringa Obbligatorio: condizionale **X-Amz-SignedHeaders** Specifica tutte le intestazioni HTTP incluse come parte della richiesta canonica. Per ulteriori informazioni sulla specificazione delle intestazioni firmate, consulta [Creare una richiesta AWS API firmata](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) nella Guida per l'utente *IAM*. Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP. Tipo: stringa Obbligatorio: condizionale