DescribeVoices - Amazon Polly
Sintassi della richiestaParametri della richiesta URICorpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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

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

Speciifica il motore (standard,neural, long-form orgenerative) utilizzato da Amazon Polly durante l'elaborazione del testo di input per la sintesi vocale.

Valori validi: standard | neural | long-form | generative

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 | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE | cs-CZ | de-CH

NextToken

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

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: stringa

Limitazioni 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

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: