DescribeVoices - Amazon Polly
Syntaxe de la demandeParamètres de demande URICorps de la requêteSyntaxe de la réponseEléments de réponseErreursconsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

DescribeVoices

Renvoie la liste des voix pouvant être utilisées lorsque vous demandez la synthèse vocale. Chaque voix parle une langue spécifiée, qu'elle soit masculine ou féminine, et est identifiée par un identifiant, qui est la version ASCII du nom de la voix.

Lors de la synthèse vocale (SynthesizeSpeech), vous fournissez l'identifiant vocal de la voix que vous souhaitez dans la liste des voix renvoyées parDescribeVoices.

Par exemple, vous souhaitez que votre application de lecture d'actualités lise les actualités dans une langue spécifique, tout en laissant à l'utilisateur la possibilité de choisir la voix. À l'aide de cette DescribeVoices opération, vous pouvez fournir à l'utilisateur une liste de voix disponibles parmi lesquelles sélectionner.

Si vous le souhaitez, vous pouvez spécifier un code de langue pour filtrer les voix disponibles. Par exemple, si vous le spécifiezen-US, l'opération renvoie une liste de toutes les voix disponibles en anglais américain.

Cette opération exige des autorisations pour exécuter l'action polly:DescribeVoices.

Syntaxe de la demande

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

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

Engine

Spécifie le moteur (standard,neural, long-form ougenerative) utilisé par Amazon Polly lors du traitement du texte d'entrée pour la synthèse vocale.

Valeurs valides : standard | neural | long-form | generative

IncludeAdditionalLanguageCodes

Valeur booléenne indiquant s'il faut renvoyer des voix bilingues utilisant la langue spécifiée comme langue supplémentaire. Par exemple, si vous demandez toutes les langues utilisant l'anglais américain (es-US) et qu'une voix italienne parle à la fois l'italien (it-it) et l'anglais américain, cette voix sera incluse si vous le spécifiez yes mais pas si vous le spécifiez. no

LanguageCode

La balise d'identification de langue (code ISO 639 pour le nom de langue, code de pays ISO 3166) permettant de filtrer la liste des voix renvoyées. Si vous ne spécifiez pas ce paramètre facultatif, toutes les voix disponibles sont renvoyées.

Valeurs valides : 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 jeton de pagination opaque renvoyé par l'DescribeVoicesopération précédente. Le cas échéant, cela indique où continuer la liste.

Contraintes de longueur : longueur minimum de 0. Longueur maximum de 4096.

Corps de la requête

La demande n’a pas de corps de requête.

Syntaxe de la réponse

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

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

NextToken

Le jeton de pagination à utiliser dans la prochaine demande pour continuer la liste des voix. NextTokenn'est renvoyé que si la réponse est tronquée.

Type : chaîne

Contraintes de longueur : longueur minimum de 0. Longueur maximum de 4096.

Voices

Une liste de voix avec leurs propriétés.

Type : tableau d’objets Voice

Erreurs

InvalidNextTokenException

Le NextToken n'est pas valide. Vérifiez qu'il est correctement orthographié, puis réessayez.

Code d’état HTTP : 400

ServiceFailureException

Une situation inconnue a provoqué une panne de service.

Code d’état HTTP : 500

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :