> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Пресеты

> Управляйте повторно используемыми конфигурациями рендера

Пресет — это повторно используемая конфигурация рендера (фон, стиль субтитров, компоновка и другие визуальные настройки), которую можно применить к любому проекту или экспорту. Пресеты идеально подходят, когда вам нужен единый визуальный стиль для множества треков.

См. [Справочник настроек рендера](/en/render-settings-reference), чтобы узнать полную
форму `preset` и все варианты, поддерживаемые перечислениями (enum).

## `preset schema`

Вернуть JSON Schema для настроек пресета. Используйте это, чтобы узнать допустимые поля перед созданием или обновлением пресета.

```bash theme={null}
youka preset schema --json
```

<Tip>
  Агентам следует вызывать `preset schema` перед изменением пресетов, чтобы знать
  точные имена полей и типы значений.
</Tip>

## `preset list`

Показать все пресеты, принадлежащие аутентифицированной учетной записи.

```bash theme={null}
youka preset list --json
```

## `preset show`

Получить один пресет по ID.

```bash theme={null}
youka preset show <presetId> --json
```

## `preset create`

Создать новый пресет.

```bash theme={null}
youka preset create [options]
```

### Опции

| Option             | Description                                      |
| ------------------ | ------------------------------------------------ |
| `--name <name>`    | Название пресета                                 |
| `--default`        | Сделать новый пресет пресетом по умолчанию       |
| `--body <file\|->` | Прочитать полное тело запроса из файла или stdin |

<Note>
  Тело запроса должно содержать полный объект `preset`. Для больших payload’ов
  предпочитайте `--body` вместо inline JSON.
</Note>

### Примеры

<CodeGroup>
  ```bash from-file theme={null}
  youka preset create \
    --name "Neon Night" \
    --body ./neon-preset.json \
    --json
  ```

  ```bash make-default theme={null}
  youka preset create \
    --name "Red Cinema" \
    --body ./red-cinema.json \
    --default \
    --json
  ```

  ```bash from-stdin theme={null}
  cat ./preset.json | youka preset create --name "From stdin" --body - --json
  ```
</CodeGroup>

Флаги CLI переопределяют соответствующие поля из `--body`.

## `preset update`

Обновить существующий пресет.

```bash theme={null}
youka preset update <presetId> [options]
```

| Option             | Description                            |
| ------------------ | -------------------------------------- |
| `--name <name>`    | Новое название                         |
| `--body <file\|->` | Полное тело запроса из файла или stdin |

Пример:

```bash theme={null}
youka preset update $PRESET_ID \
  --name "Neon Night v2" \
  --body ./neon-v2.json \
  --json
```

## `preset delete`

Удалить пресет по ID.

```bash theme={null}
youka preset delete <presetId> --json
```

<Warning>
  Удаление пресета не удаляет проекты или экспорты, которые ранее были
  отрендерены с ним. Будущие экспорты, которые ссылаются на удаленный пресет, завершатся ошибкой.
</Warning>

## `preset default`

Получить или установить пресет по умолчанию.

```bash theme={null}
youka preset default --json
youka preset default <presetId> --json
```

Без аргумента команда возвращает текущий пресет по умолчанию или `null`. С ID пресета она помечает этот пресет как используемый по умолчанию.

## Применение пресета

Примените пресет к проекту или экспорту с помощью `--preset`:

<CodeGroup>
  ```bash on-create theme={null}
  youka project create ./song.mp3 --preset $PRESET_ID --wait
  ```

  ```bash on-settings-update theme={null}
  youka project settings $PROJECT_ID --preset $PRESET_ID
  ```

  ```bash on-export theme={null}
  youka export create $PROJECT_ID --preset $PRESET_ID --wait
  ```
</CodeGroup>

## Что дальше

* [Справочник настроек рендера](/en/render-settings-reference) - все общие поля пресетов
* [Проекты](/ru/cli/projects) - применяйте пресеты к настройкам проекта
* [Экспорты](/ru/cli/exports) - применяйте пресеты во время рендера
* [Медиа](/ru/cli/media) - повторно используемые медиа, на которые ссылаются пресеты