Руководство по использованию
Руководство по подключению генерации видео из референсных материалов Seedance 2.5 Flash: референсные изображения, референсное аудио и правила тарификации
- Модель
- seedance-2.5-flash
На этой странице
Что делает эта модель
seedance-2.5-flash/reference-to-video — это модель ByteDance для генерации видео на основе референсных материалов. Вы передаёте ей референсные изображения и референсное аудио, в промпте ссылаетесь на них по порядку через @image1, @audio1, и модель генерирует новое видео. Референсные изображения определяют, как выглядят персонажи, товары или сцена, а референсное аудио задаёт ритм, музыкальное сопровождение или голосовую озвучку.
Ограничения референсных материалов
- Референсные изображения: не более 10 штук, поддерживаются jpeg, png, webp, bmp, tiff, gif, каждое меньше 30 MB, длина стороны от 300 до 6000 пикселей, соотношение сторон от 0.4 до 2.5; SVG, HEIC, HEIF не поддерживаются.
- Референсное аудио: не более 5 фрагментов, wav или mp3, меньше 15 MB, каждый фрагмент от 2 до 30 секунд, суммарно не более 30 секунд; можно передать только аудио, без изображений.
Нужно передать хотя бы один из двух типов материалов, иначе запрос не будет принят.
Правила тарификации
Этот сервис тарифицируется по секундам выходного видео; референсные изображения и аудио не включаются в оплачиваемые секунды:
- 480p: $0.0679/сек, 5-секундное видео около $0.34.
- 720p: $0.1525/сек, 5-секундное видео около $0.76.
Если указать целое число от 4 до 30, оплата идёт по указанным секундам; если указать -1 (авто), оплата идёт по фактической длительности готового видео с округлением, минимум 4 секунды. Чтобы контролировать бюджет, указывайте фиксированное число секунд.
Параметры запроса
- prompt (обязательный): описание того, как использовать материалы, со ссылками по порядку через @image1, @audio1, не более 5000 символов.
- reference_image_urls / reference_audio_urls: массивы URL референсных изображений и референсного аудио.
- duration: целое число от 4 до 30 или
-1для автоматического выбора; по умолчанию 5. - resolution:
480pили720p, по умолчанию480p. - aspect_ratio: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 или
adaptive— следовать референсным материалам; по умолчаниюadaptive. - omni_reference_task_type: фиксированное значение
reference(значение по умолчанию, можно не передавать). - output_format:
mp4(по умолчанию) илиmov; generate_audio: по умолчаниюtrue, генерирует синхронные диалоги, звуковые эффекты и фоновый звук.
Как писать промпт
Сначала пронумеруйте материалы в порядке появления, затем по порядку опишите, какую роль играет каждый материал и каким должен стать итоговый кадр. Например:
Продукт из @image1 медленно вращается на деревянном столе, фон — утреннее окно из @image2,
камера медленно приближается со среднего плана к крупному, ритм кадров следует за ритмом ударных из @audio1, металлический блик продукта остаётся неизменным.
При нескольких референсных изображениях чётко указывайте, какое из них является основным объектом, а какое — сценой или стилем; это гораздо стабильнее, чем просто написать «ориентируйся на эти изображения». Если используется референсное аудио, укажите, с каким фрагментом аудио должны совпадать движения в кадре.
Частые вопросы
- Запрос отклонён из-за отсутствия материалов: нужно передать хотя бы одно референсное изображение или референсное аудио.
- Референсное изображение не загружается: сначала проверьте, входит ли формат в список поддерживаемых, находится ли длина стороны в диапазоне от 300 до 6000, а соотношение сторон — от 0.4 до 2.5.
- Аудио отклонено: каждый фрагмент должен быть от 2 до 30 секунд и меньше 15 MB, суммарно несколько фрагментов не более 30 секунд.
- Стоимость не совпадает с ожидаемой: проверьте, не использовалась ли автоматическая длительность
-1; при автоматической длительности оплата идёт по фактическим секундам готового видео.
Рекомендации по запуску
Сначала запустите один запрос с одним референсным изображением, 5 секундами и 480p, чтобы проверить цепочку и порядок списания средств; затем запустите ещё один запрос с референсным аудио или несколькими референсными изображениями и проверьте, используются ли материалы в кадре согласно номерам в промпте. Сохраните записи этих двух запросов как базовые: при последующем изменении промпта или материалов у вас будет ориентир для сравнения. Параметры и цены определяются текущим описанием на странице модели.
Похожие статьи
Все статьи →-
Руководство по использованию
Руководство по подключению Seedance 2.5 Flash для генерации видео из изображения: первый кадр, последний кадр и оплата по секундам
Заставьте изображение двигаться: параметры, цены и типичные причины сбоев
-
Руководство по использованию
Руководство по интеграции Seedance 2.5 Flash для генерации видео из текста: параметры, посекундная тарификация и инженерные практики
От одного запроса до стабильного запуска: как задавать параметры и как считать расходы
-
Руководство по использованию
Руководство по началу работы с kling-image-4.0: ключевые моменты интеграции API генерации изображений и контроль затрат
Решения по интеграции и практический чек-лист для разработчиков