> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finesse.flamapp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# The Voice object

> Fields returned for a voice.

A voice is returned by [List voices](/voice-api/list-voices) and [Get a voice](/voice-api/get-voice).
The developer-relevant fields are below. Timestamps are Unix epoch **milliseconds**.

<ResponseField name="id" type="string">
  Unique voice id (24-character hex). Use it with the synthesize endpoints.
</ResponseField>

<ResponseField name="name" type="string">
  Display name.
</ResponseField>

<ResponseField name="description" type="string">
  Optional long-form description.
</ResponseField>

<ResponseField name="status" type="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](/concepts/voices).
</ResponseField>

<ResponseField name="clone_method" type="string">
  How the voice was created: `instant`, `professional`, `design`, or `remix`.
</ResponseField>

<ResponseField name="visibility" type="string">
  `private`, `org`, or `public`.
</ResponseField>

<ResponseField name="primary_language" type="string">
  Default language (BCP-47, e.g. `en`). Used when a synthesis request omits `language`.
</ResponseField>

<ResponseField name="labels" type="object[]">
  Searchable key/value tags, e.g. `{ "key": "accent", "value": "american" }`. Common keys: `accent`,
  `gender`, `age`, `use_case`.
</ResponseField>

<ResponseField name="settings" type="object">
  Optional synthesis defaults for the voice (`stability`, `similarity`, `style`, `speed`, `pitch`,
  `volume`, `use_speaker_boost`, `emotion`, `engine_params`). Present only when configured.
</ResponseField>

<ResponseField name="sample_audio_url" type="string">
  Public URL of a short preview clip, when available.
</ResponseField>

<ResponseField name="base_voice_id" type="string">
  Present when the voice was saved/derived from another voice (`clone_method: remix`).
</ResponseField>

<ResponseField name="created_at" type="integer">
  Creation time (Unix epoch milliseconds).
</ResponseField>

<ResponseField name="updated_at" type="integer">
  Last update time (Unix epoch milliseconds).
</ResponseField>

```json Example theme={null}
{
  "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
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.