Введение
Отправьте video_url (клип длиной до 60 секунд) и промпт о том, что происходит дальше; duration_seconds, resolution, generate_audio, last_image_url и watermark необязательны. Платформа берёт последний кадр клипа, рендерит продолжение через Flash image-to-video и пристыковывает его к вашему материалу, сохраняя частоту кадров и исходную звуковую дорожку клипа.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
| Разработчик | 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, MOV или WebM длиной до 60 секунд и не больше 3840 пикселей по длинной стороне. Не менее 1 символов |
last_image_url | Нет | Необязательное изображение, на котором заканчивается новый отрезок, — для планов, которые должны прийти к заданной позе или композиции. |
resolution | Нет | 480p или 720p для нового отрезка, по умолчанию 720p; посекундный тариф зависит от этого выбора. |
duration_seconds | Нет | Длина нового отрезка в целых секундах, от 4 до 30, по умолчанию 5. Оплачиваются только эти секунды; исходный материал бесплатно стоит перед ними в склеенном файле. |
generate_audio | Нет | Включено по умолчанию: Flash создаёт звук нового отрезка по промпту и изображению, и на стыке он плавно переходит в звуковую дорожку вашего клипа. По умолчанию: |
watermark | Нет | По умолчанию выключено. По умолчанию: |
Стоимость
Оплачивается только новый отрезок, так же как запрос Flash image-to-video: каждая запрошенная секунда по тарифу выбранного разрешения. Исходный клип и склейка ничего не добавляют к цене, звук, финальный кадр и водяной знак её не меняют, а неудачное продление не оплачивается.
| Спецификация | Стоимость |
|---|---|
| $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 одним вызовом
Продление видео Seedance 2.5 Flash добавляет новый материал к клипу, который у вас уже есть. SpicyAPI берёт последний кадр из video_url, передаёт его во Flash image-to-video как стартовое изображение вместе с вашим промптом и приклеивает получившиеся 4–30 секунд к концу вашего материала. Вы получаете MP4, который проигрывается без остановки, и новый отрезок отдельным файлом — оба в 480p или 720p со сгенерированным звуком.
Пример запроса
POST https://api.spicyapi.ai/api/v1/jobs/createTask с заголовком Authorization: Bearer YOUR_SPICY_API_KEY. Ещё пять секунд к шестисекундному клипу:
{
"model": "bytedance/seedance-2.5-flash/video-extend",
"input": {
"video_url": "https://example.com/cyclist.mp4",
"prompt": "The cyclist rests one foot on the curb, the light turns green, and she pushes off out of frame to the left while the camera holds still. Audio: idling traffic, a short bell ring.",
"duration_seconds": 5,
"resolution": "720p"
}
}
Пример ответа
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "queued"}}
Опрашивайте GET /api/v1/jobs/recordInfo?taskId=task_abc123 или передайте callBackUrl. В output.assets сначала идёт склеенный клип (video), затем новая часть (segment); реальная длительность бывает дробной:
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "succeeded", "output": {"assets": [{"url": "https://example.com/joined.mp4", "role": "video", "durationSeconds": 11.0}, {"url": "https://example.com/segment.mp4", "role": "segment", "durationSeconds": 5.0}]}}}
Параметры
| Параметр | Значения | По умолчанию |
|---|---|---|
video_url | MP4, MOV или WebM, до 60 с | Обязательно |
prompt | Что происходит после последнего кадра | Обязательно |
duration_seconds | от 4 до 30, новый отрезок | 5 |
resolution | 480p, 720p | 720p |
generate_audio | true, false | true |
last_image_url | Изображение, на котором заканчивается новый отрезок | Необязательно |
watermark | Отметка модели на новом отрезке | false |
Новый отрезок принимает форму последнего кадра клипа, а склеенный файл всегда в формате MP4.
Как работает тарификация
Новый отрезок стоит столько же, сколько запрос Flash image-to-video: каждая запрошенная секунда по тарифу вашего разрешения. Исходный клип и склейка бесплатны, а звук, финальный кадр или водяной знак не меняют цену. Если продолжение или склейка не удались, деньги за задачу возвращаются полностью.
Советы для хорошего результата
- Заканчивайте исходник на чётком неподвижном кадре. Смаз, склейка или затемнение в последнем кадре перейдут в новый отрезок, поэтому обрезайте на чистом моменте.
- Описывайте продолжение, а не сцену. Кто в кадре и как падает свет, уже задаёт сам кадр.
- Повторяйте движение, которое должно продолжиться. У стоп-кадра нет скорости, поэтому пишите, например, «продолжает идти влево в том же темпе».
- Продумайте звук. Закончите строкой
Audio:, подходящей к атмосфере исходника, или выключитеgenerate_audioи озвучьте позже.
Ограничения и ошибки
- Выход — 480p или 720p; исходник в 1080p принимается, но новая часть на его холсте выглядит мягче.
- Один кадр не передаёт то, что осталось за кадром, инерцию камеры и ритм звуковой дорожки, а свет на стыке может слегка сместиться, поэтому проверьте склейку.
- Исходники длиннее 60 секунд или больше 3840 пикселей по длинной стороне, а также нечитаемые файлы отклоняются без оплаты.
- Вызывайте эндпоинт по полному имени: вызов на уровне семейства с
video_urlпопадает сюда, только если в нём есть ещёduration_seconds,last_image_urlилиwatermark, иначе выполняется редактирование видео. - Продлевайте только свой материал или тот, который вам разрешено использовать, и никогда не продолжайте видео реального человека без его согласия.
Когда выбрать продление флагмана
Продление видео Seedance 2.5 рендерит до 1080p и читает до последних 30 секунд клипа вместо одного кадра, что помогает продолжить движение или голос; эти референсные секунды тоже оплачиваются.
Быстрый старт 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-extend",
"input": {
"duration_seconds": 5,
"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.










