Seedance 2.5 Flash

Создавайте видео длительностью 4–30 секунд в 480p или 720p по тексту, первому/последнему кадру или мультимодальным референсам либо редактируйте одно исходное видео.

Seedance 2.5 Flash поддерживает создание видео по тексту, генерацию по первому/последнему кадру, генерацию по референсам и редактирование видео. Используйте dreamina-seedance-2-5-flash на уровне Default. Передавайте медиафайлы в виде общедоступных HTTP- или HTTPS-URL без учётных данных. Сохраните возвращённый ID задачи и запрашивайте по нему готовое видео.

См. песочницу и актуальные цены, спецификацию OpenAPI и руководство по ценам.

Краткий пример

Этот запрос создаёт четырёхсекундное видео. Перед отправкой ознакомьтесь с текущей ценой: за успешно выполненную генерацию взимается плата.

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-flash",
    "content": [{"type": "text", "text": "A ceramic cup slowly rotates under warm studio lighting."}],
    "resolution": "480p",
    "duration": 4,
    "ratio": "16:9",
    "generate_audio": false
  }'

Параметры

Поля model и content обязательны. Все остальные поля необязательны. Явные значения null и неизвестные поля отклоняются.

Поле	Тип	Значение по умолчанию	Ограничения
`model`	строка	обязательно	`dreamina-seedance-2-5-flash`
`content`	массив	обязательно	Как минимум один непустой текстовый элемент; для медиаэлементов требуется роль.
`resolution`	строка	`720p`	`480p` или `720p`.
`duration`	целое число	`5` или `-1` для редактирования	Генерация: 4–30 секунд. Редактирование: опустите поле или укажите `-1`; длительность результата соответствует исходному видео.
`ratio`	строка	`16:9` или `adaptive` для кадров/редактирования	Генерация по тексту/референсам: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`. Первый/последний кадр и редактирование: только `adaptive`.
`generate_audio`	логическое значение	`true`	Включает или отключает генерируемое аудио; это не меняет тариф.
`omni_reference_task_type`	строка	`generate`	`generate` или `edit`. Для редактирования требуется ровно одно видео.
`content_filter`	логическое значение	`true`	Принимается только `true`; элемент управления в песочнице не требуется.

В документации для промптов указан максимум в 10 000 токенов. Общедоступный токенизатор не указан, поэтому количество символов нельзя считать точным количеством токенов.

Содержимое и режимы

Для текста используется {"type":"text","text":"Describe the shot"}. Для изображений, видео и аудио используются вложенный URL и явно указанная роль:

{
  "type": "image_url",
  "image_url": {"url": "https://example.com/reference.jpg"},
  "role": "reference_image"
}

Режим	Содержимое	Формат кадра и длительность
Видео по тексту	Только текст	Фиксированное соотношение сторон; 4–30 секунд.
Первый/последний кадр	Текст и одно изображение `first_frame`, при необходимости одно изображение `last_frame`	`adaptive`; 4–30 секунд. Для последнего кадра требуется первый кадр.
Генерация по референсам	Текст и элементы `reference_image`, `reference_video` или `reference_audio`	Фиксированное соотношение сторон; 4–30 секунд. До 10 изображений, 5 видео и 5 аудио.
Редактирование видео	Текст, ровно один `reference_video`, необязательные референсные изображения/аудио; тип задачи `edit`	`adaptive`; длительность не указана или равна `-1`.

Видеоэлементы используют type: "video_url", video_url: {"url": "..."}, role: "reference_video"; аудиоэлементы используют audio_url и reference_audio в той же структуре. Первый/последний кадр нельзя сочетать с референсными медиафайлами. В этой интеграции недоступны элементы управления Draft, Extend, 1080p, водяным знаком, начальным значением генератора и выводом последнего кадра. Обратные вызовы не предоставляются.

Ограничения медиафайлов

Медиафайл	Форматы	Размер и длительность
Изображение	JPEG, PNG, WebP	До 30 MB; каждая сторона 300–6 000 px; отношение ширины к высоте 0,4–2,5.
Видео	MP4, MOV	До 200 MB; 24–60 FPS; каждая сторона 300–6 000 px; соотношение сторон 0,4–2,5; 409 600–8 295 044 пикселя. Референсы: по 2–30 секунд, суммарно не более 30 секунд. Исходное видео для редактирования: 4–30 секунд.
Аудио	WAV, MP3	До 15 MB; по 2–30 секунд, суммарно не более 30 секунд.

Файлы должны быть доступны для чтения до отправки. Для расчёта платы длительность видео измеряется по медиафайлу. Используйте стабильные общедоступные URL.

Ответ задачи и опрос статуса

При создании возвращаются id, model, status и created_at. Запрашивайте ту же задачу до её завершения:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Статус принимает значение processing, completed или failed. При успехе получите сохранённое видео по output.video_url. При сбое прочитайте error.code и error.message. Публичные ответы не содержат стоимости. Истечение времени ожидания при опросе не доказывает, что генерация завершилась с ошибкой: сохраните ID задачи и запросите её снова вместо отправки новой генерации.

Оплата

Актуальный тариф зависит от разрешения и наличия входного видео. Без входного видео оплачиваемое количество секунд равно длительности результата. При наличии референсных видео оплачиваемое количество секунд равно длительности результата плюс большее из двух значений: длительности результата и суммарной длительности входных видео, округлённой вверх. При редактировании оплачивается удвоенная длительность исходного видео, округлённая вверх. Аудио включено в стоимость. За неудачные запросы плата не взимается.

Например, за пятисекундный результат с трёхсекундным референсным видео оплачиваются десять секунд. За редактирование десятисекундного исходного видео оплачиваются двадцать секунд. Умножьте оплачиваемое количество секунд на применимый актуальный тариф.

Типовые ответы и рекомендации по повторным попыткам см. в разделах жизненный цикл задачи и коды ошибок.