Генерация видео Seedance 2.5 flash
Генерация видео с моделью seedance-2-5-flash
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
Seedance 2.5 flash — ускоренная и более доступная версия Seedance 2.5. Публичное имя модели — seedance-2-5-flash.
- Поддерживаются text-to-video, первый/первый и последний кадр, редактирование, продление видео и мультимодальные ссылки.
- Можно использовать ссылки на изображения, видео и аудио, включая только аудио.
- Задача асинхронная: после отправки возвращается
generation.task, а готовое видео получается через API статуса задачи.
По сравнению с Seedance 2.5, flash генерирует примерно вдвое быстрее и дешевле, выводит только 480p или 720p, принимает до 20 референсов (10 изображений, 5 видео, 5 аудиофрагментов) и не поддерживает черновой режим.
Authorizations
AuthorizationstringзаголовокобязательноAuthorization: Bearer YOUR_API_KEY.Body
modelstringтелообязательнопо умолчанию: seedance-2-5-flashseedance-2-5-flash.promptstringтелоvideo_operationstringтелопо умолчанию: generategenerate, edit или extend. Для редактирования и продолжения нужен хотя бы один video_with_roles; редактирование использует duration=-1, продолжение — 4–30 или -1. Все операции используют этот endpoint.client_business_idstringтелоGET /v1/videos/generations/{client_business_id}.durationintegerтело4–30; -1 означает, что модель выберет длительность сама. Редактирование принимает только -1, длина результата примерно совпадает с исходным видео. Продление принимает 4–30 или -1 и задаёт общую длительность результата после продления.aspect_ratiostringтело21:9, 16:9, 4:3, 1:1, 3:4, 9:16 или adaptive. Для редактирования, продления и первого/последнего кадра используйте adaptive.image_urlsstring[]телоimage_with_roles; оба поля нельзя передавать одновременно.image_with_rolesarrayтелоurl и role. Роли: first_frame, last_frame, reference_image; максимум 10 изображений. Режим кадров нельзя смешивать с режимом reference.video_with_rolesarrayтелоreference_video; максимум 5 видео.audio_with_rolesarrayтелоreference_audio; максимум 5 фрагментов. Допускается только аудио.resolutionstringтело480p или 720p. Seedance 2.5 flash не поддерживает 1080p и 4k.output_formatstringтелопо умолчанию: mp4mp4 и mov.generate_audiobooleanтелопо умолчанию: truereturn_last_framebooleanтелопо умолчанию: falsetoolsarrayтело[{ "type": "web_search" }]. Работает только для text-to-video без медиа-входов.callback_urlstringтелоtrace_idstringтелоdisable_nsfwbooleanтелопо умолчанию: truefalse.Ограничения референсов
Всего не более 20 материалов: 10 изображений, 5 видео и 5 аудиофрагментов. Используйте явные роли.
InvalidParameter.TaskTypeConstraint. Для редактирования, продления и кадровых задач задавайте aspect_ratio=adaptive.Проверка материалов
Если запрос содержит изображения, видео или аудио, некоторые каналы автоматически проверяют материалы перед отправкой на генерацию. Дополнительный параметр не нужен: передавайте URL материалов в прежних полях медиа.
- Принятый запрос сразу возвращает видеозадачу. Если нужна проверка, задача остается в
queued, а генерация отправляется только после того, как все материалы запроса пройдут проверку. Первая проверка может занять несколько минут; повторное использование того же URL тем же пользователем в том же канале переиспользует результат проверки. - Один раунд подготовки материалов по умолчанию длится не более 20 минут. Отказ в проверке или тайм-аут подготовки завершают задачу со статусом
failed, причина указана вerror.message. Если проверка не пройдена, плата за генерацию видео не взимается. - Материалы передаются только публичными HTTP(S) URL; Base64 и локальные пути не принимаются. Изображения должны быть не больше 30 MB, видео и аудио не больше 100 MiB. Прежние ограничения форматов модели сохраняются.
- Каналы с проверкой валидируют материалы при приеме запроса: URL с учетными данными или длиннее 2048 байт, один URL с разными типами материала или более 64 ссылок на материалы в одном запросе возвращают HTTP 400 с
error.codeinvalid_private_assets. - Материалы определяются по URL. После изменения содержимого файла используйте новый URL.
- Прежние ссылки
asset://выведены из использования и возвращают HTTP 400.
Получайте готовые результаты через Статус видеозадачи. Если передача исходного URL включена, сначала используйте result.data[].url, а необязательный fallback_url только при недоступности основного адреса. Для последнего кадра используются last_frame_url и fallback_last_frame_url. Резервные поля возвращаются только при наличии доступных копий.
Response
idstringclient_business_idstringobjectstringgeneration.task.modelstringstatusstringqueued, in_progress, completed или failed.progressinteger0 до 100.created_atintegerПример запроса
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{"model":"seedance-2-5-flash","prompt":"Кинематографичный крупный план продукта, медленное приближение камеры.","duration":10,"aspect_ratio":"16:9","resolution":"720p","generate_audio":true}'{
"model": "seedance-2-5-flash",
"prompt": "Продлить видео 1 вперёд, камера продолжает приближаться и показывает город за окном.",
"video_operation": "extend",
"duration": 11,
"aspect_ratio": "adaptive",
"output_format": "mov",
"video_with_roles": [{"url": "https://example.com/source.mov", "role": "reference_video"}]
}Пример ответа
{"id":"tsk_vid_xxx","object":"generation.task","model":"seedance-2-5-flash","status":"in_progress","progress":10,"created_at":1781577600}