Skip to main content
POST

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

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

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

string
обязательно
Имя модели генерации видеоПоддерживаемые модели:
  • seedance-2.0 — стандартная версия, поддерживает текст-в-видео, изображение-в-видео, видео из первого/последнего кадра, референсное видео, референсное аудио и видео со звуком
  • seedance-2.0-fast — быстрая версия, те же функции, что и стандартная, с более высокой скоростью генерации
  • seedance-2.0-mini — мини-версия, те же функции, что и стандартная версия
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
Проверяемые данные:
  • Текст: prompt, negative_prompt
  • Изображения: image_urls, image_with_roles[].url, first_frame_image, last_frame_image
  • Приватные изображения asset://: найти и проверить исходный публичный URL
  • Изображения Base64: проверить после преобразования в публичный URL
video_urls, audio_urls, а также приватные видео- и аудиоматериалы не проверяются, поскольку модель модерации не поддерживает видео и аудио.Поддерживаемые ID моделей: seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-2.0-face, seedance-2.0-fast-face, seedance-2-0 (прежнее имя) и seedance-2.5.Сам вызов модерации не оплачивается пользователем, отправившим запрос на генерацию видео.
  • При обнаружении запрещенного содержимого синхронно возвращается HTTP 400 (nsfw_content_detected). Задача и task_id не создаются, квота генерации видео не списывается
  • Если сервис модерации недоступен, истекло время ожидания или ответ некорректен, действует режим fail-open и генерация продолжается. Этот параметр не является абсолютной гарантией безопасности содержимого
  • Входные данные, которые нельзя преобразовать в публичный URL изображения, пропускаются; неподдерживаемые модели молча игнорируют nsfw_check: true
Пример:
Ответ при обнаружении:
string
Описание содержимого видеоОбязательно для генерации текст-в-видео; необязательно для изображение-в-видео или видео-референс-в-видеоРекомендуется чётко указывать объект, действие, движение камеры и стиль для лучших результатов генерации
  • Длина промпта ограничена 4000 символами, но рекомендуется до 500 символов.
  • Модель seedance-2.0-mini не имеет ограничения на количество символов. Рекомендация: промпты на китайском языке не должны превышать 500 символов, а промпты на английском — 1000 слов. Слишком большой объём текста может привести к рассеиванию информации, и модель может упустить детали, сосредоточившись только на ключевых моментах, из-за чего в видео будут отсутствовать некоторые элементы.
Пример: "A kitten yawning at the camera"
integer
по умолчанию:"5"
Длительность видео (в секундах)Поддерживаемый диапазон: от 4 до 15 секундПо умолчанию: 5
string
по умолчанию:"16:9"
Соотношение сторон видеоСоотношение сторон должно быть в диапазоне 0.5–2.5Варианты:
  • 16:9 — горизонтальное
  • 9:16 — вертикальное
  • 1:1 — квадратное
  • 4:3 — традиционное соотношение
  • 3:4 — вертикальное традиционное соотношение
  • 21:9 — сверхширокое
  • adaptive — адаптивное (автоматически соответствует входному изображению/видео)
По умолчанию: 16:9
string
по умолчанию:"720p"
Разрешение видеоВарианты:
  • 480p — стандартное разрешение
  • 720p — высокое разрешение
  • 1080p — Full HD (поддерживается только моделью seedance-2.0)
  • 4k — Ultra HD (поддерживается только моделью seedance-2.0)
По умолчанию: 720p
integer
Случайное seed-значение для управления случайностью генерируемого контента
  • При одинаковом запросе разные seed-значения дадут разные результаты
  • При одинаковом запросе одинаковое seed-значение даст похожие результаты, но точная идентичность не гарантируется
boolean
по умолчанию:"true"
Генерировать ли аудио (видео со звуком)При значении true видео будет содержать сгенерированное ИИ сопровождающее аудиоПри значении false видео не будет содержать аудио (видео без звука)По умолчанию: true
boolean
по умолчанию:"false"
Возвращать ли изображение последнего кадраПри значении true в результате задачи дополнительно будет возвращён URL изображения последнего кадра видео, который можно использовать для непрерывной генерации видеоПо умолчанию: false
array<object>
Список инструментов для расширенных возможностей, таких как веб-поискПример: [{"type": "web_search"}]
array<string>
Массив URL изображений для генерации изображение-в-видеоПоддерживает два формата:
  • Обычный URL изображения: https://example.com/cat.jpg
  • URL ассета (одобренный ассет): asset://asset_a
Пример: ["https://example.com/cat.jpg"] или ["asset://asset_a"]
URL ассета поддерживается всеми моделями Seedance 2.0: seedance-2.0, seedance-2.0-fast и seedance-2.0-mini.
  • image_urls и image_with_roles нельзя использовать одновременно
  • Максимум 9 референсных изображений
array
Массив изображений с ролями, поддерживает указание первого/последнего кадра
Когда в поле url используется URL ассета, поддерживаются все модели Seedance 2.0: seedance-2.0, seedance-2.0-fast и seedance-2.0-mini.
Пример:
Формат URL ассета:
  • image_urls и image_with_roles нельзя использовать одновременно
  • При использовании изображений первого/последнего кадра параметры video_urls и audio_urls недоступны
array<string>
Массив URL референсных видеоПоддерживает два формата:
  • Обычный URL видео: https://example.com/reference.mp4
  • URL ассета (одобренный ассет): asset://asset_a
Пример: ["https://example.com/reference.mp4"] или ["asset://asset_a"]
URL ассета поддерживается всеми моделями Seedance 2.0: seedance-2.0, seedance-2.0-fast и seedance-2.0-mini.
  • При использовании изображений первого/последнего кадра (image_with_roles) референсные видео недоступны
  • Максимум 3 референсных видео, 1.8с < общая длительность < 15.2с
  • Разрешение референсного видео должно быть в диапазоне от 480P до 720P
array<string>
Массив URL референсного аудиоПоддерживает два формата:
  • Обычный URL аудио: https://example.com/speech.wav
  • URL ассета (одобренный ассет): asset://asset_a
Пример: ["https://example.com/speech.wav"] или ["asset://asset_a"]
URL ассета поддерживается всеми моделями Seedance 2.0: seedance-2.0, seedance-2.0-fast и seedance-2.0-mini.
  • При использовании изображений первого/последнего кадра (image_with_roles) референсное аудио недоступно
  • Максимум 3 файла референсного аудио, общая длительность не более 15 секунд
  • Референсное аудио должно использоваться вместе с референсными изображениями или референсными видео

Ответ

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

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

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

Сценарий 2: изображение-в-видео (первый кадр)

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

Сценарий 4: видео из референсного видео

Сценарий 5: референсное видео + референсное аудио

Сценарий 6: видео со звуком

Сценарий 7: непрерывная генерация видео (возврат последнего кадра)

Сценарий 8: генерация в быстрой версии

Сценарий 9: референсные изображения + референсное видео + референсное аудио (мультимодальное видео)

Сочетайте референсные изображения, референсное видео и референсное аудио, чтобы создать иммерсивное рекламное видео от первого лица. Идеально подходит для продвижения товаров, рекламы брендов и других сценариев, требующих объединения материалов из нескольких источников.

Сценарий 10: изображение-в-видео с URL ассета

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

Сценарий 11: указание референсного портрета с URL ассета (image_with_roles)

Сценарий 12: быстрая версия + URL ассета для изображение-в-видео

Сценарий 13: изображение через URL ассета + референсное видео (перенос движений)

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

Отличия от версии 1.5 Pro