> ## 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` во всех примерах этого документа.

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

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

## Два этапа

1. Отправьте черновой запрос с `draft: true` и возьмите ID черновой задачи из ответа.
2. Дождитесь завершения черновика и убедитесь, что `status` равен `completed`, через [получение статуса задачи](https://docs.toapis.com/docs/ru/api-reference/tasks/video-status.md).
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` |
| Промпт и материалы | как в [обычной генерации](https://docs.toapis.com/docs/ru/api-reference/videos/seedance-2-5/generation.md) | не принимаются, нужно опустить |
| Статус черновой задачи | - | должен быть успешно завершён |
| Срок жизни черновика | - | 7 дней с момента создания |
| Биллинг | тариф 480p | тариф 1080p; цена за единицу зависит от наличия видео-входа в черновом запросе |

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

## Body

**draft** `boolean` (default: false)

Установите `true`, чтобы отправить черновой запрос. Черновик создаётся в `480p`, остальные параметры работают так же, как в [обычной генерации](https://docs.toapis.com/docs/ru/api-reference/videos/seedance-2-5/generation.md).

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

**draft\_task\_id** `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`.

**resolution** `string`

Черновик фиксируется на `480p`, финал — на `1080p`. Поле необязательное: если его опустить, используется фиксированное значение этапа. Любое другое явное значение отклоняется.

**output\_format** `string` (default: mp4)

Указывается только в финальном запросе. Поддерживаются `mp4` и `mov`.

**return\_last\_frame** `boolean` (default: false)

Финальный запрос не наследует настройку последнего кадра из черновика. Если последний кадр нужен и в финале, передайте `true` в финальном запросе повторно.

Остальные параметры (`prompt`, `duration`, `aspect_ratio`, `generate_audio`, ссылки на материалы и другие) на этапе черновика используются так же, как в [генерации видео Seedance 2.5](https://docs.toapis.com/docs/ru/api-reference/videos/seedance-2-5/generation.md).

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

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

```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
  }'
```

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

## Биллинг

Черновик и финальное видео оплачиваются отдельно, каждое при завершении своей задачи, по фактическому объёму токенов, который сообщает верхний сервис. Черновик списывается по тарифу 480p, финал — по тарифу 1080p. Цена за единицу для финала зависит от того, был ли в черновом запросе видео-вход: если черновик содержал референсное видео, применяется тариф с видео-входом, а длительность входного видео считается по исходному видео черновика (само черновое видео не учитывается); если видео-входа не было, применяется тариф без видео-входа. Основанием для фактической суммы служат результат задачи и раздел [Цены и фактическая стоимость](https://docs.toapis.com/docs/ru/api-reference/account/pricing.md).


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