ByteDance

Seedance 2.5

seedance-2.5/image-to-video

Совместная аудио-видео модель генерации от Byte Seed, поддерживает непрерывные фрагменты длительностью до 30 секунд и разрешением до 4K, а также точное управление изображением на основе мультимодальных референсов и редактирования с точностью до временных меток

seedance-2.5/image-to-video seedance-2.5/reference-to-video seedance-2.5/text-to-video

Попробовать seedance-2.5/image-to-video

Ввод

Работы

Все работы

Вывод

video

Заполните параметры и сгенерируйте — результаты появятся здесь.

От ключевого кадра к раскадровке: пример преобразования изображения в движение в Seedance 2.5

Стиль Раскадровка · Кинематографичный · Изображение в видео

Референсные входы

first_frame_url

Промпт

Начиная со статичного ключевого кадра раскадровки, медленный кинематографичный наезд камеры: одинокая фигура в длинном пальто стоит в конце залитого дождём ночного переулка, неоновые вывески отражаются на мокром асфальте. Камера продвигается вперёд в стабильном ритме с лёгким дыханием ручной съёмки, затем плавно переходит в мягкое дуговое движение, раскрывая глубину переулка. Дождь продолжает падать, в лужах под ногами расходятся круги, из вентиляционных отверстий поднимается пар. Холодные бирюзово-зелёные и пурпурные огни с тёплыми акцентами натриевых ламп; малая глубина резкости, блики анаморфной оптики, тонкая плёночная зернистость. Городской гул окружения, далёкий шум транспорта и непрерывный стук дождя по металлу. Сдержанно, эмоционально, одним планом, без монтажа.

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Seedance 2.5 видео из изображения: расширение кадра на основе первого кадра

Стиль Изображение в видео · Движение камеры · Изображение продукта

Референсные входы

first_frame_url

Промпт

Сгенерировать видео из одного статичного изображения продукта. Камера: медленное круговое движение на 15 градусов вокруг объекта в сочетании с мягким наездом, вид на уровне глаз, эквивалент объектива 35 мм, малая глубина резкости остаётся постоянной. Освещение: мягкий основной свет слева сверху постепенно усиливается, тонкий контурный свет скользит по поверхности, по мере дугового движения камеры размытый фон слегка смещается. Движение: мелкие волокна ткани и пылинки медленно дрейфуют, лёгкий блик перемещается по поверхности product. Аудио: низкий фоновый шум помещения, при движении камеры сопровождаемый мягким свистящим звуком, примерно на третьей секунде — тихий металлический отзвук. Сохранять компактную композицию и стабильность изображения; без монтажа, один непрерывный длинный план.

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Цены

seedance-2.5/image-to-video per second

Характеристики	Цена за единицу
720P	$0.204
1080P	$0.516

Краткое описание

Линия Seedance 2.5 «изображение в видео» предназначена для разработчиков, которым нужен точный контроль над кадром: отправной точкой служит изображение первого кадра, при необходимости конечный кадр задаёт точку завершения, а с помощью промпта описываются движение, камера и сцена; на выходе получается связное видео длительностью от 4 до 30 секунд. Модель одновременно с генерацией изображения создаёт синхронизированную речь, звуковые эффекты и окружающие звуки, а также поддерживает вывод в 720p и 1080p и два формата контейнера — mp4 и mov. Подходит, когда уже есть статичные материалы и нужно расширить их до коротких видео: демонстрация товара, превизуализация рекламных кадров и серийное производство контента.

Ключевые особенности

Двусторонняя привязка кадра по первому и последнему кадрам — задайте первый кадр и, при желании, конечный кадр, чтобы и начало, и конец сгенерированного видео опирались на имеющиеся материалы, что сокращает число повторных генераций.
Изображение и звук за одну генерацию — по умолчанию одновременно создаются речь, звуковые эффекты и фоновое аудио, отдельная озвучка и её синхронизация не нужны.
Промпты на одиннадцати языках — команды движения, камеры, сцены и аудио можно писать на разных языках, что удобно для многоязычных команд.
Выбор разрешения и контейнера — поддерживаются 720p и 1080p, mp4 и mov; mov удобен для профессионального постпродакшена.

Описание возможностей

Генерация видео от первого кадра: видео создаётся от изображения первого кадра в форматах jpeg, png, webp и других; пропорции кадра подстраиваются под первый кадр, что подходит для продолжения работы с уже утверждёнными статичными изображениями.

Контроль точки завершения по конечному кадру: можно приложить изображение конечного кадра, чтобы задать финальную картинку видео; при несовпадении пропорций выполняется центральная обрезка под первый кадр, что удобно для кадров с точной точкой завершения.

Синхронная генерация аудио: по умолчанию создаются синхронизированные с изображением речь, звуковые эффекты и фоновый звук; функцию можно отключить, чтобы получить чистый видеоматериал для последующей обработки.

Параметры длительности и качества: длительность задаётся целым числом от 4 до 30 секунд, тарификация идёт по запрошенной длительности; разрешение выбирается между 720p и 1080p, вывод — mp4 или mov.

Дополнение данных из интернета: можно включить поиск в интернете, чтобы при генерации учитывалась актуальная информация, упомянутая в промпте.

Сценарии применения

E-commerce и продуктовые команды: финальные снимки товара — из статичного изображения товара как первого кадра создаётся демонстрационный ролик; изображение и звук генерируются синхронно, материал можно сразу использовать на странице товара или в рекламе.
Креативные рекламные команды: ключевые кадры раскадровки — ключевые кадры раскадровки расширяются до фрагментов с движением камеры и звуковыми эффектами для презентаций и превизуализации перед съёмкой.
Операторы бренд-контента: утверждённые изображения персонажей и сцен — утверждённые изображения персонажей или сцен расширяются до серии коротких видео с сохранением единого облика и массовым выпуском контента для соцсетей.
Постпродакшен: достройка кадров между первым и последним кадром — по заданным начальному и конечному изображениям генерируется промежуточный процесс для стыковки материалов или дополнения переходных кадров.

Ограничения и рекомендации по выбору

Максимальная длительность одного сгенерированного фрагмента — 30 секунд; более длинный контент нужно разбивать на несколько фрагментов и генерировать по отдельности. Физическая достоверность сложных движений и стабильность взаимодействия нескольких объектов по-прежнему остаются известными слабыми местами; для кадров с большой амплитудой движения или большим числом персонажей рекомендуется сначала проверять на небольших образцах. Если заданы и первый, и последний кадры, добавлять референсные изображения или референсное аудио уже нельзя; при необходимости нескольких референсных ограничений следует перейти на линию «изображение в видео по референсу». Для лёгких задач с одним кадром и невысокими требованиями к управляемости можно выбрать более простую линию «текст в видео».

Частые вопросы

Все частые вопросы →

Нужно ли загружать и первый, и последний кадр для генерации видео из изображения в Seedance 2.5?

Нет. В режиме первого кадра или первого и последнего кадров при загрузке только first_frame_url модель естественно продолжает сцену от первого кадра; если нужно контролировать конечное состояние кадра, дополнительно укажите last_frame_url. Последний кадр нельзя использовать отдельно. Также можно вместо этого использовать reference_image_urls или reference_audio_urls в режиме референса, не передавая граничные кадры.
Можно ли смешивать первый кадр, первый и последний кадры и несколько референсных материалов в одном запросе?

В настоящее время HiAPI Playground обрабатывает их как два способа ввода: режим первого кадра/первого и последнего кадров либо режим референсов reference_image_urls, reference_audio_urls. Чтобы избежать конфликта управляющих сигналов, сохраняйте один способ на каждый запрос; если требуется референсное видео для задания движения или движения камеры, используйте отдельный seedance-2.5/reference-to-video.
Какие длительности и разрешения поддерживаются для генерации видео из изображения в Seedance 2.5?

Текущий контракт запроса поддерживает целочисленную длительность от 4 до 30 секунд, а также разрешения 720p и 1080p. Выходной параметр aspect_ratio фиксирован как adaptive и наследует соотношение сторон первого кадра. Все четыре примера на странице — в 720p, из них три длительностью 4 секунды и один — 5 секунд; 30 секунд входит в поддерживаемый интерфейсом диапазон, но соответствующего примера на странице пока нет.
Как тарифицируется генерация видео из изображения в Seedance 2.5?

Тарификация зависит от длительности выходного видео и разрешения: для 720p и 1080p действуют разные тарифы за секунду; точные суммы указаны в актуальных ценах на странице модели и в записях задач.

Создать задачу генерации

POST 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/image-to-video

routestringНеобязательно

Текущее фиксированное значение: default

inputobjectОбязательно

Объект бизнес-параметров для seedance-2.5/image-to-video и маршрута default — см. таблицу параметров ниже.

promptstringОбязательноminLength 1maxLength 10000

Выдайте инструкции по генерации, касающиеся действий, камеры, сцены и аудио; поддерживается несколько языков промптов.

durationintegerНеобязательноПо умолчанию: 5min 4max 30

Длительность выходного видео в секундах; укажите целое число от 4 до 30, по умолчанию 5. HiAPI тарифицирует по запрошенной длительности.

watermarkbooleanНеобязательноПо умолчанию: false

Добавлять ли водяной знак AI-генерации в правый нижний угол изображения, по умолчанию false.

resolutionstringНеобязательноПо умолчанию: "720p"

Разрешение выходного видео: поддерживаются 720p и 1080p, по умолчанию 720p.

Варианты:720p1080p

web_searchbooleanНеобязательноПо умолчанию: false

Разрешать ли модели искать в интернете актуальную информацию, упомянутую в промпте, по умолчанию false.

aspect_ratiostringНеобязательноПо умолчанию: "adaptive"

Соотношение сторон выходного изображения; для генерации видео из изображения используется адаптивный режим, чтобы видео следовало за первым кадром, по умолчанию adaptive.

Варианты:adaptive

output_formatstringНеобязательноПо умолчанию: "mp4"

Формат файла выходного видео: mp4 — значение по умолчанию с лучшей совместимостью, mov — для профессионального постпродакшена, по умолчанию mp4.

Варианты:mp4mov

generate_audiobooleanНеобязательноПо умолчанию: true

Генерировать ли синхронные диалоги, звуковые эффекты и фоновое аудио, по умолчанию true.

last_frame_urlstringНеобязательно

Необязательно: укажите изображение последнего кадра; можно передать URL изображения, data URL или ID материала. Ограничения на файл такие же, как для первого кадра; если соотношение сторон отличается от первого кадра, изображение обрезается по центру для выравнивания с первым кадром.

first_frame_urlstringНеобязательно

Изображение первого кадра; можно передать URL изображения, data URL или ID материала. Поддерживаются различные распространённые форматы изображений, размер не более 30 МБ, каждая сторона 300–6000 пикселей, соотношение сторон 0,4–2,5. Обязательно, если указан last_frame_url.

reference_audio_urlsarrayНеобязательноmaxItems 10

Массив URL референсного аудио, максимум 10 записей; поддерживаются wav, mp3, каждая запись не более 15 МБ и длительностью 2–30 секунд, суммарная длительность не более 30 секунд.

Array [ string ]

reference_image_urlsarrayНеобязательноmaxItems 30

Массив URL референсных изображений, максимум 30 записей; поддерживаются различные распространённые форматы изображений, каждое не более 30 МБ, каждая сторона 300–6000 пикселей, соотношение сторон 0,4–2,5.

Array [ string ]

callbackobjectНеобязательно

Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.

Обратные вызовы (Webhook)

Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.

urlstringОбязательно

Обязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.

whenstringНеобязательноПо умолчанию: "final"

Сейчас поддерживается только final — уведомление и при success, и при fail.

Варианты:final

storagestringНеобязательноПо умолчанию: "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/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "watermark": false,
    "resolution": "720p",
    "web_search": false,
    "aspect_ratio": "adaptive",
    "output_format": "mp4",
    "generate_audio": true
  }
}'

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/image-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "watermark": false,
      "resolution": "720p",
      "web_search": false,
      "aspect_ratio": "adaptive",
      "output_format": "mp4",
      "generate_audio": true
    }
  }),
});
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/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "watermark": False,
          "resolution": "720p",
          "web_search": False,
          "aspect_ratio": "adaptive",
          "output_format": "mp4",
          "generate_audio": True
        }
    },
)
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"
}

Получить детали задачи

GET 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"
    }
  }
}