Seedance 2.5 Flash API
Полный справочник по API моделей генерации видео Seedance 2.5 Flash от ByteDance.
Варианты модели
API поддерживает три варианта модели:
Краткое сравнение
Поддерживаемые соотношения сторон
Для генерации по тексту и по референсам доступны следующие соотношения сторон:
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
Модель генерации по изображению не поддерживает параметр aspect_ratio.
Варианты разрешения
Seedance 2.5 Flash Text to Video
Конечная точка
POST /api/v1/video/task
Параметры запроса
Обязательные
Необязательные
Пример запроса
javascript
Seedance 2.5 Flash Image to Video
Параметры запроса
Обязательные
Необязательные
Не включайте
aspect_ratioв запросы на генерацию по изображению. Эта модель не поддерживает данный параметр.
Пример запроса
javascript
Seedance 2.5 Flash Reference to Video
Параметры запроса
Обязательные
Референсные материалы
Все референсные материалы необязательны. Можно отправить только изображения, только видео, только аудио или запрос без референсов. Для генерации без референсов рекомендуется модель генерации по тексту.
Маркеры ссылок @ (AT)
Функция ссылок @ (AT) связывает референсные материалы с текстовым запросом через нумерованные маркеры <<<...>>>. Для каждого типа файлов нумерация начинается с 1 и соответствует порядку элементов в его массиве:
Например, если первое изображение служит образцом персонажа, а второе — окружения, укажите в prompt маркер <<<image_1>>> для персонажа и <<<image_2>>> для окружения. Каждый маркер должен указывать на существующий элемент соответствующего массива.
Необязательные
Пример запроса
javascript
Пример запроса на генерацию по референсам со ссылками @ (AT)
javascript
Ограничения для медиафайлов
Эти ограничения распространяются на изображения первого и последнего кадров и на референсные материалы для моделей, описанных на этой странице.
Для референсных аудио и видео действуют отдельные ограничения по суммарной длительности — по 30 секунд на каждый тип. Ограничения по количеству также независимы: до 10 изображений, 5 видео и 5 аудиофрагментов.
Для всех моделей обязательны resolution и duration, значений по умолчанию у них нет. При генерации по тексту и по референсам используется 16:9, если не задан aspect_ratio. По умолчанию звук включён (true). Установите false для генерации видео без звука.
Формат ответа
Первоначальный ответ
Все модели возвращают task_id для периодической проверки статуса:
json
Ответ при проверке статуса
Для проверки статуса периодически отправляйте запрос GET /api/v1/video/{taskId}:
json
Значения статуса
submitted: Задача принята и ожидает обработкиprocessing: Идёт генерация видеоsucceed: Генерация видео завершенаfailed: Не удалось сгенерировать видео
Время обработки
Время обработки зависит от длительности видео, разрешения и текущей очереди.
Проверяйте статус каждые 5–10 секунд.
Рекомендации {#}
- Обязательные параметры: всегда передавайте
prompt,resolutionиduration. При генерации по тексту и по референсам параметрaspect_ratioнеобязателен. Значение по умолчанию —16:9 - Соотношение сторон при генерации по изображению: не передавайте
aspect_ratioв запросах на генерацию по изображению - Референсные видео: видео необязательны. Соблюдайте указанные ограничения как для каждого видео, так и для их суммарной длительности
- Референсные изображения: изображения необязательны независимо от наличия видео и аудио. Можно передать до 10 URL изображений поддерживаемых форматов
- Референсное аудио: каждый фрагмент должен длиться от 2 до 30 секунд и занимать не более 15 МБ. Суммарная длительность — не более 30 секунд
- Порядок референсов: расположите элементы
images,videosиaudiosв нужном порядке и учитывайте этот порядок при ссылках на них в текстовом запросе - Звук: опустите
sound, чтобы использовать значение по умолчаниюtrue, или задайтеfalse, чтобы отключить генерацию звука