Skip to main content
POST

Авторизация

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

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

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

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

array
Массив изображений с ролями для более точного управленияПример:
  • Поддерживается только одно изображение на каждую роль
  • last_frame поддерживается только версией seedance-1-0-pro-quality, fast-версия не поддерживает одновременное использование первого и последнего кадра

Ответ

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

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

Сценарий 1: быстрый предпросмотр горизонтального видео

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

Сценарий 3: эффект динамического перехода (первый/последний кадр)

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