Method: voices.list
Stay organized with collections
Save and categorize content based on your preferences.
Returns a list of Voice supported for synthesis.
HTTP request
GET https://texttospeech.googleapis.com/v1beta1/voices
The URL uses gRPC Transcoding syntax.
Query parameters
Parameters |
languageCode |
string
Optional. Recommended. BCP-47 language tag. If not specified, the API will return all supported voices. If specified, the voices.list call will only return voices that can be used to synthesize this languageCode. For example, if you specify "en-NZ" , all "en-NZ" voices will be returned. If you specify "no" , both "no-\*" (Norwegian) and "nb-\*" (Norwegian Bokmal) voices will be returned.
|
Request body
The request body must be empty.
Response body
The message returned to the client by the voices.list
method.
If successful, the response body contains data with the following structure:
JSON representation |
{
"voices": [
{
object (Voice )
}
]
} |
Fields |
voices[] |
object (Voice )
The list of voices.
|
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
Voice
Description of a voice supported by the TTS service.
JSON representation |
{
"languageCodes": [
string
],
"name": string,
"ssmlGender": enum (SsmlVoiceGender ),
"naturalSampleRateHertz": integer
} |
Fields |
languageCodes[] |
string
The languages that this voice supports, expressed as BCP-47 language tags (e.g. "en-US", "es-419", "cmn-tw").
|
name |
string
The name of this voice. Each distinct voice has a unique name.
|
ssmlGender |
enum (SsmlVoiceGender )
The gender of this voice.
|
naturalSampleRateHertz |
integer
The natural sample rate (in hertz) for this voice.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-06-27 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[],[],null,["# Method: voices.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListVoicesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Voice](#Voice)\n - [JSON representation](#Voice.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nReturns a list of Voice supported for synthesis.\n\n### HTTP request\n\n`GET https://texttospeech.googleapis.com/v1beta1/voices`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe message returned to the client by the `voices.list` method.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\nVoice\n-----\n\nDescription of a voice supported by the TTS service."]]