# Set generation mode

- **Method:** `PUT`
- **Path:** `/api/v1/settings/generation-mode`
- **Operation ID:** `set_generation_mode_setting_api_v1_settings_generation_mode_put`
- **Tags:** Settings

Switch generation mode. Validates mode is supported by active model.

## Effective servers

- `http://127.0.0.1:8100`

  Voice Creator Pro on this computer

## Query parameters

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

  Mode: 'clone', 'design', 'tts', or 'stt'

## Responses

### 200 Successful Response

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

schema: `SetModeResponse`

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

  Whether the mode was actually changed
- **`success` (required)**: `boolean`

  Whether the operation succeeded
- **`message`**: `string | null`

  Optional status message
- **`needs_reload`**: `boolean`, default: `false`

  Whether the TTS model needs to be reloaded for the new mode

**Example:**

```json
{
  "success": true,
  "changed": true,
  "needs_reload": false,
  "message": ""
}
```

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