ToAPIsToAPIs
seedance-2-5

Черновой режим Seedance 2.5

Сначала дешёвый черновик 480p, затем финальное видео 1080p на его основе

POST
/v1/videos/generations

Для пользователей из материкового Китая: используйте 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. Не передавайте промпт и материалы повторно.

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

ПараметрЧерновик (draft: true)Финал (draft_task_id)
Поддерживаемая модельтолько seedance-2-5только seedance-2-5
resolutionвсегда 480pвсегда 1080p
output_formatmp4mp4 или 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. Цена за единицу для финала зависит от того, был ли в черновом запросе видео-вход: если черновик содержал референсное видео, применяется тариф с видео-входом, а длительность входного видео считается по исходному видео черновика (само черновое видео не учитывается); если видео-входа не было, применяется тариф без видео-входа. Основанием для фактической суммы служат результат задачи и раздел Цены и фактическая стоимость.