HiAPI
Блог

Руководство по использованию

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

Nov 17, 2026
Stacked sheets receding into shallow depth of field, cream and graphite with one terracotta sheet as accent.
Модель
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, чтобы проверить цепочку и порядок списания средств; затем запустите ещё один запрос с референсным аудио или несколькими референсными изображениями и проверьте, используются ли материалы в кадре согласно номерам в промпте. Сохраните записи этих двух запросов как базовые: при последующем изменении промпта или материалов у вас будет ориентир для сравнения. Параметры и цены определяются текущим описанием на странице модели.

Похожие статьи

Все статьи →

Начните работать с постоянными артефактами ИИ

Получите API-ключ и вызывайте модели изображений, видео и аудио через один API на основе tasks.

Читать документацию API