# Load voice by ID

- **Method:** `GET`
- **Path:** `/api/v1/voices/{voice_id}`
- **Operation ID:** `load_voice_api_v1_voices__voice_id__get`
- **Tags:** Voices

Return a saved voice's audio, transcript, and metadata by ID.

## Effective servers

- `http://127.0.0.1:8100`

  Voice Creator Pro on this computer

## Path parameters

- **`voice_id` (required)**: `string`

## Responses

### 200 Successful Response

**Content type:** `application/json`

schema: `VoiceLoadResponse`

- **`success` (required)**: `boolean`

  Whether the voice was loaded successfully
- **`align_status`**: `string | null`, possible values: `"done", "no_speech", "failed"`

  Outcome of the last alignment of this voice's current audio, or null if it has not been aligned
- **`audio_base64`**: `string | null`

  Base64-encoded reference audio (WAV)
- **`has_voice_clone_prompt`**: `boolean | null`

  Whether a precomputed voice prompt cache exists
- **`message`**: `string | null`

  Error message if load failed
- **`name`**: `string | null`

  Voice display name
- **`ref_text`**: `string | null`

  The actual spoken text in the reference audio. Set for design voices; empty string for clone voices.
- **`source`**: `object | null`, schema: `VoiceSourceModel`

  Where the audio was cut from, when it came from a public sample
  - **`end` (required)**: `number`, exclusiveMinimum: `0`

    End of the saved audio within the sample, in seconds
  - **`start` (required)**: `number`, minimum: `0`

    Start of the saved audio within the sample, in seconds
  - **`task_id` (required)**: `string`

    Id of the public sample the audio was cut from
- **`transcript`**: `string | null`

  Transcript of the reference audio. For design voices this is the natural-language voice description, not the spoken text.
- **`transcript_manual`**: `boolean | null`

  True if the transcript was written or corrected by the user
- **`voice_type`**: `string | null`

  'clone' or 'design'
- **`word_timestamps`**: `(array of object) | null`

  Word-level timestamps \[{text,start\_time,end\_time}] if persisted

**Example:**

```json
{
  "success": true,
  "audio_base64": "",
  "transcript": "",
  "ref_text": "",
  "name": "",
  "voice_type": "",
  "has_voice_clone_prompt": true,
  "word_timestamps": [
    {
      "additionalProperty": "anything"
    }
  ],
  "transcript_manual": true,
  "align_status": "done",
  "source": {
    "task_id": "",
    "start": 0,
    "end": 1
  },
  "message": ""
}
```

### 400 Invalid voice ID format.

### 404 Voice not found.

### 422 Validation Error

**Content type:** `application/json`

schema: `HTTPValidationError`

- **`detail`**: `array`

  **Items:**

  schema: `ValidationError`
  - **`loc` (required)**: `array of (string | integer)`
  - **`msg` (required)**: `string`
  - **`type` (required)**: `string`
  - **`ctx`**: `object`
  - **`input`**: `any`

**Example:**

```json
{
  "detail": [
    {
      "loc": [
        ""
      ],
      "msg": "",
      "type": "",
      "input": null,
      "ctx": {}
    }
  ]
}
```

## Schemas

- `HTTPValidationError` — shown above.
- `ValidationError` — shown above.
- `VoiceLoadResponse` — shown above.
- `VoiceSourceModel` — shown above.