ByteDance
Seedance 2.5 Flash
seedance-2.5-flash/reference-to-video
Серия видеомоделей Seedance 2.5 от ByteDance поддерживает генерацию видео по тексту, генерацию по первому кадру и мультимодальную референсную генерацию; за один раз выдаёт от 4 до 30 секунд видео с выбором 480p или 720p и синхронным звуком — подходит для быстрого создания рекламных роликов и видео о товарах для электронной коммерции
Попробовать seedance-2.5-flash/reference-to-video
Ввод
Работы
Все работыВывод
videoЦены
seedance-2.5-flash/reference-to-video per second
| Характеристики | Цена за единицу |
|---|---|
| 480P | $0.0679 |
| 720P | $0.1525 |
Описание позиционирования
Для разработчиков, которым нужно создавать видео на основе референсных материалов: достаточно ввести подсказку и по порядку указать ссылки на референсные изображения или аудио, чтобы сгенерировать непрерывный по картинке видеоролик. По необходимости можно выбрать разрешение 480p или 720p, соотношение сторон, длительность от 4 до 30 секунд и формат вывода mp4 или mov. Подходит для рекламных роликов, демонстрации товаров и коротких видео для соцсетей — словом, для сценариев, где нужно сохранить стиль уже имеющихся материалов.
Ключевые особенности
- Генерация на основе нескольких референсов — можно использовать до 10 изображений и 5 аудиофрагментов, обращаясь к ним в подсказке по порядку: @image1, @audio1.
- Изображения задают картинку, аудио задаёт ритм — референсные изображения задают внешний вид персонажей, товаров и сцен, а референсное аудио — музыку, ритм или закадровый голос; их можно использовать по отдельности или вместе.
- Гибкий выбор длительности и соотношения сторон — длительность можно задавать с шагом в одну секунду от 4 до 30 секунд; поддерживаются горизонтальный, вертикальный, квадратный и широкоэкранный форматы, а также адаптация под референсные материалы.
- Вывод подходит для постобработки — помимо более совместимого mp4 можно выбрать формат mov, ориентированный на профессиональный монтаж.
Описание возможностей
Референсные изображения задают содержание кадра: можно передать до 10 референсных изображений в форматах jpeg, png, webp, bmp, tiff и gif; каждое не более 30 МБ, каждая сторона — от 300 до 6000 пикселей; в подсказке на них ссылаются через @image1 и т. п.
Длительность задаётся по необходимости: можно указать целое число от 4 до 30 секунд либо -1, чтобы модель сама определила длительность по содержанию; оплата начисляется по секундам готового видео.
Аудиореференсы помогают генерации: можно передать до 5 референсных аудиофрагментов в форматах wav или mp3, каждый длительностью от 2 до 30 секунд и не более 15 МБ, в сумме не более 30 секунд; аудио можно использовать и без референсных изображений.
Настройка соотношения сторон, разрешения и формата: разрешение вывода — 480p или 720p; поддерживаются соотношения 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 и adaptive; формат вывода — mp4 или mov.
Сценарии применения
- Создание роликов для брендов и рекламных команд — на основе имеющихся изображений продукта и фирменной музыки генерируется непрерывный кадр с завязкой, движением камеры и концовкой — для сравнения креативных версий перед запуском рекламы.
- Кадры для демонстрации товаров в электронной коммерции — загрузите несколько изображений товара и перечислите их в подсказке по одному, чтобы сгенерировать видео с демонстрацией или сценами использования — для карточки товара или рекламы в ленте.
- Вертикальные короткие видео для соцсетей — выберите формат 9:16 или 1:1 и сгенерируйте короткое видео на основе изображений и аудио — для регулярного обновления контента на платформах коротких видео и в соцсетях.
- Ролики с музыкой или закадровым голосом — передайте изображения персонажа или товара вместе с референсным аудио, чтобы движение в кадре следовало ритму аудио, — для демонстрационных роликов с музыкой или коротких видео с закадровым голосом.
Ограничения и рекомендации по выбору
Референсных изображений — не более 10, референсных аудио — не более 5 общей длительностью до 30 секунд; при превышении нужно разбить генерацию на несколько запусков. Разрешение вывода — только 480p и 720p, соотношения сторон не включают сверхширокие или произвольные. Одна генерация — максимум 30 секунд; более длинный контент нужно генерировать частями и затем монтировать. На референсные материалы действуют ограничения по формату, размеру и диапазону пикселей; файлы, не соответствующие требованиям, нельзя загрузить.
Видеомодель ByteDance с генерацией на основе референсов
Генерация непрерывного видео на основе референсных материалов
Отправьте подсказку вместе с референсными изображениями или аудио — модель поймёт материалы в порядке ссылок и сгенерирует связный видеоролик. Вывод поддерживает 480p и 720p, разные соотношения сторон и форматы mp4 или mov.
- Тип выводаВидео
- Разрешение480p / 720p
- Длительность4–30 секунд или -1 — авто
- Референсные материалыдо 10 изображений / 5 аудио
Указывайте материалы в подсказке по порядку через @image1, @audio1 и поясняйте, за что отвечает каждый материал.
01
Возможности
Что умеет: три проверяемые возможности
Три возможности ниже соответствуют референсным изображениям, референсному аудио и спецификациям вывода — проверьте ограничения по входным данным по каждому пункту, а затем составляйте подсказку.
Референсные изображения создают основу кадра
Загрузите до 10 изображений в качестве содержательных референсов: поддерживаются распространённые растровые форматы с ограничениями по размеру файла и диапазону пикселей. Ссылайтесь на них в подсказке по порядку через @image1 и т. п., чтобы указать, какое изображение соответствует какому объекту или сцене. Главное — чтобы номера ссылок совпадали с порядком материалов.
Аудиореференсы направляют генерацию
Можно передать до 5 аудиофрагментов в формате wav или mp3, каждый длительностью от 2 до 30 секунд и в сумме не более 30 секунд. Аудио можно использовать отдельно или вместе с изображениями, ссылаясь на него в подсказке через @audio1. Главное — чтобы размер и длительность каждого фрагмента были в пределах ограничений.
Выбор спецификаций и формата вывода
Разрешение выбирается между 480p и 720p; соотношения сторон охватывают горизонтальный, вертикальный, квадратный и широкоэкранный форматы, также можно задать adaptive, чтобы следовать за материалами. Формат вывода — более совместимый mp4 или mov для постобработки. При проверке убедитесь, что соотношение сторон соответствует каналу размещения.
Количество, формат и длительность референсных материалов определяют допустимый диапазон, а порядок ссылок в подсказке определяет, как материалы участвуют в построении кадра.
02
Начало работы
От референсных материалов к видеоролику
Попробовать →Начните с чёткой цели, подготовьте соответствующие требованиям референсные материалы, затем составьте подсказку с номерами ссылок и в конце проверьте готовое видео по спецификациям вывода.
- Референсные изображенияjpeg/png/webp/bmp/tiff/gif, каждое ≤30 МБ
- Референсное аудиоwav/mp3, 2–30 секунд, в сумме ≤30 секунд
Набор референсных материалов, соответствующих ограничениям
01
Подготовьте референсные материалы
Сначала определите, что нужно использовать в качестве референса — изображения или аудио, и отберите файлы с учётом их формата, размера, пикселей и длительности, чтобы не загружать неподдерживаемые типы.
- Подсказкадо 5000 символов, материалы упоминаются по порядку
Подсказка, соотносящая материалы с инструкциями
02
Составьте подсказку со ссылками
Укажите материалы по порядку через @image1, @audio1, опишите содержание и движение в кадре, а также то, с каким фрагментом аудио должно совпадать видео.
✓Проверка
→
03
Задайте параметры вывода и проверьте
Выберите длительность, разрешение, соотношение сторон и формат вывода, затем проверьте, что количество референсных материалов и общая длительность аудио не превышают лимитов.
03
Сценарии
Где применять: три типовых коротких ролика
Сравнение креативных версий рекламных роликов
Используйте изображения продукта и фирменную музыку как референсы, чтобы сгенерировать непрерывный кадр с движением камеры и завершающим действием. Подходит для подготовки нескольких креативных направлений перед запуском; главное — чтобы внешний вид продукта из референсов оставался единообразным в кадре.
Демонстрация товара на странице товара в электронной коммерции
Передайте несколько изображений товара и сошлитесь на каждое в подсказке, чтобы сгенерировать видео с демонстрацией или сценами использования. Готовый ролик можно сразу разместить в карточке товара или в рекламе в ленте; главное — чтобы объект был чётко различим в кадре.
Короткие видео с закадровым голосом или музыкой на основе референсного изображения и аудио
Референсное изображение задаёт персонажа или товар, а референсное аудио — ритм или озвучку; генерируется ролик, в котором картинка следует за аудио. Подходит для видео с закадровым голосом и демонстрационных роликов с музыкой; главное — синхронность движений и ритма аудио.
04
Подключение
Подключение: вызов seedance-2.5-flash в вашем продукте или AI-инструменте
Достаточно одного HiAPI API Key — все способы используют один аккаунт и один биллинг.
- Создайте API Key
- Выберите способ подключения
Выберите один из вариантов справа и скопируйте
- AI-инструменты для программирования рекомендуется
Подключение через MCP в Claude Code, Cursor, Codex и др.
- Прямое подключение к API
Свой продукт, бэкенд-сервисы, автоматизация
- Не знаете, что выбрать
Скопируйте текст для AI — он поможет выбрать и подскажет шаги
Терминал · Claude Code
claude mcp add --transport http hiapi https://mcp.hiapi.ai/mcp \
--header "Authorization: Bearer YOUR_API_KEY"После подключения просто сообщите AI свою цель, чтобы он вызвал seedance-2.5-flash, проверил статус задачи и получил результат. Инструкции по настройке Cursor, Codex и других инструментов — в руководстве ниже.
Посмотреть руководство по подключению Agent →Подключение к вашему продукту через API
С помощью API Key отправьте задачу текущей модели и проверяйте статус по возвращённому ID задачи. Параметры запроса используют те же данные маршрута, что и описание интерфейса на этой странице; замените входные данные из примера на ваши реальные материалы.
# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-flash/reference-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true,
"omni_reference_task_type": "reference"
}
}'Пусть AI поможет выбрать способ подключения
Прочитай индекс документации HiAPI https://hiapi.ai/llms.txt. Я хочу использовать seedance-2.5-flash в проекте. Сначала, исходя из моего сценария использования, определи, что подходит больше — Remote MCP, Agent Skills или прямое подключение к API; при необходимости сначала задай мне один ключевой вопрос, а затем дай минимальные шаги подключения и необходимую конфигурацию.
Скопируйте этот текст в ваш AI-инструмент и добавьте язык проекта, входные материалы и ожидаемый результат. На основе этого он сможет объяснить способ подключения и следующие шаги.
Новости
Смотреть changelog →- Новая модель Запуск seedance-2.5-flash/reference-to-video
- Новая модель Запуск seedance-2.5-flash/image-to-video
- Новая модель Запуск seedance-2.5-flash/text-to-video
Создать задачу генерации
https://api.hiapi.ai/v1/tasks Заголовки
AuthorizationstringОбязательноAPI-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ
Content-TypestringНеобязательноТело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.
Idempotency-KeystringНеобязательноКлюч идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.
При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.
Тело запроса
modelstringОбязательноТекущее фиксированное значение: seedance-2.5-flash/reference-to-video
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для seedance-2.5-flash/reference-to-video и маршрута default — см. таблицу параметров ниже.
promptstringОбязательноminLength 1maxLength 5000Подсказка, задающая порядок использования референсных материалов: ссылайтесь на элементы материалов в порядке их появления в виде @image1, @audio1 и явно указывайте, какую роль играет каждый материал в кадре.
durationintegerНеобязательноПо умолчанию: 5Длительность выходного видео (в секундах): целое число от 4 до 30 или -1 для автоматической длительности; по умолчанию 5 секунд.
-145678910Показать все (20)Свернуть
1112131415161718192021222324252627282930resolutionstringНеобязательноПо умолчанию: "480p"Разрешение выходного видео; Seedance 2.5 Flash поддерживает 480p и 720p; по умолчанию 480p.
480p720paspect_ratiostringНеобязательноПо умолчанию: "adaptive"Соотношение сторон выходного кадра; при значении adaptive модель определяет его по референсным материалам; по умолчанию adaptive.
16:94:31:13:49:1621:9adaptiveoutput_formatstringНеобязательноПо умолчанию: "mp4"Формат файла выходного видео: mp4 — значение по умолчанию для совместимости, mov — для профессионального постпродакшна; по умолчанию mp4.
mp4movgenerate_audiobooleanНеобязательноПо умолчанию: trueСоздавать ли диалоги, звуковые эффекты и фоновое аудио, синхронизированные с изображением; по умолчанию true.
reference_audio_urlsarrayНеобязательноmaxItems 5Массив URL референсного аудио, не более 5 фрагментов; каждый фрагмент должен быть в формате wav или mp3, размером менее 15 МБ, длительностью от 2 до 30 секунд, а общая длительность всех аудиофрагментов не должна превышать 30 секунд. Аудио можно использовать отдельно, без изображений; необходимо предоставить хотя бы один из типов: референсные изображения или референсное аудио.
Array [ string ]
reference_image_urlsarrayНеобязательноmaxItems 10Массив URL референсных изображений, не более 10 штук; поддерживаются форматы jpeg, png, webp, bmp, tiff, gif, каждое изображение размером менее 30 МБ, со стороной от 300 до 6000 пикселей и соотношением сторон от 0.4 до 2.5; форматы SVG, HEIC и HEIF не поддерживаются.
Array [ string ]
omni_reference_task_typestringНеобязательноПо умолчанию: "reference"Тип задачи по референсу; в настоящее время поддерживается только reference (создание нового фрагмента на основе референсного изображения или аудио); по умолчанию reference, можно не передавать.
referencecallbackobjectНеобязательно
Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.
Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.
urlstringОбязательноОбязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.
whenstringНеобязательноПо умолчанию: "final"Сейчас поддерживается только final — уведомление и при success, и при fail.
finalstoragestringНеобязательноПо умолчанию: "temp"Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.
temppersistentПримеры запроса
# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-flash/reference-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true,
"omni_reference_task_type": "reference"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "seedance-2.5-flash/reference-to-video",
input: {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true,
"omni_reference_task_type": "reference"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "seedance-2.5-flash/reference-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": True,
"omni_reference_task_type": "reference"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Получить детали задачи
https://api.hiapi.ai/v1/tasks/:id Поля ответа
taskIdstringОбязательноИдентификатор задачи, всегда с префиксом tk-hiapi-.
modelstringОбязательноПолное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.
routestringНеобязательноПрисутствует только при явном параметре route; повторяет переданное значение.
statusstringОбязательноСтатус задачи.
queued В очереди, ещё не начата.
handling Обрабатывается.
archiving Обработка завершена, готовятся артефакты.
success Терминальное: завершено, артефакты доступны (возвращается output).
fail Терминальное: ошибка (возвращается error).
После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.
creatednumberОбязательноВремя создания задачи (Unix-секунды).
completednumberОбязательноUnix-секунды терминального состояния; до этого — 0.
outputarrayНеобязательно
Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).
Array [ object ]
Элементы массива
urlstringОбязательноURL артефакта, доступен для скачивания напрямую.
typestringОбязательноТекущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.
expireAtnumberОбязательноUnix-секунды доступности артефакта; скачайте или перенесите до истечения.
errorobjectНеобязательно
Только при status == fail.
codestringОбязательноБизнес-код ошибки.
messagestringОбязательноОписание ошибки.
Примеры ответа
Успех
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Обработка (не финальное)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Ошибка
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Статьи
Все статьи →-
Руководство по использованию
Руководство по подключению Seedance 2.5 Flash для генерации видео из изображения: первый кадр, последний кадр и оплата по секундам
Заставьте изображение двигаться: параметры, цены и типичные причины сбоев
-
Руководство по использованию
Руководство по интеграции Seedance 2.5 Flash для генерации видео из текста: параметры, посекундная тарификация и инженерные практики
От одного запроса до стабильного запуска: как задавать параметры и как считать расходы
-
Руководство по использованию
Руководство по подключению генерации видео из референсных материалов Seedance 2.5 Flash: референсные изображения, референсное аудио и правила тарификации
Похожие модели
Все модели →Тот же тип
-
Gemini Omni 1.1 Google $0.450 /видео -
Kling 4.0 Flash Kuaishou $0.122 /секунду -
Wan 3.0 Video Alibaba $0.040 /секунду -
Runway Gen 4.5 Runway $0.172 /секунду -
Grok Imagine 1.5 Lite xAI $0.029 /секунду -
Ray 3.2 Luma $0.214 /видео -
Gemini Omni 1.2 Google $0.023 /секунду -
Creatify Boreal Creatify $0.015 /секунду -
LTX 2.5 Fast Lightricks $0.086 /секунду -
Muse Video 1.0 Meta $0.034 /видео -
Veo 3.1 Lite Google $0.060 /секунду -
Veo 3.1 Fast Google $0.170 /секунду





