> ## 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.

# Экспорты

> Рендерите и скачивайте караоке-экспорты в облаке или на локальной машине

Экспорт — это отрендеренный артефакт, полученный из проекта. По умолчанию экспорты выполняются в облаке. Передайте `--local`, чтобы рендерить на своей машине с использованием локального пайплайна Remotion.

## `export create`

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

```bash theme={null}
youka export create <projectId> [options]
```

<ParamField path="projectId" type="string" required>
  Проект, для которого выполняется экспорт.
</ParamField>

### Опции

| Option                  | Description                                                        |
| ----------------------- | ------------------------------------------------------------------ |
| `--resolution <value>`  | `480p`, `720p`, `1080p` или `4k`                                   |
| `--quality <value>`     | `low`, `medium` или `high`                                         |
| `--speed <number>`      | Множитель скорости воспроизведения                                 |
| `--tone <number>`       | Множитель сдвига высоты тона                                       |
| `--transparent`         | Рендер с прозрачным фоном                                          |
| `--preset <presetId>`   | Переопределение пресета для этого экспорта                         |
| `--volume <stem=value>` | Установить громкость дорожки по типу. Повторяемо                   |
| `--local`               | Рендерить локально вместо облака                                   |
| `--download`            | Дождаться экспорта и скачать его                                   |
| `--output <path>`       | Выходной файл или директория для локального рендера или скачивания |

### Громкости дорожек

Используйте `--volume <type>=<value>`. Допустимые типы: `original`, `vocals`, `instrumental` и `backing_vocals`. Значения должны быть в диапазоне от `0` до `1`.

### Облачный рендер

```bash theme={null}
youka export create $PROJECT_ID \
  --resolution 1080p \
  --quality high \
  --wait \
  --download \
  --output ./karaoke.mp4 \
  --json
```

### Локальный рендер

Локальный рендер запускает пайплайн Remotion на вашей машине. Сначала убедитесь, что зависимости для рендера установлены:

```bash theme={null}
youka deps ensure --for render
```

Затем выполните экспорт с `--local`:

```bash theme={null}
youka export create $PROJECT_ID \
  --local \
  --resolution 1080p \
  --output ./karaoke.mp4 \
  --json
```

<Note>
  Локальные рендеры записывают результат напрямую по пути `--output`. Не передавайте `--download`
  вместе с `--local`; CLI отклоняет эту комбинацию, потому что после локального рендера нет
  облачного артефакта, который можно было бы скачать.
</Note>

## `export quote`

Оценить количество кредитов, необходимых для облачного экспорта, не запуская экспорт.

```bash theme={null}
youka export quote <projectId> [options]
```

`export quote` оценивает только облачные экспорты. Локальные экспорты выполняются на вашей машине и
не используют кредиты облачного экспорта.

| Option                  | Description                                      |
| ----------------------- | ------------------------------------------------ |
| `--resolution <value>`  | `480p`, `720p`, `1080p` или `4k`                 |
| `--quality <value>`     | `low`, `medium` или `high`                       |
| `--speed <number>`      | Множитель скорости воспроизведения               |
| `--tone <number>`       | Множитель сдвига высоты тона                     |
| `--transparent`         | Рендер с прозрачным фоном                        |
| `--preset <presetId>`   | Переопределение пресета для этого экспорта       |
| `--volume <stem=value>` | Установить громкость дорожки по типу. Повторяемо |

Пример:

```bash theme={null}
youka export quote $PROJECT_ID \
  --resolution 1080p \
  --quality high \
  --json
```

## `export list`

Показать список экспортов для проекта.

```bash theme={null}
youka export list <projectId> [--page <n>] [--page-size <n>]
```

| Option        | Default | Description                      |
| ------------- | ------- | -------------------------------- |
| `--page`      | `1`     | Номер страницы.                  |
| `--page-size` | `100`   | Размер страницы. Максимум `100`. |

Пример:

```bash theme={null}
youka export list $PROJECT_ID --page-size 50 --json
```

## `export show`

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

```bash theme={null}
youka export show <exportId>
youka export show <exportId> --json
```

## `export wait`

Опросить экспорт до достижения им терминального состояния.

```bash theme={null}
youka export wait <exportId> --json
```

## `export download`

Скачать существующий экспорт по ID.

```bash theme={null}
youka export download <exportId> [--output <file>]
```

Пример:

```bash theme={null}
youka export download $EXPORT_ID \
  --output ./karaoke.mp4
```

## Что дальше

* [Projects](/ru/cli/projects) — создавайте проекты или ожидайте их готовности перед экспортом
* [Presets](/ru/cli/presets) — повторно используйте настройки рендера в разных экспортах
* [Dependencies](/ru/cli/deps) — проверяйте и устанавливайте зависимости для локального рендера