Черновой режим Seedance 2.5
Сначала дешёвый черновик 480p, затем финальное видео 1080p на его основе
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
Черновой режим делит одну генерацию на два этапа: сначала создаётся недорогой черновик 480p, чтобы проверить движение камеры и композицию, затем на его основе создаётся финальное видео 1080p. Верхний сервис переиспользует промпт и материалы черновика, поэтому на втором этапе их не нужно передавать повторно.
Оба этапа вызывают POST /v1/videos/generations с одной и той же моделью seedance-2-5.
Два этапа
- Отправьте черновой запрос с
draft: trueи возьмите ID черновой задачи из ответа. - Дождитесь завершения черновика и убедитесь, что
statusравенcompleted, через получение статуса задачи. - Отправьте финальный запрос с
draft_task_id, указав ID черновой задачи из шага 1. Не передавайте промпт и материалы повторно.
Сравнение этапов
| Параметр | Черновик (draft: true) | Финал (draft_task_id) |
|---|---|---|
| Поддерживаемая модель | только seedance-2-5 | только seedance-2-5 |
resolution | всегда 480p | всегда 1080p |
output_format | mp4 | mp4 или mov |
| Промпт и материалы | как в обычной генерации | не принимаются, нужно опустить |
| Статус черновой задачи | - | должен быть успешно завершён |
| Срок жизни черновика | - | 7 дней с момента создания |
| Биллинг | тариф 480p | тариф 1080p; цена за единицу зависит от наличия видео-входа в черновом запросе |
Финальный запрос должен использовать ту же model, что и черновик, а поддержка черновиков на его канале должна оставаться включённой. Если черновая задача не завершилась успешно, создана более 7 дней назад, использовала другую модель или поддержка на канале отключена, финальный запрос завершится ошибкой invalid_draft_task, и черновик придётся создать заново.
Body
draftbooleanтелопо умолчанию: falseУстановите true, чтобы отправить черновой запрос. Черновик создаётся в 480p, остальные параметры работают так же, как в обычной генерации.
Поддерживается только для seedance-2-5. Для других моделей возвращается draft mode is only supported for Seedance 2.5.
draft_task_idstringтелоОбязателен для финального запроса. Укажите ID задачи из ответа черновика (tsk_vid_...).
Нельзя использовать вместе с draft: true. После указания draft_task_id не передавайте prompt, image_urls, image_with_roles, video_with_roles или audio_with_roles, иначе вернётся draft requests cannot include prompt or media.
resolutionstringтелоЧерновик фиксируется на 480p, финал — на 1080p. Поле необязательное: если его опустить, используется фиксированное значение этапа. Любое другое явное значение отклоняется.
output_formatstringтелопо умолчанию: mp4Указывается только в финальном запросе. Поддерживаются mp4 и mov.
return_last_framebooleanтелопо умолчанию: falseФинальный запрос не наследует настройку последнего кадра из черновика. Если последний кадр нужен и в финале, передайте true в финальном запросе повторно.
Остальные параметры (prompt, duration, aspect_ratio, generate_audio, ссылки на материалы и другие) на этапе черновика используются так же, как в генерации видео Seedance 2.5.
Примеры запросов
Два примера ниже — это полные запросы для отправки черновика и для создания финального видео на его основе. Выполняйте их по порядку.
Пример запроса
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5",
"draft": true,
"prompt": "Кинематографичный крупный план продукта, медленное приближение камеры.",
"duration": 4,
"resolution": "480p",
"return_last_frame": true
}'curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5",
"draft_task_id": "tsk_vid_xxx",
"resolution": "1080p",
"output_format": "mp4",
"return_last_frame": true
}'Пример ответа
{
"id": "tsk_vid_xxx",
"object": "generation.task",
"model": "seedance-2-5",
"status": "in_progress",
"progress": 10,
"created_at": 1781577600
}Биллинг
Черновик и финальное видео оплачиваются отдельно, каждое при завершении своей задачи, по фактическому объёму токенов, который сообщает верхний сервис. Черновик списывается по тарифу 480p, финал — по тарифу 1080p. Цена за единицу для финала зависит от того, был ли в черновом запросе видео-вход: если черновик содержал референсное видео, применяется тариф с видео-входом, а длительность входного видео считается по исходному видео черновика (само черновое видео не учитывается); если видео-входа не было, применяется тариф без видео-входа. Основанием для фактической суммы служат результат задачи и раздел Цены и фактическая стоимость.