HiAPI
Блог

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

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

От одного запроса до стабильного запуска: как задавать параметры и как считать расходы

Nov 17, 2026
На тёплом угольном фоне по диагонали проходит широкая янтарная полоса света с резкими краями, общая композиция сдержанна и оставляет много свободного пространства.
Модель
seedance-2.5-flash
На этой странице

Что делает эта модель

seedance-2.5-flash/text-to-video — это модель генерации видео из текста от ByteDance: на вход подаётся текстовый промпт, на выходе получается видео с синхронизированным звуком. У неё только этот один входной путь — она не принимает изображения или видео в качестве условных входных данных и не выполняет понимание видео.

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

Какие параметры есть в запросе

  • prompt (обязательный): сцена, субъект, движение камеры и действия. Максимум 5000 символов.
  • resolution: 480p или 720p, по умолчанию 480p.
  • duration: целое число от 4 до 30, по умолчанию 5, в секундах.
  • aspect_ratio: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive, по умолчанию adaptive (модель выбирает пропорции по промпту).
  • output_format: mp4 (по умолчанию) или mov.
  • generate_audio: по умолчанию true, генерирует диалоги, звуковые эффекты и фоновый звук, синхронизированные с изображением.

Кроме prompt, у всех параметров есть значения по умолчанию, поэтому минимальный запрос требует только prompt. Тело запроса проходит строгую валидацию: лишние необъявленные поля отклоняются, а не молча отбрасываются — это позволяет выявлять ошибки на этапе отладки при отправке, а не после списания средств.

Как считается посекундная оплата

Формула тарификации — «цена за секунду × количество выходных секунд», привязанная к уровню разрешения:

  • 480p: $0.0679/сек
  • 720p: $0.1525/сек

Количество выходных секунд берётся из duration в запросе, без неожиданного округления. Примеры: 480p 5 секунд — $0.3395, 720p 5 секунд — $0.7625; 480p 30 секунд — $2.037, 720p 30 секунд — $4.575. При удвоении длительности стоимость удваивается, никакой скидки «чем длиннее, тем дешевле» нет.

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

Форма интеграции: асинхронные задачи

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

  • Сохранение состояний в БД: идентификатор задачи, статус, параметры запроса храните в базе данных, а не только в памяти процесса — потеря задачи при перезапуске означает, что деньги потрачены, а результата нет.
  • Экспоненциальная задержка опроса: начинайте с короткого интервала, постепенно увеличивайте его и добавляйте джиттер, при этом задавайте общий тайм-аут для каждой задачи: по истечении времени переходите в ветку ошибки, а не опрашивайте бесконечно.
  • Классификация ошибок: ошибки параметров и нарушения контентной политики — это детерминированные сбои, повторять их бессмысленно; только мгновенные ошибки, такие как сетевые сбои и ограничение частоты запросов, заслуживают повторных попыток с задержкой.
  • Идемпотентность: на стороне отправки используйте бизнес-уникальный ключ, чтобы избежать создания нескольких задач и повторной оплаты из-за повторных нажатий пользователя.

Как писать промпты для стабильного результата

Пишите по четырём блокам «субъект → последовательность действий → окружение и освещение → камера» — это гораздо стабильнее, чем нагромождение прилагательных.

Субъект: белая кошка сидит на подоконнике, контровой свет
Действие: от неподвижности до поднятия головы и взгляда в окно, медленное покачивание хвостом
Окружение и освещение: тёплый свет после полудня, малая глубина резкости, тихая атмосфера в помещении
Камера: средний план, фиксированная точка съёмки, лёгкое ощущение ручной камеры

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

Формат кадра и язык камеры можно описывать естественным языком — у модели нет отдельного параметра «движение камеры», поэтому надёжнее вписать это в промпт, чем надеяться на несуществующее поле.

Путь к запуску

  1. Наладить конвейер: три промпта, покрывающих типичные сценарии, убедитесь, что отправка, опрос и скачивание работают полностью, сначала не оценивая качество результата.
  2. Определить промпты и длительность: зафиксируйте небольшой набор промптов, сравните результаты при разных формулировках и разной длительности, записывайте стоимость каждого, формируйте библиотеку многоразовых шаблонов.
  3. Поэтапное масштабирование: наращивайте объёмы пропорционально, следите за долей успешных задач, средним временем выполнения, частотой повторов и кривой расходов — увеличивайте объём только после достижения целевых показателей по всем трём метрикам.
  4. Регулярная эксплуатация: периодически пересматривайте библиотеку шаблонов, удаляйте неэффективные формулировки, следите за трендом расходов и порогом повторных попыток.

На странице модели есть актуальное описание параметров и цен — сверьтесь с ним перед интеграцией.

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

Все статьи →

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

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

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