DescribeVoices - Amazon Polly
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

DescribeVoices

Devuelve la lista de voces que están disponibles para su uso cuando se solicita la síntesis de voz. Cada voz habla un idioma específico, es masculina o femenina, y se identifica mediante un identificador, que es la versión ASCII del nombre de la voz.

Al sintetizar la locución (SynthesizeSpeech), debe proporcionar el identificador de voz de la voz que desee de la lista de voces devueltas por DescribeVoices.

Por ejemplo, quiere que su aplicación lectora de noticias lea las noticias en un idioma específico, pero que dé al usuario la opción de elegir la voz. Con la operación DescribeVoices, puede proporcionar al usuario una lista de las voces disponibles entre las que elegir.

También puede especificar un código de idioma para filtrar las voces disponibles. Por ejemplo, si especifica en-US, la operación devuelve una lista de todas las voces disponibles para el idioma inglés de EE. UU.

Esto operación requiere permisos para realizar la acción polly:DescribeVoices.

Sintaxis de la solicitud

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

Parámetros de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

Engine

Especifica el motor (standard,neural, long-form ogenerative) que utiliza Amazon Polly al procesar el texto de entrada para la síntesis de voz.

Valores válidos: standard | neural | long-form | generative

IncludeAdditionalLanguageCodes

Valor booleano que indica si se deben devolver voces bilingües que utilicen el idioma especificado como idioma adicional. Por ejemplo, si solicita todos los idiomas que utilizan el inglés estadounidense (en-US) y hay una voz italiana que habla tanto italiano (it-IT) como inglés estadounidense, esa voz se incluirá si especifica yes, pero no si especifica no.

LanguageCode

La etiqueta de identificación del idioma (código ISO 639 para el nombre del idioma y código de país ISO 3166) para filtrar la lista de voces devueltas. Si no especifica este parámetro opcional, se devolverán todas las voces disponibles.

Valores válidos: 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

NextToken

Un token de paginación opaco devuelto por la operación DescribeVoices anterior. Si está presente, indica dónde continuar con el anuncio.

Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 4 096 caracteres.

Cuerpo de la solicitud

La solicitud no tiene un cuerpo de la solicitud.

Sintaxis de la respuesta

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" ]
      }
   ]
}

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

NextToken

El token de paginación que se utilizará en la próxima solicitud para continuar con la lista de voces. Se devuelve NextToken solo si la respuesta está truncada.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 4 096 caracteres.

Voices

Una lista de voces con sus propiedades.

Tipo: matriz de objetos Voice

Errores

InvalidNextTokenException

El no NextToken es válido. Asegúrese de que esté bien escrito y, a continuación, vuelva a intentarlo.

Código de estado HTTP: 400

ServiceFailureException

Una condición desconocida ha provocado un fallo en el servicio.

Código de estado HTTP: 500

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente: