# ByteDance Seedance 2.5: референс в видео

ByteDance Seedance 2.5 Reference to Video генерирует, редактирует или продлевает видео с помощью моделей ByteDance Seedance (Seedance 2.5, 2.5 Draft, 2.0, 2.0 Fast и 2.0 Mini), руководствуясь текстовой подсказкой и необязательными эталонными изображениями, видео, аудио или ранее загруженными ресурсами библиотеки. Он загружает эталонные материалы, отправляет задачу генерации, ожидает завершения и возвращает готовый видеофайл. Если выбрать `Seedance 2.5 Draft`, вместо этого создаётся быстрый предпросмотр в 480p; подключите полученный `draft_task_id` к узлу ByteDance Seedance 2.5 Draft to Final Video, чтобы отрендерить финальное видео в 1080p.

## Входы

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

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
|-----------|-------------|-----------|----------|-------|
| `модель` | Селектор модели. Seedance 2.5 — новейшая модель, видео длительностью до 30 секунд и вывод в mp4; Seedance 2.5 Draft — быстрый предпросмотр в 480p, чей выход `draft_task_id` позволяет отрендерить финальное видео в 1080p в узле ByteDance Seedance 2.5 Draft to Final Video; Seedance 2.0 — максимальное качество и 4k; Fast — оптимизация скорости; Mini — самая быстрая и недорогая генерация. Выбор модели изменяет отображаемые ниже входные виджеты. | DYNAMIC_COMBO | Да | "Seedance 2.5"<br>"Seedance 2.5 Draft"<br>"Seedance 2.0"<br>"Seedance 2.0 Fast"<br>"Seedance 2.0 Mini" |
| `сид` | Сид управляет тем, должен ли узел запуститься повторно; результаты недетерминированы независимо от сида. По умолчанию: 0. | INT | Да | от 0 до 2147483647 |
| `водяной знак` | Добавлять ли водяной знак к видео. По умолчанию: False. Дополнительная настройка. | BOOLEAN | Да | true<br>false |

### Входы Seedance 2.5

Эти входы отображаются, когда `model` имеет значение "Seedance 2.5".

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
|-----------|-------------|-----------|----------|-------|
| `prompt` | Текстовая подсказка для генерации видео. Заключайте произносимые реплики в двойные кавычки, чтобы управлять генерируемым диалогом. По умолчанию: пустая строка. | STRING | Да | Многострочный текст |
| `resolution` | Разрешение выходного видео. По умолчанию: 720p. | COMBO | Да | "480p"<br>"720p"<br>"1080p" |
| `ratio` | Соотношение сторон выходного видео. По умолчанию: 16:9. | COMBO | Да | "16:9"<br>"4:3"<br>"1:1"<br>"3:4"<br>"9:16"<br>"21:9"<br>"adaptive" |
| `duration` | Длительность выходного видео в секундах (4–30). По умолчанию: 5. | INT | Да | от 4 до 30 |
| `generate_audio` | Включить генерацию аудио для выходного видео. По умолчанию: True. | BOOLEAN | Да | true<br>false |
| `task_type` | Что делать с эталонными материалами. Все значения, кроме auto, проверяются при отправке задачи, поэтому несовместимые настройки завершаются ошибкой до начала генерации.<br>auto: модель определяет задачу по подсказке и входам, а настройки, конфликтующие с её трактовкой, завершаются ошибкой только после начала генерации.<br>reference: сгенерировать новое видео на основе эталонных изображений, видео и аудио.<br>edit: изменить подключённое эталонное видео (добавить, удалить, заменить); выход сохраняет собственную длительность и соотношение сторон исходного клипа, а виджеты `duration` и `ratio` игнорируются.<br>extend: продолжить подключённое эталонное видео вперёд или назад; в подсказке следует указать "extend forward", "extend backward" или "continue", соотношение сторон следует за исходным клипом, а выход содержит только новый сгенерированный сегмент заданной вами длительности, а не исходный клип. По умолчанию: auto. | COMBO | Да | "auto"<br>"reference"<br>"edit"<br>"extend" |
| `output_format` | Формат контейнера выходного видео. По умолчанию: mp4. | COMBO | Да | "mp4" |

### Входы Seedance 2.5 Draft

Эти входы отображаются, когда `model` имеет значение "Seedance 2.5 Draft". Набор параметров совпадает с Seedance 2.5 выше, за исключением того, что `resolution` предлагает только `"480p"` (по умолчанию `"480p"`).

### Входы Seedance 2.0

Эти входы отображаются, когда `model` имеет значение "Seedance 2.0".

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
|-----------|-------------|-----------|----------|-------|
| `prompt` | Текстовая подсказка для генерации видео. По умолчанию: пустая строка. | STRING | Да | Многострочный текст |
| `resolution` | Разрешение выходного видео. | COMBO | Да | "480p"<br>"720p"<br>"1080p"<br>"4k" |
| `ratio` | Соотношение сторон выходного видео. По умолчанию: adaptive. | COMBO | Да | "16:9"<br>"4:3"<br>"1:1"<br>"3:4"<br>"9:16"<br>"21:9"<br>"adaptive" |
| `duration` | Длительность выходного видео в секундах (4–15). По умолчанию: 7. | INT | Да | от 4 до 15 |
| `generate_audio` | Включить генерацию аудио для выходного видео. По умолчанию: True. | BOOLEAN | Да | true<br>false |

### Входы Seedance 2.0 Fast и Seedance 2.0 Mini

Эти входы отображаются, когда `model` имеет значение "Seedance 2.0 Fast" или "Seedance 2.0 Mini". Обе модели используют один и тот же набор входов.

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
|-----------|-------------|-----------|----------|-------|
| `prompt` | Текстовая подсказка для генерации видео. По умолчанию: пустая строка. | STRING | Да | Многострочный текст |
| `resolution` | Разрешение выходного видео. | COMBO | Да | "480p"<br>"720p" |
| `ratio` | Соотношение сторон выходного видео. По умолчанию: adaptive. | COMBO | Да | "16:9"<br>"4:3"<br>"1:1"<br>"3:4"<br>"9:16"<br>"21:9"<br>"adaptive" |
| `duration` | Длительность выходного видео в секундах (4–15). По умолчанию: 7. | INT | Да | от 4 до 15 |
| `generate_audio` | Включить генерацию аудио для выходного видео. По умолчанию: True. | BOOLEAN | Да | true<br>false |

### Эталонные входы

Эти расширяемые эталонные слоты доступны для всех моделей. Максимальное количество слотов зависит от модели: Seedance 2.5 поддерживает до 30 изображений, 10 видео, 10 аудио и 30 ассетов; Seedance 2.0, 2.0 Fast и 2.0 Mini поддерживают до 9 изображений, 3 видео, 3 аудио и 9 ассетов.

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
|-----------|-------------|-----------|----------|-------|
| `reference_images` | Расширяемый слот: подключите от 1 до N эталонных изображений, которые направляют вывод. Ограничение количества зависит от модели (см. разделы моделей). Изображения проверяются на соотношение сторон (от 0.4 до 2.5) и автоматически уменьшаются до максимальной стороны 6000 пикселей. | IMAGE | Нет | 1..9 слотов (семейство Seedance 2.0)<br>1..30 слотов (Seedance 2.5) |
| `reference_videos` | Расширяемый слот: подключите от 1 до N эталонных видео. Ограничение количества зависит от модели (см. разделы моделей). Каждое видео должно быть длительностью не менее 1.8 секунды и соответствовать ограничениям по пикселям для выбранной модели и разрешения. | VIDEO | Нет | 1..3 слота (семейство Seedance 2.0)<br>1..10 слотов (Seedance 2.5) |
| `reference_audios` | Расширяемый слот: подключите от 1 до N эталонных аудиодорожек. Ограничение количества зависит от модели (см. разделы моделей). Каждое аудио должно быть длительностью не менее 1.8 секунды. | AUDIO | Нет | 1..3 слота (семейство Seedance 2.0)<br>1..10 слотов (Seedance 2.5) |
| `reference_assets` | Расширяемый слот: подключите от 1 до N строк ID ассетов для медиа, уже загруженных в виртуальную библиотеку Seedance. Каждый ассет должен иметь статус Active. Вы можете ссылаться на ассет в подсказке с помощью токенов, таких как `asset1` или `asset 1`; узел заменяет их на позиционную метку ассета (например, "Image 2" или "Video 1"). | STRING | Нет | 1..9 слотов (семейство Seedance 2.0)<br>1..30 слотов (Seedance 2.5) |
| `auto_downscale` | Автоматически уменьшать эталонные видео, превышающие лимит пикселей модели для выбранного разрешения. Соотношение сторон сохраняется; видео, уже находящиеся в пределах лимита, не изменяются. По умолчанию: True. | BOOLEAN | Нет | true<br>false |
| `auto_upscale` | Автоматически увеличивать эталонные видео, которые ниже минимального количества пикселей модели для выбранного разрешения. Соотношение сторон сохраняется; видео, уже соответствующие минимуму, не изменяются. Примечание: увеличение источника с низким разрешением не добавляет реальных деталей и может привести к генерациям более низкого качества. По умолчанию: False. Дополнительная настройка. | BOOLEAN | Нет | true<br>false |

**Примечание:** Для запуска узла требуется хотя бы одно эталонное изображение, видео или ассет (Seedance 2.5 также принимает эталонные материалы, состоящие только из аудио). Эталонные видео и аудио должны иметь длительность не менее 1.8 секунды каждое, а суммарная длительность всех эталонных видео (и отдельно всех эталонных аудио) не должна превышать максимальную общую длительность в секундах для выбранной модели. Эталонные изображения должны иметь соотношение сторон примерно от 2:5 до 5:2 (0.4 до 2.5), быть не менее 300x300 пикселей и автоматически уменьшаются до максимальной стороны 6000 пикселей. Опции `task_type` "edit" и "extend" доступны только с Seedance 2.5, и обе требуют как минимум одного эталонного видео; при использовании "edit" выход сохраняет собственную длительность и соотношение сторон исходного клипа, а виджеты `duration` и `ratio` игнорируются; при использовании "extend" выход содержит только новый сгенерированный сегмент заданной вами длительности. Эталонные ассеты должны находиться в статусе Active, иначе задача завершается ошибкой. Каждый запуск возвращает свой ID задачи как `draft_task_id`, но только ID запуска `Seedance 2.5 Draft` может быть отрендерен узлом ByteDance Seedance 2.5 Draft to Final Video, поэтому при любой другой модели выход необходимо оставить неподключённым, иначе запуск завершится ошибкой.

## Выходы

| Имя выхода | Описание | Тип данных |
|-------------|-------------|-----------|
| `video` | Сгенерированное видео, скачиваемое от провайдера после завершения задачи генерации. Содержит аудио, когда генерация аудио включена. | VIDEO |
| `draft_task_id` | ID задачи, возвращаемый запуском. Только запуск `Seedance 2.5 Draft` создаёт черновик, который может отрендерить узел ByteDance Seedance 2.5 Draft to Final Video; при любой другой модели выход необходимо оставить неподключённым, иначе запуск завершится ошибкой. | STRING |

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

---
**Source fingerprint (SHA-256):** `12fee29b280ff71e29f268f52131d1c15cf3066e0804356b735b61d97c80a6a9`
