# ByteDance Seedance 2.5: референс в видео (устаревшая версия)

Этот узел создаёт, редактирует или продлевает видео с помощью ИИ-моделей ByteDance Seedance 2.5 или Seedance 2.0. Вы описываете видео в текстовом промпте и можете прикреплять эталонные изображения, видео и аудио для управления результатом; поддерживаются мультимодальные эталонные входы, редактирование видео и продление видео. Это устаревшая, не рекомендуемая к использованию версия узла Seedance reference-to-video.

## Входы

Выбор `model` определяет, какие из перечисленных ниже параметров доступны. `video_editing` и `output_format` появляются только при выборе Seedance 2.5. Расширяемые слоты эталонных входов и параметры автоматического изменения размера эталонных видео являются общими для всех моделей и описаны в разделе «Эталонные входы».

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

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
|-----------|-------------|-----------|----------|-------|
| `модель` | ИИ-модель, используемая для генерации видео. Seedance 2.5 — новейшая модель, видео длительностью до 30 секунд и вывод в форматах mp4/mov; Seedance 2.0 — максимальное качество и 4k; Fast — оптимизация под скорость; Mini — самая быстрая и недорогая генерация. Выбор модели открывает зависящие от модели входы, перечисленные ниже. | DYNAMIC_COMBO | Да | `"Seedance 2.5"`<br>`"Seedance 2.0"`<br>`"Seedance 2.0 Fast"`<br>`"Seedance 2.0 Mini"` |
| `seed` | Seed управляет тем, должен ли узел перезапускаться; результаты недетерминированы независимо от seed (по умолчанию: 0). | INT | Да | 0 до 2147483647<br>Шаг: 1 |
| `водяной знак` | Добавлять ли водяной знак к видео (по умолчанию: False). Дополнительный параметр. | BOOLEAN | Да | `True`<br>`False` |

### Входы 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` | Длительность выходного видео в секундах (по умолчанию: 5). | INT | Да | 4 до 30<br>Шаг: 1 |
| `generate_audio` | Включить генерацию аудио для выходного видео (по умолчанию: True). | BOOLEAN | Да | `True`<br>`False` |
| `video_editing` | Включите, когда промпт редактирует подключённое эталонное видео, например заменяет объект в нём. Тогда выход сохраняет собственную длительность и соотношение сторон исходного клипа, а виджеты `duration` и `ratio` игнорируются. Оставьте выключенным, чтобы сгенерировать новое видео или продлить его до заданной вами длительности (по умолчанию: False). | BOOLEAN | Да | `True`<br>`False` |
| `output_format` | Контейнерный формат выходного видео (по умолчанию: `"mp4"`). | COMBO | Да | `"mp4"` |

### Входы 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` | Длительность выходного видео в секундах (по умолчанию: 7). | INT | Да | 4 до 15<br>Шаг: 1 |
| `generate_audio` | Включить генерацию аудио для выходного видео (по умолчанию: True). | BOOLEAN | Да | `True`<br>`False` |

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

Общие для Seedance 2.0 Fast и Seedance 2.0 Mini. Эти две модели предоставляют тот же набор входов, что и Seedance 2.0, за исключением того, что `resolution` ограничен значениями 480p и 720p.

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
|-----------|-------------|-----------|----------|-------|
| `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` | Длительность выходного видео в секундах (по умолчанию: 7). | INT | Да | 4 до 15<br>Шаг: 1 |
| `generate_audio` | Включить генерацию аудио для выходного видео (по умолчанию: True). | BOOLEAN | Да | `True`<br>`False` |

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

Доступно для всех моделей. Максимальное количество слотов зависит от выбранной модели: Seedance 2.5 поддерживает больше эталонных входов, чем модели Seedance 2.0.

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

**Важные ограничения:**

* Требуется хотя бы один эталонный вход. Для Seedance 2.0, 2.0 Fast и 2.0 Mini необходимо предоставить хотя бы одно эталонное изображение или видео (через `reference_images`, `reference_videos` или запись изображения либо видео в `reference_assets`). Seedance 2.5 дополнительно принимает только аудиоэталоны (через `reference_audios` или запись аудио в `reference_assets`).
* Количество эталонных входов зависит от модели и проверяется суммарно по прямым входам и ссылкам на ресурсы: Seedance 2.5 допускает до 30 `reference_images`, 10 `reference_videos`, 10 `reference_audios` и 30 `reference_assets`; модели Seedance 2.0 допускают до 9 изображений, 3 видео, 3 аудиоклипов и 9 ресурсов.
* Каждое эталонное видео должно быть длительностью не менее 1.8 секунды, и каждый эталонный аудиоклип должен быть длительностью не менее 1.8 секунды. Суммарная длительность всех эталонных видео и всех эталонных аудио не должна превышать лимит выбранной модели (15.1 секунды для моделей Seedance 2.0).
* Эталонные видео также должны соответствовать лимитам количества пикселей модели для выбранного разрешения. При включённом `auto_downscale` (по умолчанию) слишком большие видео автоматически изменяются в размере; при включённом `auto_upscale` слишком маленькие видео увеличиваются. Если любое из автоматических изменений отключено, видео за пределами соответствующего лимита вызывают ошибку.
* Когда `video_editing` включён в Seedance 2.5, входы `duration` и `ratio` игнорируются; выход соответствует собственной длительности и соотношению сторон эталонного видео. Если провайдер интерпретирует промпт как редактирование эталонного видео, генерация завершается ошибкой, если только `video_editing` не включён или промпт не переформулирован для описания нового видео.
* Если провайдер отклоняет аудиодорожку, сгенерированную для видео (например, из-за возможного совпадения по авторским правам), задача завершается ошибкой; отключение `generate_audio` создаёт видео без звука.

## Выходы

| Имя выхода | Описание | Тип данных |
|-------------|-------------|-----------|
| `video` | Сгенерированный видеофайл. | VIDEO |

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

---
**Source fingerprint (SHA-256):** `4a1b62f65ff3515cdb749c9b3916e631e53523fe144e8cdf71ca020825196ae6`
