Seedance 2.5

Используйте doubao-seedance-2.5 для создания видео вывода. Эта страница содержит полный запрос, необходимый для этой модели.

Факты о модели

Свойство	Значение
ID модели	`doubao-seedance-2.5`
Эндпоинт	`POST /api/v1/generation/create`
Вывод	Видео
Режимы	текст-в-видео, изображение-в-видео, видео-ссылка, аудио-ссылка
Цены	Просмотреть текущие цены

Минимальный запрос

curl -X POST https://api.apihubs.ru/api/v1/generation/create \
  -H "Authorization: Bearer $API_STOCK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "doubao-seedance-2.5",
  "input": {
    "prompt": "A cinematic scene with soft natural light"
  }
}'

Ответ на создание содержит идентификатор задачи:

{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "not_started",
    "createdAt": "2026-08-22T12:00:00.000Z"
  }
}

Параметры

Параметры должны находиться внутри объекта верхнего уровня input. Неизвестные поля отклоняются.

Параметр	Тип	Обязательный	По умолчанию	Описание
`prompt`	string	Да	—	Промпт для видео. Изображения, видео и аудио можно указывать в промпте позиционно.
`duration`	number	Нет	`5`	Длительность результата в секундах (4–30). Для видео-референсов входная и выходная длительность тарифицируются по ставке референсного ввода.
`size`	`"adaptive"` \| `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"`	Нет	`"adaptive"`	Соотношение сторон результата. Для первого/последнего кадра и продолжения требуется `adaptive`.
`resolution`	`"480p"` \| `"720p"` \| `"1080p"`	Нет	`"480p"`	Разрешение результата и тариф за секунду.
`generateAudio`	boolean	Нет	`true`	Добавлять ли аудио в сгенерированное видео.
`nsfwCheck`	boolean	Нет	`false`	Проверять промпт и изображения перед генерацией.
`watermark`	boolean	Нет	`false`	Добавлять водяной знак, созданный ИИ.
`seed`	number	Нет	—	Seed для управления случайностью; идентичный результат не гарантируется.
`outputFormat`	`"mp4"` \| `"mov"`	Нет	`"mp4"`	Контейнер выходного видео.
`omniReferenceTaskType`	`"auto"` \| `"reference"` \| `"extend"`	Нет	`"auto"`	Подсказка типа задачи. Редактирование недоступно до поддержки расчётов за переменную длительность.
`imageUrls`	string[]	Нет	—	URL изображений-референсов (не более 30 суммарно в обоих полях изображений).
`imageWithRoles`	object[]	Нет	—	Изображения с ролями `first_frame`, `last_frame` или `reference_image`. Элемент имеет форму `{ url: string, role: string }`.
`videoUrls`	string[]	Нет	—	Публичные URL видео-референсов (до 10 файлов по 2–30 секунд, не более 30 секунд суммарно). Длительность проверяется до списания.
`audioUrls`	string[]	Нет	—	URL аудио-референсов (до 10 файлов, не более 30 секунд суммарно).
`returnLastFrame`	boolean	Нет	`false`	Возвращать последний кадр результата для последующих задач.
`tools`	object[]	Нет	—	Дополнительные инструменты, например привязка к веб-поиску. Элемент имеет форму `{ type: "web_search" }`.

Режимы

Минимальная генерация

{
  "model": "doubao-seedance-2.5",
  "input": {
    "prompt": "A cinematic scene with soft natural light"
  }
}

С URL изображений

{
  "model": "doubao-seedance-2.5",
  "input": {
    "prompt": "A cinematic scene with soft natural light",
    "imageUrls": [
      "https://example.com/input.jpg"
    ]
  }
}

С URL видео

{
  "model": "doubao-seedance-2.5",
  "input": {
    "prompt": "A cinematic scene with soft natural light",
    "videoUrls": [
      "https://example.com/input.mp4"
    ]
  }
}

С URL аудио

{
  "model": "doubao-seedance-2.5",
  "input": {
    "prompt": "A cinematic scene with soft natural light",
    "audioUrls": [
      "https://example.com/input.mp3"
    ]
  }
}

Ограничения

duration: минимум 4; максимум 30.
size: разрешены: adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9.
resolution: разрешены: 480p, 720p, 1080p.
outputFormat: разрешены: mp4, mov.
omniReferenceTaskType: разрешены: auto, reference, extend.

Неверные типы, неподдерживаемые значения перечислений, числа вне допустимого диапазона и отсутствующие обязательные поля возвращают HTTP 400 с error.code: "invalid_input". Исправьте запрос, а не повторяйте его без изменений.

Результат

Опрашивайте задачу или предоставьте URL верхнего уровня webhook в запросе на создание:

curl https://api.apihubs.ru/api/v1/task/status/$TASK_ID \
  -H "Authorization: Bearer $API_STOCK_KEY"

Успешная медиа-задача возвращает один или несколько файлов:

{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "finished",
    "files": [
      {
        "fileUrl": "https://storage.api-stock.com/result.mp4",
        "fileType": "video"
      }
    ],
    "createdTime": "2026-08-22T12:00:00.000Z"
  }
}

Смотрите Задачи и вебхуки для терминальных статусов, повторных попыток и доставки вебхуков.