The Voice object

A voice is returned by List voices and Get a voice. The developer-relevant fields are below. Timestamps are Unix epoch milliseconds.

string

Unique voice id (24-character hex). Use it with the synthesize endpoints.

string

Display name.

string

Optional long-form description.

string

Whether the voice is usable. Only ready voices can synthesize. A voice still being created reports processing (and failed if creation didn’t succeed). See Working with voices.

string

How the voice was created: instant, professional, design, or remix.

string

private, org, or public.

string

Default language (BCP-47, e.g. en). Used when a synthesis request omits language.

object[]

Searchable key/value tags, e.g. { "key": "accent", "value": "american" }. Common keys: accent, gender, age, use_case.

object

Optional synthesis defaults for the voice (stability, similarity, style, speed, pitch, volume, use_speaker_boost, emotion, engine_params). Present only when configured.

string

Public URL of a short preview clip, when available.

string

Present when the voice was saved/derived from another voice (clone_method: remix).

integer

Creation time (Unix epoch milliseconds).

integer

Last update time (Unix epoch milliseconds).

Example

{
  "id": "665f1a2b3c4d5e6f7a8b9c0d",
  "name": "Studio Narrator",
  "description": "Warm, neutral narration voice.",
  "status": "ready",
  "clone_method": "instant",
  "visibility": "public",
  "primary_language": "en",
  "labels": [
    { "key": "accent", "value": "american" },
    { "key": "gender", "value": "female" }
  ],
  "sample_audio_url": "https://storage.googleapis.com/.../sample.wav",
  "created_at": 1717939200000,
  "updated_at": 1717939260000
}

Endpoints

Reference

The Voice object