Руководство по использованию
Руководство по подключению Seedance 2.5 Flash для генерации видео из изображения: первый кадр, последний кадр и оплата по секундам
Заставьте изображение двигаться: параметры, цены и типичные причины сбоев
- Модель
- seedance-2.5-flash
На этой странице
Что делает эта модель
seedance-2.5-flash/image-to-video — это модель ByteDance для генерации видео из изображения: вы загружаете изображение в качестве первого кадра, и модель генерирует на его основе непрерывный видеоролик, одновременно создавая аудио. Соотношение сторон наследуется от первого кадра, без повторного кадрирования.
Она подходит для сценариев с детерминированным исходным материалом: динамичная демонстрация товарных изображений, микровыражения и движения тела персонажей-иллюстраций, динамичная раскадровка эскизов, короткие ролики для массового наполнения контент-пула. Она не подходит для задач «одним предложением сгенерировать полноценный сюжет» — это задача линии text-to-video.
Параметры запроса
- prompt (обязательный): описание желаемых действий, движения камеры, сцены и звука, длина до 5000 символов.
- first_frame_url (обязательный): изображение первого кадра. Поддерживаются jpeg, png, webp, bmp, tiff, gif, heic, heif, размер одного файла не более 30 МБ, каждая сторона от 300 до 6000 пикселей, соотношение сторон от 0.4 до 2.5.
- last_frame_url (необязательный): изображение последнего кадра, ограничения те же, что и для первого кадра; при несовпадении пропорций выполняется центрированное кадрирование с выравниванием. Если передан последний кадр, обязательно должен быть передан и первый.
- resolution:
480pили720p, по умолчанию480p. - duration: целое число от 4 до 30, по умолчанию 5, единица измерения — секунды.
- aspect_ratio: принимается только
adaptive, выходное соотношение сторон наследуется от изображения первого кадра. - output_format:
mp4(по умолчанию) илиmov. - generate_audio: по умолчанию
true.
Оплата по секундам
- 480p: $0.0679/сек
- 720p: $0.1525/сек
Количество оплачиваемых секунд равно запрошенному duration. Типичные варианты: 480p 4 секунды $0.2716, 720p 4 секунды $0.61, 480p 10 секунд $0.679, 720p 10 секунд $1.525. Сами изображения первого и последнего кадра дополнительно не оплачиваются.
Поскольку оплата идёт по секундам, повторная попытка — это повторная оплата. Оценивать «подходит ли первый кадр» до отправки запроса гораздо дешевле, чем переделывать после генерации.
Первый кадр определяет потолок результата
Модель может развивать только ту информацию, которая уже есть в первом кадре, поэтому качество первого кадра почти полностью определяет потолок результата:
- Субъект чёткий и занимает разумную долю кадра — если субъект слишком мал, модели трудно понять, что именно должно двигаться.
- Избегайте сильной размытости и шума — низкокачественный ввод будет усилен в каждом кадре.
- Обратите внимание на края кадра: обрезанный субъект при движении легко деформируется.
- Текст внутри кадра трудно сохранить стабильным при движении, если только он изначально не является второстепенным.
- Подготовить несколько кандидатов первого кадра с одним и тем же субъектом эффективнее, чем многократно править промпт.
Длительность — это и стоимость, и переменная качества
Чем длиннее фрагмент, тем больше кадров модели нужно удерживать согласованными, тем выше вероятность накопления дрейфа и искажений. Рекомендуется сначала проверить на 4–5 секундах, работают ли первый кадр и направление движения, и только после подтверждения удлинять по необходимости; длинный контент лучше организовывать как «несколько коротких роликов + постпродакшн-склейка», а не полагаться на одну длинную генерацию.
Типичные сбои и порядок диагностики
- Ошибка параметров при отправке: сначала проверьте, не превышены ли ограничения изображения (размер файла, длина сторон, соотношение сторон, формат), а также не передан ли только
last_frame_urlбез первого кадра. - Деформация субъекта в кадре: чаще всего первый кадр содержит слишком маленький субъект, обрезанные края или требования к движению слишком велики. Смените первый кадр или опишите движение более сдержанно.
- Пропорции не соответствуют ожиданиям: эта линия фиксирована на
adaptive, вывод наследует первый кадр; если нужен 16:9 или 9:16, задайте это на первом кадре. - Контент заблокирован: сам первый кадр также проходит проверку на соответствие требованиям, то, что есть на изображении, напрямую определяет, возможен ли вызов.
- Клиент превысил тайм-аут, но задача на самом деле выполнена: генерация видео занимает много времени, слишком короткий тайм-аут клиента приведёт к тому, что успех будет принят за ошибку, а повторная отправка вызовет повторную оплату. Обрабатывайте как асинхронную задачу и задавайте достаточный тайм-аут.
Рекомендации перед запуском
Сначала прогоните сквозной сценарий на трёх–пяти первых кадрах разных типов, убедитесь, что отправка, опрос статуса и скачивание работают полностью; затем зафиксируйте первый кадр и меняйте только промпт, чтобы понять, на какие описания действий модель реагирует хорошо; в конце масштабируйте пропорционально, следя за долей успешных вызовов, средним временем выполнения и долей повторных попыток. Параметры и цены ориентируйтесь на текущее описание на странице модели.
Похожие статьи
Все статьи →-
Руководство по использованию
Руководство по подключению генерации видео из референсных материалов Seedance 2.5 Flash: референсные изображения, референсное аудио и правила тарификации
-
Руководство по использованию
Руководство по интеграции Seedance 2.5 Flash для генерации видео из текста: параметры, посекундная тарификация и инженерные практики
От одного запроса до стабильного запуска: как задавать параметры и как считать расходы
-
Руководство по использованию
Руководство по началу работы с kling-image-4.0: ключевые моменты интеграции API генерации изображений и контроль затрат
Решения по интеграции и практический чек-лист для разработчиков