# ByteDance vCube Video Enhance

Этот узел выполняет апскейлинг и восстановление видео с помощью ByteDance vCube. Он позволяет повышать разрешение вплоть до 8K, удалять артефакты сжатия и шум, улучшать цвет и резкость, а также при необходимости интерполировать кадры для повышения частоты кадров. Видео загружается в сервис vCube, обрабатывается с выбранным пресетом улучшения и возвращается в виде улучшенного видеофайла.

## Входы

### Общие входы

Эти входы отображаются всегда.

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
|-----------|-------------|-----------|----------|-------|
| `видео` | Видео для улучшения. Исходное разрешение должно быть не более 2560x1440 (2K); размер выходного видео задаётся входом `resolution`. | VIDEO | Да | Не более 2560x1440 (2K) |
| `tool_version` | 'standard' обеспечивает баланс скорости и качества благодаря более чем 10 алгоритмам улучшения. 'professional' использует более 30 алгоритмов для реставрации кинематографического уровня, занимает примерно в 3 раза больше времени и стоит в 10 раз дороже. | DYNAMIC_COMBO | Да | "standard"<br>"professional" |
| `разрешение` | Выходное разрешение. Короткая сторона устанавливается в выбранное значение, а длинная сторона рассчитывается по исходному соотношению сторон. 'source' сохраняет исходный размер, 'custom' задаёт короткую сторону в пикселях. Источники с соотношением сторон, более экстремальным, чем примерно 2.2:1, тарифицируются на один уровень разрешения выше. | DYNAMIC_COMBO | Да | "720p"<br>"1080p"<br>"2k"<br>"4k"<br>"8k"<br>"source"<br>"custom" |
| `fps` | Выходная частота кадров. Более высокая частота, чем у источника, включает ИИ-интерполяцию кадров; более низкая — отбрасывает кадры. 'source' сохраняет исходную частоту, до 120 fps. Частоты выше 30 fps стоят в 2 раза дороже, выше 60 fps — в 4 раза. (по умолчанию: "source") | COMBO | Да | "source" (по умолчанию)<br>Числовые значения частоты кадров до 120 fps |
| `bitrate_level` | Целевой битрейт итогового файла, масштабируемый в зависимости от выходного разрешения и частоты кадров. (по умолчанию: "medium") | COMBO | Да | "low"<br>"medium"<br>"high" |

### Стандартные входы

Отображаются, когда `tool_version` установлен в "standard".

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
|-----------|-------------|-----------|----------|-------|
| `scene` | Пресет, настроенный под содержимое: 'aigc' — для сгенерированных ИИ материалов, 'common' — для обычного видео, 'ugc' — для сжатых клипов с телефона, 'short_series' — для коротких сериалов с лицами, 'old_film' — для поцарапанных или мерцающих архивных материалов. (по умолчанию: "aigc") | COMBO | Да | "aigc"<br>"common"<br>"ugc"<br>"short_series"<br>"old_film" |
| `enhance_style` | 'hd' применяет более резкое улучшение; 'natural' снижает интенсивность для более мягкого и менее резкого вида. (по умолчанию: "hd") | COMBO | Да | "hd"<br>"natural" |

### Профессиональные входы

Отображаются, когда `tool_version` установлен в "professional".

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
|-----------|-------------|-----------|----------|-------|
| `enhance_style` | 'hd' применяет более резкое улучшение; 'natural' снижает интенсивность для более мягкого и менее резкого вида. (по умолчанию: "hd") | COMBO | Да | "hd"<br>"natural" |

### Входы пользовательского разрешения

Отображаются, когда `resolution` установлен в "custom".

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
|-----------|-------------|-----------|----------|-------|
| `short_side` | Короткая сторона выходного видео в пикселях; длинная сторона рассчитывается по исходному соотношению сторон. (по умолчанию: 1080) | INT | Да | По умолчанию 1080; ограничено минимальным и максимальным лимитами короткой стороны в vCube |

### Примечания

- Исходное видео должно быть не более 2560x1440 (2K). Видео большего размера отклоняются, и перед улучшением их необходимо уменьшить.
- Длительность исходного видео ограничена максимальной длительностью, поддерживаемой сервисом vCube.
- Когда `tool_version` имеет значение "standard", доступны и `scene`, и `enhance_style`. Когда выбрано "professional", доступен только `enhance_style`.
- Когда `resolution` имеет значение "custom", требуется значение `short_side`. Пресеты разрешения и "source" не используют `short_side`.
- Когда `resolution` имеет значение "source" и короткая сторона источника не меньше минимального лимита короткой стороны, выходное видео сохраняет исходное разрешение.
- Когда `fps` имеет значение "source", выходная частота кадров совпадает с исходной частотой кадров, до 120 fps.

## Выходы

| Имя выхода | Описание | Тип данных |
|-------------|-------------|-----------|
| `video` | Улучшенное видео, масштабированное вверх и восстановленное с запрошенным разрешением и частотой кадров. | VIDEO |

> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ru.md)

---
**Source fingerprint (SHA-256):** `bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda`
