Введение
Отправьте один prompt, чтобы получить 5-секундный клип 720p в 16:9 со звуком, или добавьте duration_seconds, resolution, aspect_ratio, generate_audio, watermark, return_last_frame и output_format для настройки. Загружать ничего не нужно.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Видео |
| Разработчик | 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 | Да | Напишите объект, одно главное действие, движение камеры, свет и завершающую строку Audio:, где перечислено, что слышно; тестовый промпт следовал этому порядку, и клип ему соотве… Не менее 1 символов · Не более 20000 символов |
aspect_ratio | Нет | 16:9 (по умолчанию), 9:16, 4:3, 3:4, 1:1, 21:9 или adaptive, при котором формат кадра выбирает модель. |
resolution | Нет | 480p или 720p, по умолчанию 720p. Горизонтальный запрос в 480p вернул 854×480, поэтому отладьте кадр в 480p и повторите удачный промпт в 720p. |
duration_seconds | Нет | Целые секунды от 4 до 30, по умолчанию 5, оплата по запрошенному значению. |
generate_audio | Нет | По умолчанию true: речь, эффекты и атмосфера из промпта создаются вместе с картинкой, и наш тест вернул стереодорожку AAC. False возвращает немой файл по той же цене. По умолчанию: |
output_format | Нет | mp4 (по умолчанию) или mov. |
return_last_frame | Нет | По умолчанию false. По умолчанию: |
watermark | Нет | По умолчанию false. По умолчанию: |
Стоимость
Оплата за каждую запрошенную секунду по ставке 480p или 720p; запрос на 4 секунды, вернувший 4,06 секунды, оплачивается как 4. Звук, соотношение сторон, водяной знак, последний кадр и формат файла на цену не влияют, неудачные запросы не тарифицируются.
| Спецификация | Стоимость |
|---|---|
| $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 text-to-video: клип из письменного описания кадра
Seedance 2.5 Flash text-to-video — ускоренная версия Seedance 2.5 от ByteDance для генерации по одному промпту: вы отправляете текст и получаете клип длиной от 4 до 30 секунд в 480p или 720p, где речь, эффекты и атмосфера создаются за тот же проход. BytePlus, облачная платформа ByteDance, сообщает, что Flash даёт результат, близкий к флагману, при почти вдвое большей скорости генерации, и указывает, что 1080p и 4K для него не поддерживаются.
Пример запроса
Создайте задачу с публичным именем bytedance/seedance-2.5-flash/text-to-video. Отправьте POST https://api.spicyapi.ai/api/v1/jobs/createTask с заголовками Authorization: Bearer YOUR_SPICY_API_KEY и Content-Type: application/json; опрос статуса и колбэки описаны в руководстве по API задач.
{
"model": "bytedance/seedance-2.5-flash/text-to-video",
"input": {
"prompt": "A young woman in a yellow raincoat sprints across a rain-soaked city crosswalk at night, neon signs reflected in the wet asphalt. She ducks under a shop awning, pushes back her hood and laughs, shaking water from her hair. Handheld tracking shot at street level. Audio: heavy rain on pavement, a passing car hissing through puddles, her breathless laugh.",
"duration_seconds": 4,
"resolution": "480p",
"aspect_ratio": "16:9",
"generate_audio": true,
"return_last_frame": true
}
}
Пример ответа
После отправки возвращается задача в состоянии queued; опрашивайте GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID (или передайте callBackUrl), пока состояние не станет succeeded.
{"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/clip.mp4"}]}}}
Если включён return_last_frame, завершённая задача возвращает также JPEG последнего кадра.
Параметры
| Параметр | Значения | По умолчанию |
|---|---|---|
prompt | Текстовое задание | Обязательно |
duration_seconds | от 4 до 30 | 5 |
resolution | 480p, 720p | 720p |
aspect_ratio | 16:9, 9:16, 4:3, 3:4, 1:1, 21:9, adaptive | 16:9 |
generate_audio | true, false | true |
watermark | true, false | false |
return_last_frame | true, false | false |
output_format | mp4, mov | mp4 |
Как работает тарификация
Text-to-video тарифицируется за каждую запрошенную секунду по ставке выбранного разрешения, а страница показывает цену одной секунды. Запрос на 4 секунды вернулся как 4,064 с и был оплачен как 4. Звук, соотношение сторон, водяной знак, последний кадр и формат на цену не влияют; неудачная генерация не тарифицируется.
Как описать кадр одним текстом
Порядок в промпте. Начните с объекта и его одного главного движения, затем камера, свет и звук. BytePlus перечисляет объект, действие, сцену, визуальный стиль, камеру и звук и отмечает, что ненужные части можно опустить; Dreamina советует делать промпты для Flash краткими и сфокусированными на одном ясном действии. Тестовый промпт остаётся на одной улице: жёлтый плащ, бег в укрытие, ручная следящая съёмка, неон на мокром асфальте.
Звук. Заканчивайте строкой Audio:, где источники перечислены простыми словами. Для речи берите слова в кавычки и называйте язык и тон перед ними — это правило BytePlus для диалогов не на китайском. BytePlus также описывает скобки для музыки, эффектов и диалогов; мы проверяли лишь простую строку.
Формат кадра. 16:9 подходит для горизонтальных плееров, 9:16 — для вертикальных лент, 1:1, 4:3 или 3:4 — для сеток, а 21:9 — для широких кадров. adaptive оставляет выбор за моделью, что удобно на ранних пробах; задавайте фиксированное соотношение, когда его ожидает шаблон.
Длительность. В нашем 4-секундном тесте уместились три момента: бег, укрытие, смех. Для 8–15 секунд спланируйте два-три момента с одной идеей камеры. Для 16–30 секунд пишите строки с временными диапазонами (0-8 s: ..., 8-20 s: ...); ByteDance Seed сообщает, что промпты могут управлять повествованием, камерой и ритмом на заданном отрезке времени. Мы запускали лишь 4-секундные запросы, поэтому проверяйте более длинные планы в 480p, прежде чем переходить к 720p.
Цепочка. Установите return_last_frame в true, затем передайте возвращённый JPEG как image_url в bytedance/seedance-2.5-flash/image-to-video с промптом для следующего момента; стартовое изображение задаёт форму, поэтому кадр 16:9 продолжится в 16:9. Каждый клип получает свою звуковую дорожку, поэтому повторяйте формулировку Audio:. Многие генераторы замедляют движение ближе к концу клипа, так что запросите на секунду больше нужного и обрежьте.
Настройки файла. Берите mp4 для воспроизведения и mov для монтажного таймлайна; BytePlus описывает mov как видео H.264 с цветовой субдискретизацией yuv444p и звуком PCM. Держите watermark выключенным, если платформа не требует отметку: по сведениям BytePlus, он добавляет в правый нижний угол метку об ИИ-генерации.
Что показали наши тесты
| Запуск (13 нояб. 2026) | Результат |
|---|---|
| 4 с, 480p, 16:9, звук включён | 854×480, 24 к/с, 4,064 с, стерео AAC; она перебегала дорогу, пряталась под навесом и смеялась, как написано. Готово за 2,6 минуты в одном запуске, около 11 минут в другом. |
То же плюс return_last_frame | MP4 и JPEG 854×480 с последним кадром. |
Во всех четырёх эндпоинтах Flash 4-секундные запуски в 480p занимали от 84 секунд до примерно 11 минут, поэтому ускорение мы подтвердить не можем; более длинные клипы и клипы в 720p занимают больше времени. Мы не запускали полную цепочку из нескольких кадров и не тестировали mov. Повторная отправка запускает второй рендер, поэтому дождитесь первой задачи.
Ограничения и ошибки
- Значения вне диапазона от 4 до 30 секунд, не
480pили720pи не из списка соотношений сторон отклоняются при отправке. - Модель выполняет собственную проверку на авторские права и сходство с реальными людьми, и один из наших текстовых запросов она остановила. Перепишите задание с вымышленным персонажем вместо названного человека или защищённого персонажа; неудавшаяся задача содержит сообщение об ошибке и не тарифицируется.
- ByteDance Seed сообщает, что у сложной физики движения и сцен с несколькими взаимодействующими объектами ещё есть куда расти, поэтому держите в кадре один-два объекта.
- У Flash нет эндпоинтов 1080p, 4K и продления видео. Готовые файлы доступны 14 дней.
Когда выбрать другой эндпоинт или модель
- Seedance 2.5: выдача выше 720p, 4K, продление клипа или схема «черновик, затем апскейл».
- Seedance 2.0 Fast: ускоренная версия предыдущего поколения в 480p и 720p, с эндпоинтом продления, которого у Flash нет.
- Flash image-to-video: кадр должна открывать картинка, или вы продолжаете с возвращённого последнего кадра.
- Flash reference-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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"output_format": "mp4",
"duration_seconds": 5
}
}'
# 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.










