Перейти к основному содержанию
POST
cURL
Эндпоинт омни-референс Seedance API генерации видео. Генерация нового видео путём слияния мультимодального контента на основе референсных изображений и видео. Все 4 модели. Отправьте асинхронную задачу и верните id.
Использование: Включите text, image_url (role=reference_image), video_url (role=reference_video), опционально audio_url (role=reference_audio) в content, установите omni_reference_task_type: "reference".

Авторизации

TT-API-KEY
string
header
обязательно

Получите API-ключ в панели TTAPI.

Тело

application/json
model
enum<string>
обязательно

ID модели

Доступные опции:
doubao-seedance-2-5-260628,
doubao-seedance-2-0-260128,
doubao-seedance-2-0-fast-260128,
doubao-seedance-2-0-mini-260615
content
object[]
обязательно

Список входного контента. Поддерживает комбинацию text + image_url (reference_image) + video_url (reference_video) + audio_url (reference_audio)

Элемент входного контента,поддерживается text、image_url、video_url、audio_url、draft_task тип

omni_reference_task_type
enum<string>
обязательно

Тип задачи, фиксированное значение reference (референс-в-видео). Варианты: auto=автоопределение, reference=референс-в-видео, edit=редактирование, extend=продление

Доступные опции:
reference
resolution
enum<string>
по умолчанию:720p

Разрешение видео. Seedance 2.5: 480p, 720p, 1080p. По умолчанию 720p

Доступные опции:
480p,
720p,
1080p
ratio
enum<string>
по умолчанию:adaptive

Соотношение сторон видео. По умолчанию adaptive (авто), или укажите конкретное

Доступные опции:
adaptive,
16:9,
4:3,
1:1,
3:4,
9:16,
21:9
duration
integer
по умолчанию:-1

Длительность видео (сек). Диапазон [4, 30] или -1 (умный выбор). duration и frames выберите одно из двух, frames приоритет выше

generate_audio
boolean
по умолчанию:true

Генерировать синхронизированный звук. true=вокал/эффекты/музыка, false=без звука。только Seedance 2.5/2.0 поддерживается

output_format
enum<string>
по умолчанию:mp4

Формат вывода. mp4=стандартный формат, mov=высокая точность цвета(H.264+yuv444p+PCM, для профессиональногоого постпродакшена). только Seedance 2.5 поддерживается

Доступные опции:
mp4,
mov
watermark
boolean
по умолчанию:false

Добавить водяной знак。true=отобразить в правом нижнем углу「AI создать」

return_last_frame
boolean
по умолчанию:false

Вернуть изображение последнего кадра。true=вернуть jpeg формат последнего кадра,можнодлянепрерывное видеосоздать

draft
boolean
по умолчанию:false

Включить режим черновика. true=создать превью 480p. Только Seedance 2.5

callback_url
string

URL обратного вызова。Статус задачиизмененииотправка POST запрос,содержимое совпадает с запросом API ответом API

execution_expires_after
integer
по умолчанию:172800

Тайм-аут задачи (сек). Диапазон [3600, 259200](1~72 ч),по умолчанию 172800(48 ч)

priority
integer
по умолчанию:0

Приоритет выполнения. Диапазон [0, 9],больше значение = выше приоритет,по умолчанию 0(FIFO)。только Seedance 2.5/2.0 поддерживается

safety_identifier
string

Уникальный идентификатор пользователя, макс. 64 символа. Рекомендуется передавать хешированную строку

tools
object[]

Конфигурация инструментов。только Seedance 2.5/2.0 поддерживается

service_tier
enum<string>
по умолчанию:default

Уровень обслуживания. default=онлайн инференс, flex=оффлайн инференс(цена 50%, Seedance 2.5/2.0 пока не поддерживается)

Доступные опции:
default
seed
integer
по умолчанию:-1

Случайное зерно. Диапазон [-1, 2147483647], -1=случайное

camera_fixed
boolean
по умолчанию:false

Фиксированная камера. true=фиксированная камера (не поддерживается для сцен с референсным изображением)

frames
integer

Количество кадров видео. диапазон [29, 289], должно соответствовать 25+4n формат. и duration выберите одно из двух, frames приоритет выше

Ответ

200 - application/json

Задача успешно отправлена

id
string
обязательно

ID задачи

Последнее изменение 22 октября 2026 г.