> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

<Note>
  **Для пользователей из материкового Китая:** используйте `https://toapis.cn` в качестве эндпоинта (Base URL). Замените `https://toapis.com` на `https://toapis.cn` во всех примерах этого документа.
</Note>

Черновой режим делит одну генерацию на два этапа: сначала создаётся недорогой черновик 480p, чтобы проверить движение камеры и композицию, затем на его основе создаётся финальное видео 1080p. Верхний сервис переиспользует промпт и материалы черновика, поэтому на втором этапе их не нужно передавать повторно.

Оба этапа вызывают `POST /v1/videos/generations` с одной и той же моделью `seedance-2-5`.

## Два этапа

1. Отправьте черновой запрос с `draft: true` и возьмите ID черновой задачи из ответа.
2. Дождитесь завершения черновика и убедитесь, что `status` равен `completed`, через [получение статуса задачи](/docs/ru/api-reference/tasks/video-status).
3. Отправьте финальный запрос с `draft_task_id`, указав ID черновой задачи из шага 1. Не передавайте промпт и материалы повторно.

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

| Параметр | Черновик (`draft: true`) | Финал (`draft_task_id`) |
| - | - | - |
| Поддерживаемая модель | только `seedance-2-5` | только `seedance-2-5` |
| `resolution` | всегда `480p` | всегда `1080p` |
| `output_format` | `mp4` | `mp4` или `mov` |
| Промпт и материалы | как в [обычной генерации](./generation) | не принимаются, нужно опустить |
| Статус черновой задачи | - | должен быть успешно завершён |
| Срок жизни черновика | - | 7 дней с момента создания |
| Биллинг | тариф черновика | черновик считается видео-входом, применяется тариф с видео-входом |

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

## Body

<ParamField body="draft" type="boolean" default={false}>
  Установите `true`, чтобы отправить черновой запрос. Черновик создаётся в `480p`, остальные параметры работают так же, как в [обычной генерации](./generation).

  Поддерживается только для `seedance-2-5`. Для других моделей возвращается `draft mode is only supported for Seedance 2.5`.
</ParamField>

<ParamField body="draft_task_id" type="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`.
</ParamField>

<ParamField body="resolution" type="string">
  Черновик фиксируется на `480p`, финал — на `1080p`. Поле необязательное: если его опустить, используется фиксированное значение этапа. Любое другое явное значение отклоняется.
</ParamField>

<ParamField body="output_format" type="string" default="mp4">
  Указывается только в финальном запросе. Поддерживаются `mp4` и `mov`.
</ParamField>

<ParamField body="return_last_frame" type="boolean" default={false}>
  Финальный запрос не наследует настройку последнего кадра из черновика. Если последний кадр нужен и в финале, передайте `true` в финальном запросе повторно.
</ParamField>

Остальные параметры (`prompt`, `duration`, `aspect_ratio`, `generate_audio`, ссылки на материалы и другие) на этапе черновика используются так же, как в [генерации видео Seedance 2.5](./generation).

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

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

<RequestExample>
  ```bash cURL (отправка черновика) theme={null}
  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
    }'
  ```

  ```bash cURL (создание финального видео) theme={null}
  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
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "tsk_vid_xxx",
    "object": "generation.task",
    "model": "seedance-2-5",
    "status": "in_progress",
    "progress": 10,
    "created_at": 1781577600
  }
  ```
</ResponseExample>

## Биллинг

Черновик и финальное видео оплачиваются отдельно, каждое при завершении своей задачи. Черновик списывается по тарифу черновика. В финальном запросе видео черновика считается видео-входом, поэтому списание идёт по тарифу с видео-входом и стоит дороже за единицу. Основанием для фактической суммы служат результат задачи и раздел [Цены и фактическая стоимость](/docs/ru/api-reference/account/pricing).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.