Seedance 2.5 Flash
Справочник API Seedance 2.5 Flash: генерация видео, кадры и референсы, примеры запросов, опрос задач, скачивание и цены.
Создавайте видео по тексту, кадрам или референсам либо редактируйте исходный клип. Модель и Playground.
Создание задачи
Создайте серверный ключ в настройках API-ключей. Отправьте один POST-запрос на https://api.wanapi.app/v1/videos и сохраните полученный id.
curl https://api.wanapi.app/v1/videos -H "Authorization: Bearer $WAN_API_KEY" -H "Content-Type: application/json" -d '{"model":"bytedance/seedance-2.5-flash","prompt":"A paper boat floats through a sunlit stream. Slow tracking shot.","resolution":"720p","aspectRatio":"16:9","duration":4,"generateAudio":true}'Поля запроса
Используйте model: "bytedance/seedance-2.5-flash" и непустой prompt. Установите для resolution значение 480p или 720p (по умолчанию). Генерация принимает значение duration от 4 до 30 секунд (по умолчанию 5). Установите generateAudio: false для вывода без звука. Одна генерация на задачу, фиксированная частота — 24 fps.
Для генерации по тексту и референсам используется фиксированное значение aspectRatio: 16:9 (по умолчанию), 9:16, 1:1, 4:3, 3:4 или 21:9. Для первого и последнего кадров передайте image для начального кадра или frameImages с одним first_frame и необязательным last_frame. У каждой записи кадра есть frameType и URL в image. Для кадров и редактирования используется адаптивное кадрирование.
Передайте референсные изображения или видео в inputReferences, указав для каждого type: "url", url и mediaType. До 10 изображений, 5 видео и 5 аудиоклипов. Передайте URL аудио в providerOptions.bytedance.referenceAudio. В каждом запросе выберите один режим: начальный и конечный кадры или референсные материалы.
Чтобы отредактировать видео, установите providerOptions.bytedance.omni_reference_task_type в значение edit, передайте ровно одно референсное видео и не указывайте длительность либо установите её в -1. Другой тип задачи — generate, он используется по умолчанию. По умолчанию фильтрация контента включена. Клиенты API могут установить providerOptions.bytedance.content_filter в значение false.
Технические характеристики медиафайлов
Используйте общедоступные URL HTTP(S), не требующие учётных данных. Изображения: JPEG, PNG или WebP, размером до 30 MB. Для изображений и видео: от 300 до 6000 пикселей по каждой стороне, соотношение сторон — 0.4–2.5.
Видео: MP4 или MOV, размером до 200 MB, 24–60 fps, 409600–8295044 пикселей. Длительность референсных видео — 2–30 секунд, а видео для редактирования — 4–30 секунд. Суммарная длительность видео — не более 30 секунд.
Аудио: MP3 или WAV, до 15 MB и длительностью 2–30 секунд на клип; суммарная длительность — не более 30 секунд.
Опрос статуса и скачивание
Отправляйте запросы GET https://api.wanapi.app/v1/videos/{id} с тем же API-ключом. Продолжайте опрашивать задачи со статусом queued или in_progress. При статусе completed скачайте videos[0].url. Относительные URL разрешайте относительно хоста API и проходите там аутентификацию. Используйте подписанные URL медиафайлов напрямую. При статусе failed прочитайте error.message. Повторите неудачный опрос с тем же ID задачи.
Цены
| Разрешение | Без входного видео | С входным видео |
|---|---|---|
| 480p | 0,096 $ | 0,06 $ |
| 720p | 0,192 $ | 0,12 $ |
Аудио включено. См. руководство по оплачиваемым секундам, чтобы узнать, как рассчитываются референсные материалы и монтаж.