Введение
Отправьте image_url и prompt, чтобы оживить статичное изображение; last_image_url, duration_seconds, resolution и generate_audio необязательны, а watermark, return_last_frame и output_format — дополнительные. Поля aspect_ratio нет, потому что клип сохраняет форму стартового изображения. Пишите в промпте о движении, камере и звуке, а не описывайте фото второй раз.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Видео |
| Разработчик | ByteDance (Seedance 2.5 Flash, ускоренная версия Seedance 2.5, анонсирована BytePlus 12 ноября 2026 года) |
| Названия API | bytedance/seedance-2.5-flash/text-to-video, image-to-video, reference-to-video, video-edit, video-extend |
| Разрешение | 480p или 720p (по умолчанию 720p); 1080p и 4K не поддерживаются |
| Длительность клипа | 4–30 целых секунд, по умолчанию 5; video-edit следует исходнику длиной 4–30 с |
| Соотношение сторон | 16:9 (по умолчанию), 9:16, 4:3, 3:4, 1:1, 21:9 или adaptive в запросах из текста и референсов; image-to-video следует стартовому изображению |
| Ограничения референсов | До 10 изображений, 5 клипов (30 с вместе) и 5 аудиофайлов в reference-to-video |
| Правила для референсных клипов | Каждый клип засчитывается минимум за 2 с и должен содержать около 409 600 пикселей (854×480 или больше) |
| Входные данные для правки |
|
| Звук |
|
| Параметры вывода | mp4 (по умолчанию) или mov; watermark по умолчанию выключен; |
| Основа тарификации | Посекундно, по разрешению; референсные клипы добавляют свои секунды; правки считаются по секундам исходника; неудачные генерации бесплатны |
| Измеренное время рендера | От 84 с до примерно 11 мин для 4 с в 480p (запуски 13 ноября 2026 года) |
Ключевые возможности и особенности
Флагманские сценарии с более низким потолком
Flash сохраняет четыре сценария Seedance 2.5, подходящие для черновой работы (текст, начальный и конечный кадры, смешанные референсы, редактирование клипа), отказывается от 1080p и 4K и добавляет продление видео на основе своего режима изображение в видео. BytePlus подаёт этот компромисс как результат, близкий к флагману, при почти вдвое большей скорости. Наши рендеры 4 секунд в 480p занимали от 84 секунд до примерно 11 минут, поэтому измеряйте скорость на своей очереди.
Дайте каждой загрузке задачу в промпте
Называйте загрузки по типу и порядку с пробелом: @Image 1, @Video 1, @Audio 1. Когда два портрета были даны как @Image 1 и @Image 2 в 16:9, оба человека появились вместе в одной сцене в лифте и сохранили лица, волосы и одежду. С одним изображением, одним клипом и одним голосовым файлом улица клипа, жёлтый трамвай и следящая камера перенеслись, но человек остался спиной к камере, а лицо из @Image 1 почти не было видно.
Солнечная улица превратилась в снежный вечер
Оба велосипедиста, их велосипеды, трамвай и движение камеры совпали с исходником кадр в кадр: изменились погода и свет, а остальное нет. Это был клип 4,0 с в 480p с выключенным звуком, поэтому исходная звуковая дорожка тоже сохранилась.
Один переключатель решает, чья звуковая дорожка вам достанется
generate_audio включён по умолчанию и создаёт речь, эффекты и атмосферу вместе с картинкой. В video-edit выключение сохраняет собственную дорожку исходного клипа (в нашем тесте 44,1 кГц), а включение генерирует новую, которая может следовать @Audio 1. Переключатель на цену не влияет.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательно. Напишите, что движется и в каком порядке, как ведёт себя камера и что слышно, а внешний вид оставьте картинке. Не менее 1 символов · Не более 20000 символов |
image_url | Да | Обязательно. |
last_image_url | Нет | Необязательный финальный кадр, отправляется вместе с |
resolution | Нет | 480p или 720p, по умолчанию 720p; посекундная ставка зависит от выбора. |
duration_seconds | Нет | Целые секунды от 4 до 30, по умолчанию 5, каждая запрошенная секунда оплачивается. |
generate_audio | Нет | Включён по умолчанию: звук создаётся за тот же проход по вашей строке Audio: и картинке. Выключите для немого клипа; цена одинакова в обоих случаях. По умолчанию: |
output_format | Нет | mp4 (по умолчанию) или mov. Выберите контейнер, который ожидает ваш редактор или плеер; на размер картинки и цену он не влияет. |
return_last_frame | Нет | По умолчанию выключен. Включите, чтобы дополнительно получить последний кадр в виде JPEG, который можно передать как |
watermark | Нет | По умолчанию выключен. Включите, чтобы модель добавила на кадры видимый водяной знак, например на копиях для согласования. По умолчанию: |
Стоимость
Оплата за каждую запрошенную секунду, ставка зависит от выбранного разрешения. Финальный кадр, переключатель звука, водяной знак, изображение последнего кадра и формат файла цену не меняют, неудачные генерации не тарифицируются.
| Спецификация | Стоимость |
|---|---|
| $0.115 / секунду |
| $0.2392 / секунду |
Сценарии использования
Проверка плана кадра перед финальным рендером
Отправьте промпт на 4 секунды в 480p и 16:9, заканчивающийся строкой Audio:, например про ночной пешеходный переход под дождём. Наш запуск вернул 854×480 при 24 кадрах в секунду, длительностью 4,064 с, со стереодорожкой AAC с шумом дождя и смехом. Измените одну фразу и запустите снова, чтобы увидеть, что сдвинулось.
Смена стиля уже снятого материала
Загрузите клип длиной 4–30 секунд, опишите изменение и перечислите, что должно остаться прежним. В нашем тесте солнечная улица с двумя велосипедистами и трамваем превратилась в снежный вечер, а при выключенном generate_audio исходная звуковая дорожка вернулась без изменений.
Макеты персонажей и продуктов
Приложите портрет и фото продукта как @Image 1 и @Image 2 и запросите 9:16. В нашем тесте с двумя изображениями получилось 480×854: мужчина поднимает к объективу стеклянный флакон с пипеткой, то есть оба референса попали в кадр. По результату оцените идею, прежде чем делать отшлифованную версию.
Зацикленная анимация портрета
Передайте одно и то же фото как image_url и last_image_url и опишите движение между ними. Наш портрет гончарницы вернул клип 562×748 длительностью 4,064 с, у которого начальный и конечный кадры совпали с исходной позой.
Цепочка из кадра в кадр
Установите return_last_frame в true, и MP4 придёт вместе с JPEG его последнего кадра (854×480 в 480p и 16:9 в нашем тесте). Передайте этот JPEG как image_url в следующем запросе image-to-video, чтобы следующий кадр начинался там, где закончился предыдущий.
Руководство по промптам и практические советы
Выберите эндпоинт под ваши входные данные
Берите text-to-video, если у вас есть один промпт, image-to-video — для стартового кадра, reference-to-video — для изображений, клипов или голоса, video-edit — для готового клипа длиной 4–30 секунд, а video-extend — чтобы добавить 4–30 секунд к клипу длиной до 60 секунд. У всех пяти одинаковый диапазон 480p/720p и переключатель
generate_audio.Отправьте запрос createTask
Отправьте POST на https://api.spicyapi.ai/api/v1/jobs/createTask с заголовком Authorization: Bearer YOUR_SPICY_API_KEY и телом {"model": "bytedance/seedance-2.5-flash/text-to-video", "input": {"prompt": "A lighthouse keeper climbs a spiral stair at dawn and wipes fog from the lamp glass. Audio: wind, boots on iron.", "
duration_seconds": 4, "resolution": "480p"}}.Опросите статус и заберите готовый клип
В ответе приходит taskId в состоянии queued. Вызывайте GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID или передайте callBackUrl, пока состояние не станет succeeded, затем возьмите адрес MP4 из output.assets. Подробности по полям — в руководстве по задачам на docs.spicyapi.ai/docs/tasks.
Меняйте одну фразу, затем повышайте разрешение
Сравнивайте варианты в 480p на 4 секунды, меняя по одной фразе за запуск. Когда дубль получился, повторите его в 720p и нужной длительности или отправьте то же задание в Seedance 2.5 ради 1080p.
Seedance 2.5 Flash image to video одним вызовом
Seedance 2.5 Flash image to video — способ ByteDance оживить одну картинку на ускоренной версии Seedance 2.5. Вы отправляете изображение как image_url и промпт о том, что должно двигаться. Модель возвращает MP4 длиной от 4 до 30 секунд в 480p или 720p, который открывается вашей картинкой, а звук создаётся за тот же проход. Добавьте last_image_url, и клип завершится на второй картинке: так делают петли, возврат в позу и переходы из A в B (такое видео часто ищут как «видео по первому и последнему кадру»). BytePlus, облачная платформа ByteDance, сообщает, что Flash даёт результат, близкий к Seedance 2.5, при почти вдвое большей скорости генерации.
Пример запроса
POST https://api.spicyapi.ai/api/v1/jobs/createTask с Authorization: Bearer YOUR_SPICY_API_KEY и Content-Type: application/json. Это тело нашего теста с гончарницей, где один портрет служит и стартовым, и финальным кадром:
{
"model": "bytedance/seedance-2.5-flash/image-to-video",
"input": {
"image_url": "https://example.com/potter-portrait.jpg",
"last_image_url": "https://example.com/potter-portrait.jpg",
"prompt": "The potter cups the spinning clay and slowly draws its wall upward, then lifts her eyes to the camera with a warm smile and settles back into the same pose. Locked-off medium shot, soft window light. Audio: the steady hum of the wheel and the wet squeak of clay, no music.",
"duration_seconds": 4,
"resolution": "480p",
"generate_audio": true
}
}
Пример ответа
Отправка сразу возвращает идентификатор задачи:
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "queued"}}
Опрашивайте GET /api/v1/jobs/recordInfo?taskId=task_abc123 или передайте callBackUrl. Завершённая задача содержит MP4 (см. руководство по API задач):
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "succeeded", "output": {"assets": [{"url": "https://example.com/potter.mp4"}]}}}
Параметры
| Параметр | Значения | По умолчанию |
|---|---|---|
image_url | Стартовый кадр | Обязательно |
last_image_url | Финальный кадр, отправляется вместе с image_url | Необязательно |
prompt | Движение, камера и звук | Обязательно |
duration_seconds | от 4 до 30 | 5 |
resolution | 480p, 720p | 720p |
generate_audio | true, false | true |
watermark | Видимый водяной знак модели | false |
return_last_frame | Дополнительно вернуть последний кадр в JPEG | false |
output_format | mp4, mov | mp4 |
Поля aspect_ratio нет. Документация BytePlus сообщает, что модель сохраняет соотношение сторон результата согласованным со стартовым кадром.
Как работает тарификация
Вы платите за каждую запрошенную секунду, а ставку задаёт разрешение; цена на этой странице показывает и то и другое. Запрос с гончарницей просил 4 секунды, файл получился длиной 4,064 секунды, а списание было за 4. Финальный кадр, звук (включён или выключен), водяной знак, JPEG последнего кадра и формат файла цену не меняют. Неудачные генерации не тарифицируются.
Советы для хорошего результата
- Выберите стартовый кадр, который уже похож на начало. Картинка фиксирует объект, место и свет, поэтому поставьте объект туда, откуда должен начаться кадр.
- Обрезайте перед загрузкой. Наш портретный исходник вернулся как 562×748 в 480p. Обрежьте до 9:16 для вертикали, 1:1 для квадрата или 16:9 для широкого кадра.
- Описывайте движение. Промпт с гончарницей нигде не описывает её одежду или мастерскую. В нём по порядку перечислены действия, затем камера и свет.
- Закончите строкой
Audio:. Перечислите звуки, которые подразумевает картинка, например гул гончарного круга и влажный скрип глины в нашем примере; «no music» оставляет дорожку свободной для вашей музыки. - Используйте
last_image_urlтремя способами. Повторите стартовую картинку для петли или возврата в позу; наш запуск с гончарницей закончился в исходной позе. Отправьте родственную картинку с тем же кадрированием и светом для перехода из A в B и опишите путь. Или не указывайте его вовсе. - Согласуйте два кадра. Держите положение объекта, кадрирование и свет близкими. У нас записан один запуск с петлёй, поэтому проверьте стык в своём плеере, прежде чем рассчитывать на бесшовный повтор.
- Стройте цепочку кадров. Включите
return_last_frameи отправьте JPEG как следующийimage_url.
Что показали наши тесты
13 ноября 2026 года запрос с гончарницей выше (4 секунды, 480p, звук включён) вернул клип 562×748 длительностью 4,064 секунды, а начальный и конечный кадры вернулись к исходной позе. Тот же запрос занял 84 секунды в одном запуске и 4,8 минуты в другом, поэтому рассчитывайте на минуты и используйте опрос статуса или callBackUrl. Более длинные клипы и клипы в 720p занимают больше времени.
Ограничения и ошибки
- Flash рендерит в 480p и 720p; у него нет 1080p, 4K и эндпоинта продления видео.
image_urlиpromptобязательны, аduration_seconds— целое число от 4 до 30. Запрос, нарушающий это, недействителен; исправьте поле и отправьте заново.- Модель выполняет собственную проверку на авторские права и сходство с реальными людьми, которая остановила один из наших запросов text-to-video. Неудавшаяся задача не тарифицируется; измените картинку или формулировку, а не отправляйте тот же запрос повторно.
- Отправляйте изображения, которыми вы владеете или которые лицензированы для такого использования. Не оживляйте фото реального человека без его разрешения и не выдавайте результат за настоящую съёмку.
Когда выбрать соседнюю модель
- Seedance 2.5 image to video — для 1080p или 4K, режима черновика и продления клипа.
- Seedance 2.0 Fast — для предыдущего поколения в 480p и 720p.
- Flash reference to video, когда человек или продукт должен появиться в новой сцене, а не открывать её.
- Flash text to video, когда картинки нет, или Flash video edit, когда есть клип для смены стиля.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.5-flash/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"output_format": "mp4",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.










