Создать видео

Создание видеозадачи Seedance 2.5 через нативный API Volcengine Ark.

Поддерживаются текстовые входные данные и опорные изображения, видео и аудио; возвращается нативный ID задачи Volcengine Ark напрямую.

Если требуется единая структура задач платформы, см. интерфейс создания в формате платформы.

Чтобы проверить черновик низкого разрешения перед созданием итогового видео, см. руководство по черновикам Draft. Черновик использует 480p, а итоговое видео на его основе — 1080p.

POST/api/v3/contents/generations/tasks

Используйте нативный путь Volcengine Ark для создания асинхронных видеозадач Seedance 2.5. Основные параметры запроса совпадают с совместимым путём; при успехе возвращается нативный ID задачи.

Содержимое запроса, ограничения материалов, ограничения типов задач и правила формата вывода совпадают с совместимым интерфейсом создания.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

Тело запроса

application/json

Нативные параметры генерации видео Seedance 2.5.

Определения типов TypeScript

Используйте тип request body в TypeScript.

model*string

ID модели Seedance 2.5, например doubao-seedance-2-5-260628. При вызове используйте модели, доступные текущему ключу API.

Длина1 <= length

content*array<|>

Список входных данных: текст, изображения, видео, аудио или ID задачи Draft. Мультимодальные референсы: до 50 материалов, включая 30 изображений, 10 видео и 10 аудиофрагментов. Длительность каждого видео или аудио — 2–30 секунд, суммарно до 30 секунд на тип. Для редактирования нужно видео 4–30 секунд. Поддерживается только аудио без других референсов. Режимы первого и первого/последнего кадров нельзя смешивать с мультимодальными референсами.

Ссылайтесь на материалы по порядку в массиве: @image1, @video1, @audio1.

Элементы1 <= items

draft?boolean

Создавать ли черновик Draft. При true требуется 480p. После успешного создания используйте content.draft_task.id в течение семи дней для итогового видео 1080p. При итоговой генерации пропустите поле или укажите false.

omni_reference_task_type?string

Тип мультимодальной задачи. auto — автоопределение; reference — генерация по референсам; edit — редактирование с видео, ratio=adaptive и duration=-1; extend — продление с видео и ratio=adaptive. Явный тип позволяет проверить ограничения заранее. Смысл запроса должен соответствовать выбранному типу.

По умолчанию"auto"

Допустимые значения

"auto"
"reference"
"edit"
"extend"

generate_audio?boolean

Генерировать ли аудио, соответствующее изображению. Обычно включение увеличивает время генерации и стоимость.

ratio?string

Соотношение сторон видео. Для генерации по тексту и мультимодальным материалам можно задать соотношение или adaptive; задачи по начальному кадру, начальному и конечному кадрам, редактирования и продления видео поддерживают только adaptive.

По умолчанию"adaptive"

Допустимые значения

"16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive"

duration?|integer

Длительность генерации в секундах. Поддерживается от 4 до 30 или -1 для автоматического выбора моделью. Редактирование видео поддерживает только -1, продление — от 4 до 30 или -1.

По умолчанию-1

resolution?string

Разрешение выходного видео: 480p, 720p или 1080p. Фактические размеры в пикселях определяются разрешением, соотношением сторон и возможностями текущей модели.

По умолчанию"720p"

Допустимые значения

"480p"
"720p"
"1080p"

output_format?string

Формат выходного видео. mp4 подходит для веба и обычного распространения; mov использует H.264, YUV444P и PCM и подходит для цветокоррекции, кеинга и композитинга.

По умолчанию"mp4"

Допустимые значения

"mp4"
"mov"

watermark?boolean

Добавлять ли водяной знак. Применение зависит от разрешений модели и настроек сервиса.

seed?integer

Случайное начальное значение в диапазоне от -1 до 4294967295. Одинаковое значение повышает воспроизводимость, но не гарантирует полного совпадения.

Диапазон-1 <= value <= 4294967295

return_last_frame?boolean

Возвращать ли последний кадр JPEG без водяного знака для последовательной генерации видео.

callback_url?string

Адрес callback после завершения задачи. Если не задан, состояние можно опрашивать через интерфейс получения задачи.

Форматuri

safety_identifier?string

Стабильный уникальный идентификатор конечного пользователя для выявления возможных нарушений правил использования. Рекомендуется передавать хеш имени пользователя, ID или адреса электронной почты, избегая передачи персональных данных.

Длина1 <= length <= 64

execution_expires_after?integer

Срок действия задачи в секундах с момента создания. Незавершённые задачи по истечении этого срока переходят в состояние истечения срока.

Форматint32

Диапазон3600 <= value <= 259200

По умолчанию172800

tools?array<>

Список инструментов, которые модель может вызывать, например web_search. Доступные инструменты и параметры зависят от разрешений текущего аккаунта.

service_tier?string

Уровень сервиса. Seedance 2.5 использует онлайн-инференс default и не поддерживает flex. Приоритет очереди задаётся отдельным параметром priority.

По умолчанию"default"

priority?integer

Приоритет очереди в одной точке инференса, от 0 до 9. Более высокое значение имеет преимущество; равные приоритеты обрабатываются в порядке отправки. Выполняемые задачи не прерываются.

Диапазон0 <= value <= 9

По умолчанию0

[key: string]?any

Тело ответа

`application/json`

curl -X POST "https://example.com/api/v3/contents/generations/tasks" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "content": [      {        "type": "text",        "text": "Маленький белый кролик летит на бумажном самолёте сквозь облака, кинематографический свет, плавное движение камеры вперёд"      }    ],    "generate_audio": true,    "ratio": "16:9",    "duration": 10,    "resolution": "1080p",    "output_format": "mp4"  }'

{
  "id": "task_xxxxx"
}

Официальная документация Volcengine Ark по созданию задач генерации видеоОпределения протокола вышестоящего сервиса и последние изменения полей задач генерации видео Seedance.

Аутентификация

Тело запроса

Тело ответа

200application/json

400

401

402

429

500

502

`application/json`