Эта страница посвящена пути с кодом: преобразуйте локальное изображение в ID объекта
asset://, а затем используйте его для генерации видео с сохранением образа персонажа — один сценарий, от начала до конца. Для документации по каждому эндпоинту и веб-интерфейса без кода см. Asset Library; полную таблицу параметров эндпоинта генерации см. в Video Generation API.Когда вам нужны ссылки на активы
При генерации видео с единым образом персонажа Seedance 2.0 не принимает изображения-референсы с фотореалистичными человеческими лицами напрямую (фильтрация против deepfake). Сначала вы должны загрузить портрет как доверенный asset, получитьasset://xxx asset ID и указать его в запросе на генерацию — чтобы лицо и одежда персонажа оставались единообразными в разных эпизодах и кадрах. Сначала найдите свой случай:
Предварительные требования
Пайплайн в общих чертах
Локальное изображение → 1)presign URL для прямой загрузки и PUT файл, чтобы получить публичный URL → 2) загрузите объект и получите ID объекта → 3) выполняйте опрос, пока Active (около 13 секунд на изображение) → 4) укажите asset://<Id> в запросе на генерацию, называя его «Image 1» в prompt → 5) выполняйте опрос задачи, пока succeeded → 6) скачайте content.video_url (подписанная ссылка истекает через 24 часа — сохраните ее сразу).
Если у вас уже есть публичный URL изображения, пропустите шаг 1. ID объектов постоянны — загрузите один раз, используйте в ссылках всегда.
Полный код
Расширенное использование с несколькими ресурсами
- Несколько изображений-референсов: поместите несколько
image_urlэлементов вcontent(0–9 изображений, каждое сrole: "reference_image") и указывайте на них как на «Изображение 1», «Изображение 2» по порядку. Для одного персонажа наилучшую согласованность дает совместное использование полного фронтального снимка в полный рост и нейтрального крупного плана лица анфас. - Смешивание источников:
asset://ID, публичные URL и Base64 (data:image/png;base64,...) можно смешивать в одном массивеcontent— только изображения с фотореалистичными лицами должны проходить черезasset://. - Видео / аудио-референсы: вы также можете добавить 0–3
video_urlэлемента (role: "reference_video") и 0–3audio_urlэлемента (role: "reference_audio"); требуется как минимум одно изображение или одно видео, а аудио должно отправляться вместе с изображением или видео. - Ресурсы реального человека: сначала запустите полностью автоматизированный поток проверки реального человека — актер проходит проверку на живость, и вы получаете отдельную группу ресурсов для реального человека
GroupId; передавайте ее какgroupIdпри загрузке. Код на стороне генерации идентичен коду на этой странице.
Распространённые ошибки
Связанные страницы
Обзор Seedance 2.0
Выбор модели, цены, таблицы разрешений и FAQ
API генерации видео
Полная таблица параметров, четыре режима генерации и формат ответа
Библиотека ресурсов
Все эндпоинты библиотеки ресурсов, веб-интерфейс без кода и верификация реального человека