Seedance 2.0 API
Полный справочник API моделей генерации видео Seedance 2.0 от ByteDance.
Варианты моделей
Этот API поддерживает шесть вариантов моделей:
Краткое сравнение
Поддерживаемые соотношения сторон
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
Варианты разрешения
Seedance 2.0 Видео по тексту
Конечная точка
POST /api/v1/video/task
Параметры запроса
Обязательные
Необязательные
Пример запроса
javascript
Seedance 2.0 Видео по изображению
Параметры запроса
Обязательные
Необязательные
Пример запроса
javascript
Seedance 2.0 Видео по референсам
Параметры запроса
Обязательные
Референсные материалы
Передайте 1-9 изображений. Изображения можно не передавать только при наличии хотя бы одного референсного видео.
Плейсхолдеры ссылок @ (AT)
Функция ссылок @ (AT) связывает референсные материалы с промптом через нумерованные плейсхолдеры <<<...>>>. Нумерация начинается с 1 отдельно для каждого типа материала и следует порядку соответствующего массива:
Например, если первое изображение задаёт персонажа, а второе — сцену, используйте в prompt <<<image_1>>> для персонажа и <<<image_2>>> для сцены. Каждый плейсхолдер должен указывать на существующий элемент соответствующего массива.
Необязательные
Пример запроса
javascript
Пример запроса видео по референсам с @ (AT)
javascript
Варианты Fast
Варианты Fast отдают приоритет скорости обработки. Все модели Fast поддерживают выходное разрешение только "480p" и "720p". В остальном структура запросов Fast Видео по тексту и Fast Видео по изображению совпадает с соответствующими стандартными моделями, а Fast Видео по референсам использует те же ограничения материалов, что и стандартная референсная модель.
Пример запроса Fast
javascript
Пример запроса Fast Видео по референсам с @ (AT)
javascript
Параметры Seedance 2.0 Fast Видео по референсам
Обязательные
Референсные материалы
Описанная выше нумерация плейсхолдеров с 1 также применяется к модели Fast Видео по референсам.
Необязательные
Ограничения материалов
Эти ограничения применяются к изображениям первого и последнего кадров и референсным материалам моделей на этой странице.
Для референсных аудио и видео действует отдельное ограничение общей длительности — по 15 секунд. Количество материалов независимо: до 9 изображений, 3 видео и 3 аудиоклипов. Добавление видео не уменьшает допустимое количество изображений.
Все модели используют 720p по умолчанию, но resolution всё равно обязателен. Переключатель звука по умолчанию равен true; ни он, ни референсное аудио не влияют на цену. Для видео по референсам требуется хотя бы одно изображение или видео; запросы только с аудио не поддерживаются. Загрузка референсных видео удваивает стоимость генерации независимо от их количества или длительности.
Формат ответа
Начальный ответ
Все модели возвращают task_id для периодического опроса:
json
Ответ при опросе
Опрашивайте GET /api/v1/video/{taskId} для проверки статуса:
json
Значения статуса
submitted: задача принята и ожидает обработкиprocessing: выполняется генерация видеоsucceed: генерация видео завершенаfailed: генерация видео не удалась
Время обработки
Стандартные модели: 3-8 минут в зависимости от длительности и разрешения.
Модели Fast: 1-4 минуты для большинства конфигураций.
Проверяйте статус каждые 5-10 секунд.
Рекомендации {#}
- Выбирайте подходящий вариант: используйте модели Fast для итераций, стандартные модели — для итогового результата
- Чётко описывайте движение: включайте в промпты конкретные описания движений
- Выбор разрешения: все стандартные модели Seedance 2.0 поддерживают
480p,720p,1080pи4k; все модели Fast — только480pи720p - Порядок референсов: упорядочивайте
images,videosиaudiosосознанно и последовательно ссылайтесь на них в промпте - Запросы только с видео: используйте пустой массив
imagesтолько при наличии хотя бы одного референсного видео - Длительность материалов: каждый референсный аудио- и видеоклип должен длиться от 2 до 15 секунд
- Использование звука: пропустите
sound, чтобы использовать значение по умолчаниюtrue, или задайтеfalse, чтобы отключить генерацию звука