Skip to main content
POST
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
Черновой режим делит одну генерацию на два этапа: сначала создаётся недорогой черновик 480p, чтобы проверить движение камеры и композицию, затем на его основе создаётся финальное видео 1080p. Верхний сервис переиспользует промпт и материалы черновика, поэтому на втором этапе их не нужно передавать повторно. Оба этапа вызывают POST /v1/videos/generations с одной и той же моделью seedance-2-5.

Два этапа

  1. Отправьте черновой запрос с draft: true и возьмите ID черновой задачи из ответа.
  2. Дождитесь завершения черновика и убедитесь, что status равен completed, через получение статуса задачи.
  3. Отправьте финальный запрос с draft_task_id, указав ID черновой задачи из шага 1. Не передавайте промпт и материалы повторно.

Сравнение этапов

Финальный запрос должен использовать ту же model, что и черновик, а поддержка черновиков на его канале должна оставаться включённой. Если черновая задача не завершилась успешно, создана более 7 дней назад, использовала другую модель или поддержка на канале отключена, финальный запрос завершится ошибкой invalid_draft_task, и черновик придётся создать заново.

Body

boolean
по умолчанию:false
Установите true, чтобы отправить черновой запрос. Черновик создаётся в 480p, остальные параметры работают так же, как в обычной генерации.Поддерживается только для seedance-2-5. Для других моделей возвращается draft mode is only supported for Seedance 2.5.
string
Обязателен для финального запроса. Укажите 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.
string
Черновик фиксируется на 480p, финал — на 1080p. Поле необязательное: если его опустить, используется фиксированное значение этапа. Любое другое явное значение отклоняется.
string
по умолчанию:"mp4"
Указывается только в финальном запросе. Поддерживаются mp4 и mov.
boolean
по умолчанию:false
Финальный запрос не наследует настройку последнего кадра из черновика. Если последний кадр нужен и в финале, передайте true в финальном запросе повторно.
Остальные параметры (prompt, duration, aspect_ratio, generate_audio, ссылки на материалы и другие) на этапе черновика используются так же, как в генерации видео Seedance 2.5.

Примеры запросов

Два примера ниже — это полные запросы для отправки черновика и для создания финального видео на его основе. Выполняйте их по порядку.

Биллинг

Черновик и финальное видео оплачиваются отдельно, каждое при завершении своей задачи. Черновик списывается по тарифу черновика. В финальном запросе видео черновика считается видео-входом, поэтому списание идёт по тарифу с видео-входом и стоит дороже за единицу. Основанием для фактической суммы служат результат задачи и раздел Цены и фактическая стоимость.