Введение
Отправьте video_url и prompt; reference_image_urls, reference_audio_urls, resolution и generate_audio необязательны. Результат следует исходному клипу, поэтому в запросе нет поля длительности. При выключенном generate_audio оригинальный звук вашего клипа остаётся в результате.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
| Разработчик | 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 символов |
video_url | Да | Ссылка на MP4, который вы хотите отредактировать, длиной от 4 до 30 секунд; всё за пределами этого диапазона отклоняется до какого-либо списания. Не менее 1 символов |
reference_image_urls | Нет | До 10 необязательных изображений с нужным образом, например одежда, предмет или цветовая палитра. Не менее 1 элементов · Не более 10 элементов |
reference_audio_urls | Нет | До 5 необязательных аудиофайлов, 30 секунд вместе, которые направляют звуковую дорожку, создаваемую моделью, к нужному голосу или настроению. Не менее 1 элементов · Не более 5 элементов |
resolution | Нет | 480p или 720p, по умолчанию 720p. Отладьте формулировку в 480p, затем повторите утверждённый промпт в 720p; выбор задаёт посекундную ставку, применяемую к длине исходника. |
generate_audio | Нет | true (по умолчанию) пишет новую звуковую дорожку для отредактированной картинки, а false сохраняет собственный звук вашего клипа. По умолчанию: |
Стоимость
Оплата за секунду загруженного исходного клипа (4–30 с, с округлением вверх) по ставке 480p или 720p, какой бы длины ни вернулся результат. Референсные изображения, референсное аудио и переключатель звука списание не меняют, а задача, завершившаяся ошибкой, не тарифицируется.
| Спецификация | Стоимость |
|---|---|
| $0.18 / секунду |
| $0.36 / секунду |
Сценарии использования
Проверка плана кадра перед финальным рендером
Отправьте промпт на 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 video edit
Seedance 2.5 Flash video edit — задача редактирования по инструкции в ускоренной видеомодели ByteDance: загрузите клип длиной от 4 до 30 секунд, опишите, что должно выглядеть иначе, и получите его перерендеренным в 480p или 720p. Типичные цели — погода, время суток, гардероб и реквизит; людей, их движение и путь камеры вы просите модель сохранить.
BytePlus, облачная платформа ByteDance, описывает Flash как «результат, близкий к флагманской Seedance 2.5, при почти вдвое большей скорости генерации». Здесь у переключателя звука две роли: generate_audio: false сохраняет собственную звуковую дорожку клипа, а true пишет новую, которая может следовать приложенному голосовому файлу.
Пример запроса
Это правка со снегопадом из наших тестов. Отправьте её как POST https://api.spicyapi.ai/api/v1/jobs/createTask с Authorization: Bearer YOUR_SPICY_API_KEY, как описано в руководстве по API задач.
{
"model": "bytedance/seedance-2.5-flash/video-edit",
"input": {
"prompt": "Turn the sunny afternoon into a snowy winter evening: fresh snow on the rooftops, balconies and cobblestones, snowflakes drifting through the air and warm light in the windows. Keep both riders, their bikes, their clothes, their movement, the tram and the camera move exactly as in the source video.",
"video_url": "https://example.com/tram-street.mp4",
"resolution": "480p",
"generate_audio": false
}
}
Пример ответа
Отправка возвращает идентификатор задачи. Опрашивайте GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID или передайте callBackUrl; завершённая задача перечисляет отредактированный MP4.
{ "code": 200, "msg": "success", "data": { "taskId": "YOUR_TASK_ID", "state": "queued" } }
{ "code": 200, "msg": "success", "data": { "taskId": "YOUR_TASK_ID", "state": "succeeded",
"output": { "assets": [ { "url": "https://example.com/edited-tram-street.mp4" } ] } } }
Таблица параметров
prompt и video_url обязательны.
| Параметр | Значения / по умолчанию | Что делает |
|---|---|---|
prompt | Обязательно, до 20 000 символов | Изменение, затем то, что должно остаться |
video_url | Обязательно, MP4, 4–30 с | Клип для редактирования |
reference_image_urls | До 10 | Целевые образы, называются @Image 1, @Image 2 |
reference_audio_urls | До 5, 30 с вместе | Голос или настроение, называется @Audio 1 |
resolution | 480p или 720p, по умолчанию 720p | Размер результата |
generate_audio | По умолчанию true | Новый звук (true) или звук исходника (false) |
Как работает тарификация
Списание зависит от клипа, который вы загружаете, а не от клипа, который получаете. Секунды исходника (от 4 до 30, с округлением вверх) оцениваются по ставке выбранного разрешения, показанной на этой странице; исходник 4,0 с, вернувшийся как 3,712 с, оплачивается как 4. Референсы и переключатель звука ничего не меняют, а задача, завершившаяся ошибкой, не тарифицируется.
Советы для хорошего результата
- Сначала изменение, затем список сохраняемого. В наших запусках сработало одно предложение об изменении плюс оборот с перечнем всего, что должно уцелеть. Dreamina, творческое приложение ByteDance, советует сначала зафиксировать внешность, гардероб, путь камеры и тайминг; подойдёт любой порядок, если написаны обе половины.
- Называйте видимые последствия. Промпт со снегопадом перечисляет, что делает снег в кадре: покрытые крыши, летящие в воздухе снежинки, тёплый свет в окнах. Одно лишь «make it winter» не называет ни одной поверхности.
- Меняйте одно за проход. Погода и свет — одна смена сцены; добавьте новую куртку вторым проходом, чтобы увидеть, какая фраза что сделала.
- Заранее выберите настройку звука. Выключенный звук защищает диалог или музыку, которые вы хотите сохранить. Включённый подходит для картинки, которой нужен новый звук: приложите голосовой файл как @Audio 1 и добавьте строку
Audio:. - Проверяйте покадрово. В анонсе Seedance 2.5 от ByteDance сказано, что сложное движение и сцены с несколькими взаимодействующими объектами ещё совершенствуются, поэтому просматривайте насыщенные моменты шаг за шагом. Референсные изображения («the jacket from @Image 1») в наших запусках не участвовали; попробуйте их на 4-секундной нарезке.
Что показали наши тесты
13 ноября 2026 года мы дважды отредактировали в 480p клип длиной 4,0 секунды: солнечная улица с двумя велосипедистами и трамваем.
| Запуск | Настройки | Результат | От отправки до завершения |
|---|---|---|---|
| Снегопад, звук сохранён | Промпт про снежный вечер, звук выключен | 854×480, 4,000 с; велосипедисты, трамвай и камера совпадают с исходником кадр в кадр, погода и свет изменились, исходная дорожка сохранена (44,1 кГц) | 3,7 мин |
| Снегопад, новый голос | Тот же промпт, голосовой файл как @Audio 1, звук включён | 3,712 с; то же качество правки; новая звуковая дорожка | 7,8 мин |
Во всех четырёх эндпоинтах Flash в тот день 4-секундные клипы в 480p занимали от 84 секунд до примерно 11 минут. Два запуска правки не могут подтвердить заявление BytePlus о «почти вдвое», поэтому рассчитывайте на минуты и ожидайте, что более длинные клипы и 720p займут больше времени.
Ограничения и ошибки
- Длина исходника. Клип короче 4 или длиннее 30 секунд отклоняется при отправке, ничего не списывается. Обрежьте его или разделите длинный клип на части и повторите список сохраняемого для каждой.
- Длина результата. Поля длительности нет. При включённом звуке результат может выйти чуть короче (здесь 3,712 с из 4,0 с); для точной длины редактируйте с выключенным звуком и добавляйте звук в своём редакторе.
- Разрешение. 480p и 720p; ByteDance указывает 1080p и 4K как не поддерживаемые во Flash.
- Проверки модели. Модель применяет собственные проверки на авторские права и сходство с реальными людьми и может отклонить или смягчить запрос. Заблокированная задача завершается ошибкой без списания: переформулируйте её, уберите названных людей или бренды и отправьте снова.
- Права и хранение. Редактируйте материал и голоса, на использование которых у вас есть права. Готовые файлы хранятся 14 дней.
Когда выбрать соседнюю модель
- Video edit в Seedance 2.5 для финальной выдачи выше 720p; флагман редактирует до 1080p. Прочитайте его заметку о звуке, прежде чем переносить настройку отсюда.
- Seedance 2.5 Flash reference-to-video, чтобы построить новую сцену вокруг движения камеры клипа (@Video 1), а не переписывать клип.
- Продление видео в Seedance 2.5, когда кадр должен продолжиться после последнего кадра.
- Seedance 2.0 Fast — ускоренная версия предыдущего поколения в 480p и 720p, для продления или работы с текстом, изображениями и референсами.
Быстрый старт 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/video-edit",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.










