Руководство по использованию
Руководство по интеграции Seedance 2.5 Flash для генерации видео из текста: параметры, посекундная тарификация и инженерные практики
От одного запроса до стабильного запуска: как задавать параметры и как считать расходы
- Модель
- 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, блокирующий запрос пользователя.
- Сохранение состояний в БД: идентификатор задачи, статус, параметры запроса храните в базе данных, а не только в памяти процесса — потеря задачи при перезапуске означает, что деньги потрачены, а результата нет.
- Экспоненциальная задержка опроса: начинайте с короткого интервала, постепенно увеличивайте его и добавляйте джиттер, при этом задавайте общий тайм-аут для каждой задачи: по истечении времени переходите в ветку ошибки, а не опрашивайте бесконечно.
- Классификация ошибок: ошибки параметров и нарушения контентной политики — это детерминированные сбои, повторять их бессмысленно; только мгновенные ошибки, такие как сетевые сбои и ограничение частоты запросов, заслуживают повторных попыток с задержкой.
- Идемпотентность: на стороне отправки используйте бизнес-уникальный ключ, чтобы избежать создания нескольких задач и повторной оплаты из-за повторных нажатий пользователя.
Как писать промпты для стабильного результата
Пишите по четырём блокам «субъект → последовательность действий → окружение и освещение → камера» — это гораздо стабильнее, чем нагромождение прилагательных.
Субъект: белая кошка сидит на подоконнике, контровой свет
Действие: от неподвижности до поднятия головы и взгляда в окно, медленное покачивание хвостом
Окружение и освещение: тёплый свет после полудня, малая глубина резкости, тихая атмосфера в помещении
Камера: средний план, фиксированная точка съёмки, лёгкое ощущение ручной камеры
Три правила: один промпт описывает только один непрерывный кадр, не втискивайте переключение нескольких сцен в одну генерацию; версионируйте промпты, меняйте каждый раз только одну переменную, чтобы понять, какое изменение сработало; сначала пробный образец, потом массовое производство — не используйте массовую генерацию для проверки ещё не утверждённого промпта.
Формат кадра и язык камеры можно описывать естественным языком — у модели нет отдельного параметра «движение камеры», поэтому надёжнее вписать это в промпт, чем надеяться на несуществующее поле.
Путь к запуску
- Наладить конвейер: три промпта, покрывающих типичные сценарии, убедитесь, что отправка, опрос и скачивание работают полностью, сначала не оценивая качество результата.
- Определить промпты и длительность: зафиксируйте небольшой набор промптов, сравните результаты при разных формулировках и разной длительности, записывайте стоимость каждого, формируйте библиотеку многоразовых шаблонов.
- Поэтапное масштабирование: наращивайте объёмы пропорционально, следите за долей успешных задач, средним временем выполнения, частотой повторов и кривой расходов — увеличивайте объём только после достижения целевых показателей по всем трём метрикам.
- Регулярная эксплуатация: периодически пересматривайте библиотеку шаблонов, удаляйте неэффективные формулировки, следите за трендом расходов и порогом повторных попыток.
На странице модели есть актуальное описание параметров и цен — сверьтесь с ним перед интеграцией.
Похожие статьи
Все статьи →-
Руководство по использованию
Руководство по подключению генерации видео из референсных материалов Seedance 2.5 Flash: референсные изображения, референсное аудио и правила тарификации
-
Руководство по использованию
Руководство по подключению Seedance 2.5 Flash для генерации видео из изображения: первый кадр, последний кадр и оплата по секундам
Заставьте изображение двигаться: параметры, цены и типичные причины сбоев
-
Руководство по использованию
Руководство по началу работы с kling-image-4.0: ключевые моменты интеграции API генерации изображений и контроль затрат
Решения по интеграции и практический чек-лист для разработчиков