DescribeVoices - Amazon Polly

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

Specifica il motore (standard o neural) utilizzato da Amazon Polly durante l'elaborazione del testo di input per la sintesi vocale.

Valori validi: standard | neural

IncludeAdditionalLanguageCodes

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

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

NextToken

Un token di impaginazione opaco restituito dal precedente operazione DescribeVoices. Se presente, indica dove continuare l'inserzione.

Vincoli 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

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

Vincoli di lunghezza: lunghezza minima di 0. Lunghezza massima di 4096.

Voices

Un elenco di voci con le loro proprietà.

Tipo: matrice di oggetti Voice

Errori

InvalidNextTokenException

Il NextToken non è 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 uno degli SDK AWS specifici della lingua, consulta quanto segue: