Примечание автора: в статье разбирается двухэтапный вызов Seedance 2.5 в режиме черновика. Сначала можно недорого сгенерировать черновик в разрешении 480p, проверить результат и только потом создать финальное видео в 1080p. В статье есть готовые примеры запросов, которые можно сразу запускать.
При генерации видео с помощью ИИ часто возникает одна и та же проблема: сразу запускаешь создание финального видео в высоком разрешении, а композиция, движение камеры или действия персонажа оказываются неудачными. Приходится генерировать заново — это отнимает и время, и деньги. 25 октября 2026 года APIYI дополнила документацию полным описанием вызова режима черновика Seedance 2.5 (Draft Mode). Сначала в этом режиме можно проверить идею на черновике в разрешении 480p, а если результат устраивает — создать финальное видео в 1080p, указав ID задачи черновика.
Это не новый отдельный API-метод. Режим черновика использует существующий интерфейс асинхронных задач Seedance. Достаточно добавить draft: true в тело запроса или на втором этапе указать ID задачи черновика. Если Seedance уже интегрирован в проект, изменений понадобится совсем немного.
Главное преимущество: прочитав статью, вы разберётесь в двухэтапном процессе вызова режима черновика Seedance 2.5, ключевых параметрах, правилах оплаты и ограничениях. А ещё сможете встроить процесс «сначала проверить черновик, потом создать финальное видео» в свой конвейер производства видео.

Ключевые особенности режима чернового видео Seedance 2.5
Согласно документации в центре APIYI, основные сведения о режиме чернового видео Seedance 2.5 можно свести к следующей таблице:
| Ключевой аспект | Описание | Польза для разработчиков |
|---|---|---|
| Поддерживаемая модель | doubao-seedance-2-5-260628 |
Имя модели фиксировано — достаточно просто заменить его |
| Этап 1: черновое видео | Передайте в теле запроса draft: true, чтобы создать черновое видео в разрешении 480p |
Позволяет быстро и с небольшими затратами проверить композицию и движение камеры |
| Этап 2: финальное видео | Укажите черновое видео через content[].draft_task.id, чтобы создать финальное видео в разрешении 1080p |
Позволяет получить видео в высоком разрешении после проверки результата |
| Формат API | Используется существующий интерфейс асинхронных задач: создание задачи и проверка её статуса | Не нужны новый SDK или дополнительная логика интеграции |
| Оплата | Черновое и финальное видео оплачиваются отдельно | Оплачивайте создание финального видео только для черновиков, которые вас устроили |
| Срок действия | ID задачи чернового видео действителен 7 дней | Финальное видео нужно сгенерировать в течение 7 дней |
Почему стоит использовать режим чернового видео Seedance 2.5
Генерация видео заметно отличается от генерации текста: она занимает больше времени, обходится дороже, а результат сильнее зависит от случайности. Даже если подробно описать всё в промпте, модель может понять темп смены кадров или движения персонажа не так, как вы ожидали. Если каждый раз сразу создавать видео в 1080p, неудовлетворительный результат обернётся полной стоимостью готового ролика.
Режим чернового видео разделяет процесс на два этапа: «пробная съёмка» и «финальная съёмка». Видео в 480p достаточно, чтобы оценить главный объект, движение камеры и общее настроение. Если всё в порядке, на его основе можно создать финальное видео в 1080p. Такой подход помогает командам, которые массово выпускают короткие ролики, рекламные материалы или превью раскадровок, заметно сократить количество неудачных результатов.
Как связаны два этапа режима чернового видео Seedance 2.5
Важно понимать, что финальное видео — это не просто увеличенная копия чернового. На втором этапе запускается новая задача генерации, в которой черновое видео указывается через draft_task.id. Она наследует соответствующие настройки чернового этапа, а результат создаётся в разрешении 1080p. Какие параметры наследуются и какие нельзя изменить на втором этапе, смотрите в разделе «Наследование параметров и ограничения» документации APIYI.

Быстрый старт с режимом чернового видео Seedance 2.5
Перед началом создайте API-ключ в консоли APIYI apiyi.com и задайте его как переменную окружения APIYI_API_KEY. Все примеры ниже считывают ключ из переменной окружения, чтобы не хранить его в коде.
Шаг 1. Создайте черновой ролик в разрешении 480p
Ниже — минимальный запрос для создания задачи. Главное — указать "draft": true и установить разрешение 480p:
curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
-H "Authorization: Bearer ${APIYI_API_KEY}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: identity" \
--data '{
"model": "doubao-seedance-2-5-260628",
"content": [
{"type": "text", "text": "一只橘猫在窗边伸懒腰,阳光洒在木地板上,镜头缓慢推进"}
],
"draft": true,
"resolution": "480p",
"ratio": "16:9",
"duration": 4,
"generate_audio": false
}'
Запрос обрабатывается асинхронно. После успешного создания задачи API вернёт её ID. Сохраните его: он понадобится, чтобы получить результат чернового ролика и затем создать финальный.
Шаг 1. Параметры запроса
| Параметр | Пример значения | Описание |
|---|---|---|
model |
doubao-seedance-2-5-260628 |
Название модели Seedance 2.5 |
content |
Массив текстовых данных | Описание генерируемого контента; в примере используется текстовый промпт |
draft |
true |
Включает режим создания пробного ролика — ключевой параметр на первом этапе |
resolution |
480p |
Разрешение пробного ролика |
ratio |
16:9 |
Соотношение сторон |
duration |
4 |
Длительность видео в секундах |
generate_audio |
false |
Нужно ли генерировать аудио; в примере эта функция отключена |
Заголовок Accept-Encoding: identity просит сервер не сжимать ответ, чтобы некоторым клиентам было проще его обработать. Рекомендуем оставить этот заголовок.
Шаг 2. Проверка статуса задачи создания пробного ролика
После создания задачи нужно периодически проверять её статус, пока она не завершится успешно и не вернёт ссылку на видео. Для проверки используется существующий интерфейс асинхронных задач: обычно GET-запрос отправляют на адрес задачи, добавив её ID. Точный путь и поля ответа смотрите в документации APIYI:
curl -X GET "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks/${TASK_ID}" \
-H "Authorization: Bearer ${APIYI_API_KEY}" \
-H "Accept-Encoding: identity"
Рекомендуемый интервал между запросами — 5–10 секунд. Слишком частые проверки не имеют смысла и могут привести к срабатыванию ограничения частоты запросов.
Шаг 3. Создание финального видео в 1080p по ID задачи с черновиком
Когда результат черновика вас устроит, укажите задачу с ним в массиве content через draft_task.id и задайте разрешение 1080p:
curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
-H "Authorization: Bearer ${APIYI_API_KEY}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: identity" \
--data '{
"model": "doubao-seedance-2-5-260628",
"content": [
{"type": "draft_task", "draft_task": {"id": "YOUR_DRAFT_TASK_ID"}}
],
"resolution": "1080p"
}'
Замените YOUR_DRAFT_TASK_ID на ID задачи с черновиком, полученный на первом шаге. Допустимое значение поля type элемента content и другие необязательные параметры уточните в примере двухэтапного запроса в документации. Задача на создание финального видео тоже выполняется асинхронно. Чтобы получить видео в 1080p, проверьте её статус так же, как на втором шаге.
Показать полный пример на Python (черновик → проверка → финальное видео)
import os
import time
import requests
API_KEY = os.environ["APIYI_API_KEY"]
BASE_URL = "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" # APIYI Seedance 异步任务接口
MODEL = "doubao-seedance-2-5-260628"
HEADERS = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
"Accept-Encoding": "identity",
}
def create_task(payload: dict) -> str:
"""创建异步任务,返回任务 ID"""
resp = requests.post(BASE_URL, headers=HEADERS, json=payload, timeout=60)
resp.raise_for_status()
data = resp.json()
return data["id"]
def wait_task(task_id: str, interval: int = 8, timeout: int = 900) -> dict:
"""轮询任务状态,直到成功或失败"""
start = time.time()
while time.time() - start < timeout:
resp = requests.get(f"{BASE_URL}/{task_id}", headers=HEADERS, timeout=30)
resp.raise_for_status()
data = resp.json()
status = data.get("status")
print(f"[{task_id}] status = {status}")
if status == "succeeded":
return data
if status in ("failed", "cancelled", "expired"):
raise RuntimeError(f"任务结束但未成功: {data}")
time.sleep(interval)
raise TimeoutError(f"任务 {task_id} 轮询超时")
def generate_draft(prompt: str) -> str:
"""第一阶段:生成 480p 样片"""
payload = {
"model": MODEL,
"content": [{"type": "text", "text": prompt}],
"draft": True,
"resolution": "480p",
"ratio": "16:9",
"duration": 4,
"generate_audio": False,
}
task_id = create_task(payload)
result = wait_task(task_id)
print("样片结果:", result.get("content"))
return task_id
def generate_final(draft_task_id: str) -> dict:
"""第二阶段:凭样片任务 ID 生成 1080p 成片"""
payload = {
"model": MODEL,
"content": [
{"type": "draft_task", "draft_task": {"id": draft_task_id}}
],
"resolution": "1080p",
}
task_id = create_task(payload)
return wait_task(task_id)
if __name__ == "__main__":
draft_id = generate_draft("一只橘猫在窗边伸懒腰,阳光洒在木地板上,镜头缓慢推进")
ok = input("样片是否满意?(y/n): ").strip().lower()
if ok == "y":
final = generate_final(draft_id)
print("成片结果:", final.get("content"))
else:
print("请调整提示词后重新生成样片。")
Названия полей в ответе (например, `id`, `status`, `content`) приведены по распространённой структуре интерфейса асинхронных задач Seedance. При интеграции ориентируйтесь на фактический ответ и при необходимости адаптируйте код.
🚀 Быстрый старт: сначала получите бесплатный тестовый баланс для новых пользователей на APIYI apiyi.com. Отработайте промпт на тестовом ролике в 480p, а затем пакетно создавайте финальные видео в 1080p. На платформе используется единый API-ключ для оплаты — так проще контролировать расходы на вызовы для нескольких видеопроектов.
Сравнение тестового режима Seedance 2.5 и прямой генерации финального видео
Выбор тестового режима зависит от того, насколько для вашего проекта важны предсказуемость результата и скорость подготовки. В таблице сравниваются два способа работы:

| Параметр | Тестовый режим (480p → 1080p) | Сразу финальное видео в 1080p |
|---|---|---|
| Количество запросов | Два запроса на создание задач | Один запрос на создание задачи |
| Стоимость проверки | Низкая: если результат не понравится, вы потеряете только стоимость тестового ролика | Высокая: при неудовлетворительном результате придётся генерировать финальное видео целиком заново |
| Предсказуемость результата | Высокая: финальное видео создаётся на основе уже утверждённого тестового ролика | Зависит от промпта и случайности |
| Общее время | Немного больше: нужно сгенерировать и проверить тестовый ролик | Меньше |
| Подходящие сценарии | Поиск идей, согласование с заказчиком, отбор материалов для пакетной генерации | Стандартизированное производство с отработанными промптами |
| Оплата | Тестовый ролик и финальное видео оплачиваются отдельно | Оплачивается только финальное видео |
Как выбрать между тестовым режимом Seedance 2.5 и прямой генерацией
Прямая генерация финального видео выигрывает за счёт простоты: достаточно одного запроса, чтобы получить готовый ролик. Но если главный объект в кадре или движение камеры окажутся неудачными, вы потеряете и деньги, и время, затраченные на создание всего видео в 1080p. Тестовый режим позволяет проверить результат на этапе генерации в низком разрешении — он лучше подходит для проектов, где нужно несколько раз доработать промпт или сначала согласовать концепцию с заказчиком.
Если шаблон промпта уже хорошо проверен и результаты стабильны, прямая генерация финального видео тоже будет разумным выбором. Практичный подход такой: для новых идей и шаблонов используйте тестовый режим, а для отработанных — прямую генерацию. Оба варианта можно в любой момент переключать в рамках одного и того же асинхронного интерфейса.
💡 Совет по выбору: чтобы оценить разницу в результатах, попробуйте каждый режим на нескольких промптах из ваших рабочих проектов. При вызове через APIYI apiyi.com оба режима используют один интерфейс и один API-ключ — для переключения достаточно изменить параметры тела запроса.
Рекомендации по подключению режима черновиков Seedance 2.5
При подключении режима черновиков к рабочей среде легко упустить несколько важных деталей. Основные рекомендации собраны в таблице:
| На что обратить внимание | Подробности | Рекомендации |
|---|---|---|
| Срок действия — 7 дней | ID задачи черновика действителен 7 дней. После истечения срока его нельзя использовать для создания финального видео | Сохраняйте в базе данных время создания черновика и напоминайте о проверке до истечения срока |
| Раздельная тарификация | Черновик и финальное видео — это две отдельные оплачиваемые задачи | Учитывайте расходы на черновики отдельно при подсчёте бюджета |
| Наследование параметров | Финальное видео наследует соответствующие настройки этапа создания черновика | Если нужно изменить промпт, создайте новый черновик — изменить промпт на втором этапе не получится |
| Асинхронный опрос | На обоих этапах нужно опрашивать систему, чтобы узнать статус задачи | Вынесите логику опроса в общий модуль и задайте разумный таймаут |
| Сохранение ссылки на видео | Ссылка на готовое видео может быть временной | Сразу после получения результата скачайте видео в собственное хранилище |
Рекомендации по проектированию рабочего процесса с режимом черновиков Seedance 2.5
Для командной работы рекомендуем разделить процесс на три этапа: «создание — проверка — запуск». Система массово создаёт черновики и отправляет их проверяющим. ID одобренных задач черновиков попадают в очередь на создание финальных видео, а отклонённые возвращаются на этап доработки промптов вместе с комментариями. Так ручная проверка сосредоточится на недорогих черновиках.
В более автоматизированные конвейеры можно добавить предварительную проверку черновиков с помощью мультимодальной модели — например, чтобы проверить, есть ли в кадре заданный объект и нет ли заметных искажений. После предварительной проверки результат передаётся человеку. Это позволяет сократить объём ручной работы. APIYI предоставляет единый интерфейс к нескольким ведущим моделям, поэтому для генерации видео и мультимодальной проверки можно использовать один API-ключ.

Часто задаваемые вопросы
Вопрос 1. Что такое режим чернового видео Seedance 2.5?
Режим чернового видео Seedance 2.5 — это двухэтапная генерация видео. На первом этапе передайте `draft: true`, чтобы создать черновик в разрешении 480p и оценить результат. На втором этапе укажите задачу с черновиком через `content[].draft_task.id`, чтобы сгенерировать финальное видео в разрешении 1080p. Режим использует существующий интерфейс асинхронных задач, поэтому дополнительная интеграция не нужна.
Вопрос 2. Чем режим чернового видео отличается от прямой генерации в 1080p?
При прямой генерации процесс проще, но если результат не устроит, придётся создавать видео заново целиком. В режиме чернового видео можно сначала проверить идею в низком разрешении, а затем, когда результат вас устроит, создать видео в высоком разрешении. Так проще контролировать итог, поэтому этот режим подходит для поиска идей и сценариев, где результат нужно согласовать.
Вопрос 3. Когда можно использовать режим чернового видео Seedance 2.5?
В центре документации APIYI 25 октября 2026 года появились инструкции по двухэтапному вызову Seedance 2.5 в режиме чернового видео. Для вызова используйте модель `doubao-seedance-2-5-260628`. Полный список параметров и примеры доступны на странице генерации видео Seedance на docs.apiyi.com.
Вопрос 4. Для каких задач лучше всего подходит режим чернового видео Seedance 2.5?
Он особенно полезен в следующих случаях:
— **Подготовка рекламных материалов**: сначала покажите клиенту черновик в 480p и согласуйте направление, а затем подготовьте версию в 1080p
— **Массовое производство коротких видео**: создайте несколько черновиков, выберите лучшие идеи и подготовьте финальные видео только для выбранных вариантов
— **Предварительный просмотр раскадровки**: быстро проверьте движение камеры и композицию, прежде чем переходить к финальной генерации
Вопрос 5. Как быстро вызвать режим чернового видео Seedance 2.5 через API?
Рекомендуем действовать так:
1. Зарегистрируйтесь на APIYI apiyi.com и создайте API-ключ
2. Получите бесплатный лимит для тестирования, доступный новым пользователям
3. Используйте пример `curl` из этой статьи. Адрес API: `https://api.apiyi.com/seedance/api/v3/contents/generations/tasks`. Сначала создайте черновик, затем — финальное видео
С тем же API-ключом можно вызывать модели OpenAI, Claude, Gemini и другие — это удобно для создания полноценного конвейера производства видео.
Вопрос 6. Как тарифицируется режим чернового видео?
Черновик и финальное видео оплачиваются отдельно: создание черновика в 480p и финального видео в 1080p — это два отдельных начисления. Актуальную стоимость смотрите на странице с ценами моделей в консоли APIYI apiyi.com. На этапе черновика используется более низкое разрешение, поэтому его удобно использовать для проверки и доработки идеи.
Вопрос 7. Что делать, если срок действия ID задачи с черновиком истёк?
ID задачи с черновиком действует 7 дней. После этого использовать его для генерации финального видео уже нельзя. Если срок истёк, черновик придётся создать заново с исходным промптом. Генерация случайна, поэтому новый черновик может отличаться от предыдущего. Рекомендуем завершить проверку в течение срока действия ID.
Вопрос 8. Какие ограничения есть у режима чернового видео?
К известным на данный момент ограничениям относятся:
— **Ограничение по модели**: режим черновиков в документации основан на `doubao-seedance-2-5-260628`
— **Срок действия**: ID задачи черновика действителен только 7 дней
— **Наследование параметров**: финальный ролик наследует соответствующие настройки черновика. Возможности изменить параметры ограничены — подробнее об этом в разделе документации «Наследование параметров и ограничения»
— **Время выполнения**: двухэтапный процесс занимает больше времени, чем прямая генерация. Если важна скорость, учитывайте это при выборе подхода
Ключевые выводы о режиме черновиков Seedance 2.5
- Два этапа: сначала передайте
draft: true, чтобы создать черновик в разрешении 480p, а затем укажите ID задачи, чтобы получить финальный ролик в разрешении 1080p - Интерфейс API не меняется: используется существующий асинхронный интерфейс задач Seedance, поэтому доработки подключённых проектов минимальны
- Ключевое поле: на этапе создания финального ролика ссылка на задачу с черновиком передаётся через
content[].draft_task.id - Правила оплаты: черновик и финальный ролик оплачиваются отдельно — платить за финальный ролик нужно только для понравившегося черновика
- Срок действия: ID задачи с черновиком действует 7 дней, поэтому важно вовремя проверить и одобрить его
- Подходящие сценарии: режим особенно полезен для поиска идей, согласования с клиентом и отбора материалов при пакетной обработке
- Как начать: получите бесплатный лимит на APIYI (apiyi.com) и пройдите весь процесс по примерам из этой статьи
Итоги
Главное о режиме черновиков Seedance 2.5:
- Сначала пробный вариант, потом финальный ролик: проверяйте композицию и движение камеры на черновике в 480p — это дешевле и помогает снизить долю неудачных роликов в 1080p.
- Простое подключение: достаточно добавить параметр
draftи ссылку наdraft_task.id, используя уже существующий асинхронный интерфейс. - Учитывайте срок действия и тарификацию: ID черновика действует 7 дней, а черновой и финальный ролики оплачиваются отдельно.
Если при создании видео вам часто приходится менять промпты, режим черновиков стоит подключить как можно скорее. Для начала прогоните несколько типичных промптов через весь процесс «черновик → финальный ролик», оцените результат и затраты, а затем масштабируйте решение на пакетное производство.
Рекомендуем быстро проверить Seedance 2.5 в режиме черновиков через APIYI apiyi.com. Платформа предлагает совместимый с OpenAI интерфейс, оплату по факту использования и бесплатный тестовый лимит для новых пользователей.
📚 Материалы
- Документация APIYI по генерации видео Seedance 2 — режим черновиков: официальная инструкция по работе с режимом черновиков Seedance 2.5
- Ссылка:
docs.apiyi.com/api-capabilities/seedance2/video-generation#draft-mode -
Описание: примеры запросов для обоих этапов, наследование и ограничения параметров, условия тарификации и срок действия
-
Центр документации APIYI: документация по всем моделям платформы
- Ссылка:
docs.apiyi.com - Описание: обзор моделей Seedance и инструкции по работе с другими моделями
Автор: техническая команда APIYI
Технические вопросы: если во время интеграции возникнут проблемы, свяжитесь с нами на главной странице APIYI apiyi.com. Другие материалы доступны в центре документации docs.apiyi.com.
