# Get active model capabilities

- **Method:** `GET`
- **Path:** `/api/v1/models/active`
- **Operation ID:** `get_active_model_api_v1_models_active_get`
- **Tags:** Model

Get the active TTS model's capabilities.

## Effective servers

- `http://127.0.0.1:8100`

  Voice Creator Pro on this computer

## Query parameters

- **`mode`**: `string | null`

  Generation mode to resolve the per-mode model preference for

## Responses

### 200 Successful Response

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

schema: `ModelCapabilitiesResponse`

- **`custom_voice_speakers` (required)**: `array of string`

  Available predefined speakers
- **`display_name` (required)**: `string`

  Human-readable model name
- **`generation_params` (required)**: `array of object`

  Available generation parameters with ranges
- **`model_family` (required)**: `string`

  Model family identifier
- **`sample_rate` (required)**: `integer`

  Output audio sample rate in Hz
- **`supports_clone` (required)**: `boolean`

  Whether the model supports voice cloning
- **`supports_custom_voice` (required)**: `boolean`

  Whether the model supports custom voice speakers
- **`supports_design` (required)**: `boolean`

  Whether the model supports voice design
- **`supports_streaming` (required)**: `boolean`

  Whether the model supports streaming generation
- **`variants` (required)**: `array of object`

  Available model variants/quality tiers
- **`design_takes_target_text`**: `boolean`, default: `true`

  False when design mode has no text to speak (the model writes the words)
- **`loading`**: `boolean | null`

  True when switching started a background model load
- **`ref_max_sec`**: `number`, default: `10`

  Longest reference audio the model uses, in seconds
- **`ref_min_sec`**: `number`, default: `1.5`

  Shortest reference audio the model accepts, in seconds
- **`ref_min_speech_sec`**: `number`, default: `3`

  Least speech the reference must contain, in seconds
- **`studio_only`**: `boolean`, default: `false`

  True if the model is only offered in the Studio audiobook tools
- **`supports_design_reference`**: `boolean`, default: `false`

  Whether voice design can be conditioned on a saved reference voice
- **`supports_emotional_clone`**: `boolean`, default: `false`

  Whether the model can clone with an emotion and intensity

**Example:**

```json
{
  "model_family": "",
  "display_name": "",
  "supports_clone": true,
  "supports_design": true,
  "supports_custom_voice": true,
  "supports_streaming": true,
  "supports_emotional_clone": false,
  "supports_design_reference": false,
  "design_takes_target_text": true,
  "sample_rate": 1,
  "ref_min_sec": 1.5,
  "ref_min_speech_sec": 3,
  "ref_max_sec": 10,
  "custom_voice_speakers": [
    ""
  ],
  "generation_params": [
    {
      "additionalProperty": "anything"
    }
  ],
  "variants": [
    {
      "additionalProperty": "anything"
    }
  ],
  "studio_only": false,
  "loading": true
}
```

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