# Get ASR models

- **Method:** `GET`
- **Path:** `/api/v1/settings/asr-model`
- **Operation ID:** `get_asr_models_setting_api_v1_settings_asr_model_get`
- **Tags:** Settings

Return all selectable ASR models. Empty options list on macOS (single MLX build).

## Effective servers

- `http://127.0.0.1:8100`

  Voice Creator Pro on this computer

## Responses

### 200 Successful Response

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

schema: `AsrModelsGetResponse`

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

  ID of the currently selected model
- **`options` (required)**: `array`

  Available ASR models

  **Items:**

  schema: `AsrModelOption`
  - **`description` (required)**: `string`

    Short description
  - **`family` (required)**: `string`

    Model family (e.g. 'Qwen3-ASR', 'Parakeet v3', 'Orukeet')
  - **`id` (required)**: `string`

    Model ID
  - **`languages` (required)**: `array of string`

    Supported transcription languages
  - **`name` (required)**: `string`

    Display name
  - **`selected` (required)**: `boolean`

    Whether this model is currently active
  - **`vram_mb` (required)**: `integer`

    Approximate VRAM requirement in MB

**Example:**

```json
{
  "options": [
    {
      "id": "",
      "name": "",
      "description": "",
      "family": "",
      "vram_mb": 1,
      "languages": [
        ""
      ],
      "selected": true
    }
  ],
  "current": ""
}
```

## Schemas

- `AsrModelOption` — shown above.
- `AsrModelsGetResponse` — shown above.