Close httplib2 connections.
create(parent, body=None, x__xgafv=None)
Creates a custom voice from a natural-language prompt (`VOICE_TYPE_PROMPTED`) or from reference and consent audio recordings (`VOICE_TYPE_REPLICATED`).
Deletes a custom stored voice (`store = true`) by resource name. Prebuilt catalog voices (`"prebuilt"`) cannot be deleted.
Gets a custom stored voice (`store = true`) by resource name. Prebuilt catalog voices (`VOICE_TYPE_PREBUILT`) cannot be retrieved via `GetVoice`; use `ListVoices` instead.
Lists custom stored voices owned by the caller as well as prebuilt system voices from Google's voice catalog.
list_next(previous_request, previous_response)
Retrieves the next page of results.
close()
Close httplib2 connections.
create(parent, body=None, x__xgafv=None)
Creates a custom voice from a natural-language prompt (`VOICE_TYPE_PROMPTED`) or from reference and consent audio recordings (`VOICE_TYPE_REPLICATED`).
Args:
parent: string, Required. The parent resource where this voice will be created. Format: `projects/{project}/locations/{location}` Supported only by the Vertex API. (required)
body: object, The request body.
The object takes the form of:
{ # Request message for `VoicesService.CreateVoice`.
"store": True or False, # Optional. Whether the created voice is persisted and managed by Google. * When `true`, Google stores the voice and returns `Voice.id` (for example, `voice_abc123def456`), which can be managed via `GetVoice`, `ListVoices`, and `DeleteVoice` and referenced by ID in synthesis requests. Stored voices expire after 1 year of inactivity; using a stored voice in speech synthesis or as a `base_voice` in `CreateVoice` extends its `expire_time`. Projects are subject to a maximum active stored voice quota; exceeding the quota returns `RESOURCE_EXHAUSTED`. * When `false` (default), the voice is not stored by Google and `Voice.key` (for example, `voicekey_...`) is returned for client-side storage and synthesis. Optional discovery metadata fields on `voice` are not persisted or returned when `store` is `false`. * Required to be `true` when `voice.type` is `"prompted"` (otherwise fails with `INVALID_ARGUMENT`).
"voice": { # A voice resource representing either a custom voice (created via `CreateVoice`) or a prebuilt system voice (returned by `ListVoices`). # Required. The voice to create. `voice.model` is optional; if omitted, the service selects the default voice creation model. Output-only fields on `Voice` (`id`, `key`, `expire_time`, `usage`) are ignored if set.
"accent": "A String", # Optional. Regional accent descriptor (e.g. "American", "British").
"context": "A String", # Optional. Optimal usage context or domain (e.g. "Conversational", "Audiobook", "News").
"description": "A String", # Optional. Descriptive summary of vocal timbre, personality, and tone.
"displayName": "A String", # Optional. User-provided display name for a stored voice (`store = true`), or the catalog name for a prebuilt voice.
"expireTime": "A String", # Output only. The timestamp at which a custom stored voice (`store = true`) or replicated voice key (`store = false`) expires. For custom stored voices (`store = true`), this expiration time is extended when the voice is used for speech synthesis or as a `base_voice` in `CreateVoice`. Unset for prebuilt catalog voices (`"prebuilt"`), which do not expire.
"gender": "A String", # Optional. Perceived voice gender presentation (e.g. "female", "male", "neutral").
"id": "A String", # Output only. The unique identifier of the voice. * For Google-managed custom voices (`store = true`), this is a generated ID with prefix `voice_` (for example, `voice_abc123def456`). Pass `voices/{id}` as the `name` in `GetVoice` and `DeleteVoice`, and pass `{id}` directly to `SpeechConfig.voice_config.voice` (or `SpeechConfig.voice`) during speech synthesis. * For prebuilt catalog voices (`"prebuilt"` returned by `ListVoices`), this is the speaker name (for example, `Puck` or `Charon`). * Unset when `CreateVoice` is called with `store = false`.
"key": "A String", # Output only. The client-managed voice replication key (with prefix `voicekey_`). Returned only by `CreateVoice` when `type` is `"replicated"` and `store` is `false`. Pass this key to `SpeechConfig.voice_config.voice` (or `SpeechConfig.voice`) during speech synthesis.
"languageCode": "A String", # Optional. Primary BCP-47 language tag (e.g. "en-US", "fr-FR").
"model": "A String", # Optional. The model used to design or replicate the voice. If omitted in `CreateVoice`, defaults to the latest supported voice design model. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for custom voices (`"prompted"` and `"replicated"`); unset for `"prebuilt"` voices. Created voices can be synthesized across any supported TTS synthesis model.
"persona": "A String", # Optional. Intended persona or character archetype (e.g. "Warm, Friendly", "Narrator").
"pitch": "A String", # Optional. Voice pitch classification.
"prompted": { # Parameters for prompted voice generation. Required in `CreateVoice` when `type` is `"prompted"`. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for prompted voices. # Parameters for prompted voice generation. Required in `CreateVoice` when `type` is `"prompted"`. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for prompted voices.
"input": "A String", # Required. The natural-language prompt describing the desired voice, e.g. "A deep, booming male voice of a massive evil ogre in his middle years."
},
"regionCode": "A String", # Optional. ISO 3166-1 alpha-2 or UN M.49 geographic region code (e.g. "US", "GB", "001").
"replicated": { # Input only. Parameters for replicated voice generation. Required on input when `type` is `"replicated"`. Not returned in responses. # Input only. Parameters for replicated voice generation. Required on input when `type` is `"replicated"`. Not returned in responses.
"consentAudio": { # Audio payload used for voice creation. # Required. Audio recording of the same speaker reading the required consent phrase, confirming authorization to replicate the voice.
"data": "A String", # Required. The raw audio bytes.
"mimeType": "A String", # Required. The IANA MIME type of the audio data (for example, `audio/wav` or `audio/mpeg`).
},
"sourceAudio": { # Audio payload used for voice creation. # Required. The reference audio sample of the speaker's voice to replicate. Must be an unmodified recording of an adult human voice.
"data": "A String", # Required. The raw audio bytes.
"mimeType": "A String", # Required. The IANA MIME type of the audio data (for example, `audio/wav` or `audio/mpeg`).
},
},
"sampleAudio": { # Audio payload used for voice creation. # Output only. Sample audio (synthesizer prompt audio) generated for a prompted voice. Populated only in `CreateVoice` and `GetVoice` responses when `type` is `"prompted"`; unset in `ListVoices` responses and for `"replicated"` or `"prebuilt"` voices.
"data": "A String", # Required. The raw audio bytes.
"mimeType": "A String", # Required. The IANA MIME type of the audio data (for example, `audio/wav` or `audio/mpeg`).
},
"type": "A String", # Required. The type of the voice. In `CreateVoice`, must be `"replicated"` or `"prompted"`. In `ListVoices` responses, may also be `"prebuilt"`.
"usage": { # Statistics on the interaction request's token usage. # Output only. Token usage statistics for the voice creation request. Populated only in the response of `CreateVoice` when `type` is `"prompted"`; unset for `"replicated"` and in `GetVoice` and `ListVoices` responses.
"cachedTokensByModality": [ # A breakdown of cached token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"groundingToolCount": [ # Grounding tool count.
{ # The number of grounding tool counts.
"count": 42, # The number of grounding tool counts.
"type": "A String", # The grounding tool type associated with the count.
},
],
"inputTokensByModality": [ # A breakdown of input token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"outputTokensByModality": [ # A breakdown of output token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
"totalInputTokens": 42, # Number of tokens in the prompt (context).
"totalOutputTokens": 42, # Total number of tokens across all the generated responses.
"totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
"totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
"totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
},
},
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A voice resource representing either a custom voice (created via `CreateVoice`) or a prebuilt system voice (returned by `ListVoices`).
"accent": "A String", # Optional. Regional accent descriptor (e.g. "American", "British").
"context": "A String", # Optional. Optimal usage context or domain (e.g. "Conversational", "Audiobook", "News").
"description": "A String", # Optional. Descriptive summary of vocal timbre, personality, and tone.
"displayName": "A String", # Optional. User-provided display name for a stored voice (`store = true`), or the catalog name for a prebuilt voice.
"expireTime": "A String", # Output only. The timestamp at which a custom stored voice (`store = true`) or replicated voice key (`store = false`) expires. For custom stored voices (`store = true`), this expiration time is extended when the voice is used for speech synthesis or as a `base_voice` in `CreateVoice`. Unset for prebuilt catalog voices (`"prebuilt"`), which do not expire.
"gender": "A String", # Optional. Perceived voice gender presentation (e.g. "female", "male", "neutral").
"id": "A String", # Output only. The unique identifier of the voice. * For Google-managed custom voices (`store = true`), this is a generated ID with prefix `voice_` (for example, `voice_abc123def456`). Pass `voices/{id}` as the `name` in `GetVoice` and `DeleteVoice`, and pass `{id}` directly to `SpeechConfig.voice_config.voice` (or `SpeechConfig.voice`) during speech synthesis. * For prebuilt catalog voices (`"prebuilt"` returned by `ListVoices`), this is the speaker name (for example, `Puck` or `Charon`). * Unset when `CreateVoice` is called with `store = false`.
"key": "A String", # Output only. The client-managed voice replication key (with prefix `voicekey_`). Returned only by `CreateVoice` when `type` is `"replicated"` and `store` is `false`. Pass this key to `SpeechConfig.voice_config.voice` (or `SpeechConfig.voice`) during speech synthesis.
"languageCode": "A String", # Optional. Primary BCP-47 language tag (e.g. "en-US", "fr-FR").
"model": "A String", # Optional. The model used to design or replicate the voice. If omitted in `CreateVoice`, defaults to the latest supported voice design model. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for custom voices (`"prompted"` and `"replicated"`); unset for `"prebuilt"` voices. Created voices can be synthesized across any supported TTS synthesis model.
"persona": "A String", # Optional. Intended persona or character archetype (e.g. "Warm, Friendly", "Narrator").
"pitch": "A String", # Optional. Voice pitch classification.
"prompted": { # Parameters for prompted voice generation. Required in `CreateVoice` when `type` is `"prompted"`. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for prompted voices. # Parameters for prompted voice generation. Required in `CreateVoice` when `type` is `"prompted"`. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for prompted voices.
"input": "A String", # Required. The natural-language prompt describing the desired voice, e.g. "A deep, booming male voice of a massive evil ogre in his middle years."
},
"regionCode": "A String", # Optional. ISO 3166-1 alpha-2 or UN M.49 geographic region code (e.g. "US", "GB", "001").
"replicated": { # Input only. Parameters for replicated voice generation. Required on input when `type` is `"replicated"`. Not returned in responses. # Input only. Parameters for replicated voice generation. Required on input when `type` is `"replicated"`. Not returned in responses.
"consentAudio": { # Audio payload used for voice creation. # Required. Audio recording of the same speaker reading the required consent phrase, confirming authorization to replicate the voice.
"data": "A String", # Required. The raw audio bytes.
"mimeType": "A String", # Required. The IANA MIME type of the audio data (for example, `audio/wav` or `audio/mpeg`).
},
"sourceAudio": { # Audio payload used for voice creation. # Required. The reference audio sample of the speaker's voice to replicate. Must be an unmodified recording of an adult human voice.
"data": "A String", # Required. The raw audio bytes.
"mimeType": "A String", # Required. The IANA MIME type of the audio data (for example, `audio/wav` or `audio/mpeg`).
},
},
"sampleAudio": { # Audio payload used for voice creation. # Output only. Sample audio (synthesizer prompt audio) generated for a prompted voice. Populated only in `CreateVoice` and `GetVoice` responses when `type` is `"prompted"`; unset in `ListVoices` responses and for `"replicated"` or `"prebuilt"` voices.
"data": "A String", # Required. The raw audio bytes.
"mimeType": "A String", # Required. The IANA MIME type of the audio data (for example, `audio/wav` or `audio/mpeg`).
},
"type": "A String", # Required. The type of the voice. In `CreateVoice`, must be `"replicated"` or `"prompted"`. In `ListVoices` responses, may also be `"prebuilt"`.
"usage": { # Statistics on the interaction request's token usage. # Output only. Token usage statistics for the voice creation request. Populated only in the response of `CreateVoice` when `type` is `"prompted"`; unset for `"replicated"` and in `GetVoice` and `ListVoices` responses.
"cachedTokensByModality": [ # A breakdown of cached token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"groundingToolCount": [ # Grounding tool count.
{ # The number of grounding tool counts.
"count": 42, # The number of grounding tool counts.
"type": "A String", # The grounding tool type associated with the count.
},
],
"inputTokensByModality": [ # A breakdown of input token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"outputTokensByModality": [ # A breakdown of output token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
"totalInputTokens": 42, # Number of tokens in the prompt (context).
"totalOutputTokens": 42, # Total number of tokens across all the generated responses.
"totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
"totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
"totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
},
}
delete(name, x__xgafv=None)
Deletes a custom stored voice (`store = true`) by resource name. Prebuilt catalog voices (`"prebuilt"`) cannot be deleted.
Args:
name: string, Required. The resource name of the custom stored voice to delete (for example, `voices/voice_abc123def456`). (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for `VoicesService.DeleteVoice`.
}
get(name, x__xgafv=None)
Gets a custom stored voice (`store = true`) by resource name. Prebuilt catalog voices (`VOICE_TYPE_PREBUILT`) cannot be retrieved via `GetVoice`; use `ListVoices` instead.
Args:
name: string, Required. The resource name of the custom stored voice to retrieve (for example, `voices/voice_abc123def456`). (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A voice resource representing either a custom voice (created via `CreateVoice`) or a prebuilt system voice (returned by `ListVoices`).
"accent": "A String", # Optional. Regional accent descriptor (e.g. "American", "British").
"context": "A String", # Optional. Optimal usage context or domain (e.g. "Conversational", "Audiobook", "News").
"description": "A String", # Optional. Descriptive summary of vocal timbre, personality, and tone.
"displayName": "A String", # Optional. User-provided display name for a stored voice (`store = true`), or the catalog name for a prebuilt voice.
"expireTime": "A String", # Output only. The timestamp at which a custom stored voice (`store = true`) or replicated voice key (`store = false`) expires. For custom stored voices (`store = true`), this expiration time is extended when the voice is used for speech synthesis or as a `base_voice` in `CreateVoice`. Unset for prebuilt catalog voices (`"prebuilt"`), which do not expire.
"gender": "A String", # Optional. Perceived voice gender presentation (e.g. "female", "male", "neutral").
"id": "A String", # Output only. The unique identifier of the voice. * For Google-managed custom voices (`store = true`), this is a generated ID with prefix `voice_` (for example, `voice_abc123def456`). Pass `voices/{id}` as the `name` in `GetVoice` and `DeleteVoice`, and pass `{id}` directly to `SpeechConfig.voice_config.voice` (or `SpeechConfig.voice`) during speech synthesis. * For prebuilt catalog voices (`"prebuilt"` returned by `ListVoices`), this is the speaker name (for example, `Puck` or `Charon`). * Unset when `CreateVoice` is called with `store = false`.
"key": "A String", # Output only. The client-managed voice replication key (with prefix `voicekey_`). Returned only by `CreateVoice` when `type` is `"replicated"` and `store` is `false`. Pass this key to `SpeechConfig.voice_config.voice` (or `SpeechConfig.voice`) during speech synthesis.
"languageCode": "A String", # Optional. Primary BCP-47 language tag (e.g. "en-US", "fr-FR").
"model": "A String", # Optional. The model used to design or replicate the voice. If omitted in `CreateVoice`, defaults to the latest supported voice design model. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for custom voices (`"prompted"` and `"replicated"`); unset for `"prebuilt"` voices. Created voices can be synthesized across any supported TTS synthesis model.
"persona": "A String", # Optional. Intended persona or character archetype (e.g. "Warm, Friendly", "Narrator").
"pitch": "A String", # Optional. Voice pitch classification.
"prompted": { # Parameters for prompted voice generation. Required in `CreateVoice` when `type` is `"prompted"`. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for prompted voices. # Parameters for prompted voice generation. Required in `CreateVoice` when `type` is `"prompted"`. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for prompted voices.
"input": "A String", # Required. The natural-language prompt describing the desired voice, e.g. "A deep, booming male voice of a massive evil ogre in his middle years."
},
"regionCode": "A String", # Optional. ISO 3166-1 alpha-2 or UN M.49 geographic region code (e.g. "US", "GB", "001").
"replicated": { # Input only. Parameters for replicated voice generation. Required on input when `type` is `"replicated"`. Not returned in responses. # Input only. Parameters for replicated voice generation. Required on input when `type` is `"replicated"`. Not returned in responses.
"consentAudio": { # Audio payload used for voice creation. # Required. Audio recording of the same speaker reading the required consent phrase, confirming authorization to replicate the voice.
"data": "A String", # Required. The raw audio bytes.
"mimeType": "A String", # Required. The IANA MIME type of the audio data (for example, `audio/wav` or `audio/mpeg`).
},
"sourceAudio": { # Audio payload used for voice creation. # Required. The reference audio sample of the speaker's voice to replicate. Must be an unmodified recording of an adult human voice.
"data": "A String", # Required. The raw audio bytes.
"mimeType": "A String", # Required. The IANA MIME type of the audio data (for example, `audio/wav` or `audio/mpeg`).
},
},
"sampleAudio": { # Audio payload used for voice creation. # Output only. Sample audio (synthesizer prompt audio) generated for a prompted voice. Populated only in `CreateVoice` and `GetVoice` responses when `type` is `"prompted"`; unset in `ListVoices` responses and for `"replicated"` or `"prebuilt"` voices.
"data": "A String", # Required. The raw audio bytes.
"mimeType": "A String", # Required. The IANA MIME type of the audio data (for example, `audio/wav` or `audio/mpeg`).
},
"type": "A String", # Required. The type of the voice. In `CreateVoice`, must be `"replicated"` or `"prompted"`. In `ListVoices` responses, may also be `"prebuilt"`.
"usage": { # Statistics on the interaction request's token usage. # Output only. Token usage statistics for the voice creation request. Populated only in the response of `CreateVoice` when `type` is `"prompted"`; unset for `"replicated"` and in `GetVoice` and `ListVoices` responses.
"cachedTokensByModality": [ # A breakdown of cached token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"groundingToolCount": [ # Grounding tool count.
{ # The number of grounding tool counts.
"count": 42, # The number of grounding tool counts.
"type": "A String", # The grounding tool type associated with the count.
},
],
"inputTokensByModality": [ # A breakdown of input token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"outputTokensByModality": [ # A breakdown of output token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
"totalInputTokens": 42, # Number of tokens in the prompt (context).
"totalOutputTokens": 42, # Total number of tokens across all the generated responses.
"totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
"totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
"totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
},
}
list(parent, accent=None, context=None, gender=None, languageCode=None, pageSize=None, pageToken=None, persona=None, pitch=None, regionCode=None, search=None, type=None, x__xgafv=None)
Lists custom stored voices owned by the caller as well as prebuilt system voices from Google's voice catalog.
Args:
parent: string, Required. The parent that owns this collection of voices. Format: `projects/{project}/locations/{location}` Supported only by the Vertex API. (required)
accent: string, Optional. Filter by accent description (e.g. "American", "British"). Case-insensitive exact match. If multiple values are specified, matches voices with any of the specified accents (OR). (repeated)
context: string, Optional. Filter by intended context or domain (e.g. "News, Commercial"). Case-insensitive exact match. If multiple values are specified, matches voices with any of the specified contexts (OR). (repeated)
gender: string, Optional. Filter by gender presentation (e.g. "female", "male", "neutral"). Case-insensitive exact match. If multiple values are specified, matches voices with any of the specified genders (OR). (repeated)
languageCode: string, Optional. Filter by BCP-47 language code (e.g. "en-US"). Case-insensitive exact match. If multiple values are specified, matches voices with any of the specified language codes (OR). (repeated)
pageSize: integer, Optional. The maximum number of voices to return per page. The service may return fewer than this value. If unspecified, at most 50 voices are returned. The maximum value is 1000; values above 1000 are coerced to 1000.
pageToken: string, A page token, received from a previous `ListVoices` call. Provide this to retrieve the subsequent page. When paginating, all filter query parameters (`language_code`, `region_code`, `accent`, `persona`, `context`, `gender`, `pitch`, `type`, and `search`) must match the call that returned this token; otherwise the request fails with `INVALID_ARGUMENT`. `page_size` may change between pages.
persona: string, Optional. Filter by vocal persona (e.g. "Warm, Friendly"). Case-insensitive exact match. If multiple values are specified, matches voices with any of the specified personas (OR). (repeated)
pitch: string, Optional. Filter by vocal pitch. Accepts `"low"`, `"medium"`, `"high"` (case-insensitive). If multiple values are specified, matches voices with any of the specified pitches (OR). (repeated)
regionCode: string, Optional. Filter by ISO 3166-1 alpha-2 or UN M.49 region code (e.g. "US", "001"). Case-insensitive exact match. If multiple values are specified, matches voices with any of the specified region codes (OR). (repeated)
search: string, Optional. Free-text substring search query matched case-insensitively against both `display_name` and `description`. Maximum 2048 bytes.
type: string, Optional. Filter by voice type. Accepts `"prebuilt"`, `"replicated"`, `"prompted"` (case-insensitive). If multiple values are specified, matches voices with any of the specified types (OR). (repeated)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for `VoicesService.ListVoices`.
"nextPageToken": "A String", # A token that can be sent as `page_token` to retrieve the next page. If empty, there are no subsequent pages.
"voices": [ # The voices from the specified collection.
{ # A voice resource representing either a custom voice (created via `CreateVoice`) or a prebuilt system voice (returned by `ListVoices`).
"accent": "A String", # Optional. Regional accent descriptor (e.g. "American", "British").
"context": "A String", # Optional. Optimal usage context or domain (e.g. "Conversational", "Audiobook", "News").
"description": "A String", # Optional. Descriptive summary of vocal timbre, personality, and tone.
"displayName": "A String", # Optional. User-provided display name for a stored voice (`store = true`), or the catalog name for a prebuilt voice.
"expireTime": "A String", # Output only. The timestamp at which a custom stored voice (`store = true`) or replicated voice key (`store = false`) expires. For custom stored voices (`store = true`), this expiration time is extended when the voice is used for speech synthesis or as a `base_voice` in `CreateVoice`. Unset for prebuilt catalog voices (`"prebuilt"`), which do not expire.
"gender": "A String", # Optional. Perceived voice gender presentation (e.g. "female", "male", "neutral").
"id": "A String", # Output only. The unique identifier of the voice. * For Google-managed custom voices (`store = true`), this is a generated ID with prefix `voice_` (for example, `voice_abc123def456`). Pass `voices/{id}` as the `name` in `GetVoice` and `DeleteVoice`, and pass `{id}` directly to `SpeechConfig.voice_config.voice` (or `SpeechConfig.voice`) during speech synthesis. * For prebuilt catalog voices (`"prebuilt"` returned by `ListVoices`), this is the speaker name (for example, `Puck` or `Charon`). * Unset when `CreateVoice` is called with `store = false`.
"key": "A String", # Output only. The client-managed voice replication key (with prefix `voicekey_`). Returned only by `CreateVoice` when `type` is `"replicated"` and `store` is `false`. Pass this key to `SpeechConfig.voice_config.voice` (or `SpeechConfig.voice`) during speech synthesis.
"languageCode": "A String", # Optional. Primary BCP-47 language tag (e.g. "en-US", "fr-FR").
"model": "A String", # Optional. The model used to design or replicate the voice. If omitted in `CreateVoice`, defaults to the latest supported voice design model. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for custom voices (`"prompted"` and `"replicated"`); unset for `"prebuilt"` voices. Created voices can be synthesized across any supported TTS synthesis model.
"persona": "A String", # Optional. Intended persona or character archetype (e.g. "Warm, Friendly", "Narrator").
"pitch": "A String", # Optional. Voice pitch classification.
"prompted": { # Parameters for prompted voice generation. Required in `CreateVoice` when `type` is `"prompted"`. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for prompted voices. # Parameters for prompted voice generation. Required in `CreateVoice` when `type` is `"prompted"`. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for prompted voices.
"input": "A String", # Required. The natural-language prompt describing the desired voice, e.g. "A deep, booming male voice of a massive evil ogre in his middle years."
},
"regionCode": "A String", # Optional. ISO 3166-1 alpha-2 or UN M.49 geographic region code (e.g. "US", "GB", "001").
"replicated": { # Input only. Parameters for replicated voice generation. Required on input when `type` is `"replicated"`. Not returned in responses. # Input only. Parameters for replicated voice generation. Required on input when `type` is `"replicated"`. Not returned in responses.
"consentAudio": { # Audio payload used for voice creation. # Required. Audio recording of the same speaker reading the required consent phrase, confirming authorization to replicate the voice.
"data": "A String", # Required. The raw audio bytes.
"mimeType": "A String", # Required. The IANA MIME type of the audio data (for example, `audio/wav` or `audio/mpeg`).
},
"sourceAudio": { # Audio payload used for voice creation. # Required. The reference audio sample of the speaker's voice to replicate. Must be an unmodified recording of an adult human voice.
"data": "A String", # Required. The raw audio bytes.
"mimeType": "A String", # Required. The IANA MIME type of the audio data (for example, `audio/wav` or `audio/mpeg`).
},
},
"sampleAudio": { # Audio payload used for voice creation. # Output only. Sample audio (synthesizer prompt audio) generated for a prompted voice. Populated only in `CreateVoice` and `GetVoice` responses when `type` is `"prompted"`; unset in `ListVoices` responses and for `"replicated"` or `"prebuilt"` voices.
"data": "A String", # Required. The raw audio bytes.
"mimeType": "A String", # Required. The IANA MIME type of the audio data (for example, `audio/wav` or `audio/mpeg`).
},
"type": "A String", # Required. The type of the voice. In `CreateVoice`, must be `"replicated"` or `"prompted"`. In `ListVoices` responses, may also be `"prebuilt"`.
"usage": { # Statistics on the interaction request's token usage. # Output only. Token usage statistics for the voice creation request. Populated only in the response of `CreateVoice` when `type` is `"prompted"`; unset for `"replicated"` and in `GetVoice` and `ListVoices` responses.
"cachedTokensByModality": [ # A breakdown of cached token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"groundingToolCount": [ # Grounding tool count.
{ # The number of grounding tool counts.
"count": 42, # The number of grounding tool counts.
"type": "A String", # The grounding tool type associated with the count.
},
],
"inputTokensByModality": [ # A breakdown of input token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"outputTokensByModality": [ # A breakdown of output token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
{ # The token count for a single response modality.
"modality": "A String", # The modality associated with the token count.
"tokens": 42, # Number of tokens for the modality.
},
],
"totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
"totalInputTokens": 42, # Number of tokens in the prompt (context).
"totalOutputTokens": 42, # Total number of tokens across all the generated responses.
"totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
"totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
"totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
},
},
],
}
list_next(previous_request, previous_response)
Retrieves the next page of results. Args: previous_request: The request for the previous page. (required) previous_response: The response from the request for the previous page. (required) Returns: A request object that you can call 'execute()' on to request the next page. Returns None if there are no more items in the collection.