Skip to main content
POST

Авторизация

string
обязательно
Все эндпоинты API требуют аутентификации через Bearer TokenПолучите ваш API Key:Перейдите на страницу управления API Key, чтобы получить ваш API KeyДобавьте его в заголовок запроса:

Параметры запроса

string
обязательно
Имя модели генерации видеоПоддерживаемые модели:
  • seedance-1-5-pro — версия 1.5 Pro, поддерживает генерацию аудио и первый/последний кадр
string
обязательно
Описание содержимого видеоПодробно описывайте сцены, действия и стили, чтобы получить лучшие результаты генерацииПример: "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand"
integer
по умолчанию:"5"
Длительность видео (в секундах)Поддерживаемый диапазон: 4 ~ 12 секундПо умолчанию: 5
string
по умолчанию:"16:9"
Соотношение сторон видеоВарианты:
  • 16:9 — горизонтальное
  • 9:16 — вертикальное
  • 1:1 — квадратное
  • 4:3 — традиционное соотношение
  • 3:4 — вертикальное традиционное соотношение
  • 21:9 — сверхширокое
По умолчанию: 16:9
string
по умолчанию:"720p"
Разрешение видеоВарианты:
  • 480p — стандартное разрешение
  • 720p — высокое разрешение
  • 1080p — Full HD
По умолчанию: 720p
integer
Целочисленное seed-значение для управления случайностью генерируемого контентаДиапазон значений: целое число от -1 до 2^32-1
  • При одинаковом запросе, если модель получает разные seed-значения (например, seed не указан или установлен в -1, что использует случайное число), будут генерироваться разные результаты
  • При одинаковом запросе, если модель получает одинаковое seed-значение, будут генерироваться похожие результаты, но идентичность не гарантируется
boolean
по умолчанию:"true"
Генерировать ли аудиоПри значении true видео будет содержать сгенерированное ИИ сопровождающее аудиоПо умолчанию: true
Генерация аудио поддерживается только в серии Seedance 2.0 и Seedance 1.5 Pro
boolean
по умолчанию:"false"
Зафиксировать ли камеруПри значении true положение камеры остаётся фиксированнымПо умолчанию: false

Комбинации разрешения и соотношения сторон

array<url>
Массив URL изображений для генерации видео из изображенияПравила автоматического распределения ролей:
  • 1 изображение = первый кадр
  • 2 изображения = первый кадр + последний кадр
Пример: ["https://example.com/first.png", "https://example.com/last.png"]
  • image_urls и image_with_roles нельзя использовать одновременно
array
Массив изображений с ролями для более точного управленияПример:
  • image_urls и image_with_roles нельзя использовать одновременно
  • Первый и последний кадр поддерживают только одно изображение каждый

Ответ

integer
Код состояния ответа, 200 при успехе
array
Массив данных ответа

Сценарии использования

Сценарий 1: текст-в-видео с аудио

Сценарий 2: высококачественное вертикальное короткое видео

Сценарий 3: динамическое видео из первого кадра

Сценарий 4: эффект перехода с первым/последним кадром

Запрос результатов задачиГенерация видео — это асинхронная задача, которая при отправке возвращает task_id. Используйте эндпоинт Получение статуса задачи, чтобы запросить прогресс и результаты генерации.

Отличия от версии 1.0