# List built-in speakers

- **Method:** `GET`
- **Path:** `/api/v1/tts/speakers`
- **Operation ID:** `tts_speakers_api_v1_tts_speakers_get`
- **Tags:** TTS

Return the list of built-in TTS speaker IDs, names, and descriptions.

When `model_family` is supplied and valid, returns speakers belonging
to that specific model — needed so audiobook callers can list voices
compatible with a per-span model override, not just the globally
active model.

## Effective servers

- `http://127.0.0.1:8100`

  Voice Creator Pro on this computer

## Query parameters

- **`model_family`**: `string | null`

  Optional model family. Defaults to the active model (with fallback to any model that publishes built-in speakers).

## Responses

### 200 Successful Response

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

schema: `SpeakersResponse`

- **`speakers` (required)**: `array`

  Available built-in TTS speakers

  **Items:**

  schema: `Speaker`
  - **`id` (required)**: `string`

    Speaker identifier (e.g. 'Ryan', 'Vivian')
  - **`name` (required)**: `string`

    Display name
  - **`description`**: `string | null`

    Voice description (e.g. 'Male, American English')
  - **`language`**: `string | null`

    Native language of the speaker

**Example:**

```json
{
  "speakers": [
    {
      "id": "Vivian",
      "name": "Vivian",
      "description": "Female, American English",
      "language": "English"
    }
  ]
}
```

### 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.
- `Speaker` — shown above.
- `SpeakersResponse` — shown above.
- `ValidationError` — shown above.