Создать видео Seedance 2.5 Flash (нативный формат)

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

Создайте видеозадачу Seedance 2.5 Flash в нативном формате. После отправки возвращается ID задачи.

POST/api/v3/contents/generations/tasks

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

bearerAuth

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

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

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

Тело запроса

application/json

Параметры генерации видео Seedance 2.5 Flash. Укажите содержимое и роли в соответствии с выбранным режимом ввода.

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

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

model*string

ID модели генерации видео. Model ID Seedance 2.5 Flash — doubao-seedance-2-5-flash-261115; также можно использовать соответствующий Endpoint ID.

content*array<|||||>

Входные данные: текст, изображения, видео или аудио. Допускается до 10 изображений, 5 видео и 5 аудиофрагментов. Каждый видео- или аудиофрагмент длится 2–30 секунд, суммарно — не более 30 секунд для каждого типа. Референсное видео для редактирования должно длиться 4–30 секунд. Поддерживается использование только аудиореференсов.

Один первый кадр: одно изображение, role не задан или first_frame. Первый/последний: два изображения с явными first_frame, last_frame. Референсы требуют соответствующих ролей reference_*. Эти режимы несовместимы. Последний кадр с другим соотношением сторон обрезается под первый.

Изображения/аудио: публичный URL, Base64 data URI или asset://ASSET_ID; видео: публичный URL или ID материала. Тело до 64 MB; для крупных файлов лучше URL. Ссылки в промпте: @image1, @video1, @audio1.

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

draft?false

Режим Draft не поддерживается. Не передавайте поле или укажите false; значение true недопустимо.

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

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

false

omni_reference_task_type?string

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

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

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

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

generate_audio?boolean

Создавать ли синхронный звук. true добавляет речь, звуковые эффекты и музыку по промпту и визуальному содержимому; false создаёт видео без звука. Выходной звук стереофонический независимо от числа каналов входного аудио.

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

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. Фактические размеры в пикселях зависят от разрешения и соотношения сторон.

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

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

"480p"
"720p"

output_format?string

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

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

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

"mp4"
"mov"

watermark?boolean

Водяной знак «Создано ИИ» справа внизу: true добавляет, false отключает.

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

seed?integer

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

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

return_last_frame?boolean

При true поле content.last_frame_url возвращает последний кадр JPEG без водяного знака, размером с видео, пригодный для непрерывной генерации. При false кадр не возвращается.

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

callback_url?string

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

Состояния уведомлений: queued, running, succeeded, failed, expired. Уведомления об успехе/ошибке повторяются три раза, если за 5 секунд нет подтверждения успешного получения.

Форматuri

safety_identifier?string

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

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

execution_expires_after?integer

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

Форматint32

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

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

tools?array<>

Интернет-поиск выполняется по решению модели на основе промпта. Может повысить актуальность и задержку. Число поисков — usage.tool_usage.web_search; 0 означает, что поиска не было.

service_tier?string

Уровень обслуживания. Seedance 2.5 Flash поддерживает только онлайн-режим default, без flex; приоритет очереди задаётся через priority.

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

priority?integer

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

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

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

[key: string]?any

Тело ответа

`application/json`

curl -X POST "https://api.agtcloud.cn/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "generate_audio": true,
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 11,
    "content": [
      {
        "type": "text",
        "text": "Камера медленно движется по долине в утреннем тумане. Солнечный свет падает на лес, звучат тихие звуки природы."
      }
    ]
  }'

{
  "id": "TASK_ID"
}

Получение результата генерации

Используйте полученный ID с API получения задачи, чтобы проверить состояние и получить видео. Для работы с ID ресурсов сначала добавьте материалы через загрузку ресурса.

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

Создать видео Seedance 2.5 Flash (нативный формат)

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

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

429

Получение результата генерации

`application/json`

`application/json`

`application/json`