Skip to main content
Эта страница посвящена пути с кодом: преобразуйте локальное изображение в ID объекта asset://, а затем используйте его для генерации видео с сохранением образа персонажа — один сценарий, от начала до конца. Для документации по каждому эндпоинту и веб-интерфейса без кода см. Asset Library; полную таблицу параметров эндпоинта генерации см. в Video Generation API.

Когда вам нужны ссылки на активы

При генерации видео с единым образом персонажа Seedance 2.0 не принимает изображения-референсы с фотореалистичными человеческими лицами напрямую (фильтрация против deepfake). Сначала вы должны загрузить портрет как доверенный asset, получить asset://xxx asset ID и указать его в запросе на генерацию — чтобы лицо и одежда персонажа оставались единообразными в разных эпизодах и кадрах. Сначала найдите свой случай:

Предварительные требования

Два разных ключа — не путайте их:
  • KEY библиотеки ресурсов (создается в Settings → Asset Library KEY на icover.ai, sk-...): для загрузки / приема / запроса ресурсов; см. Шаг 0 страницы Библиотеки ресурсов.
  • токен APIYI SeeDance2 (создается на api.apiyi.com, sk-..., при включенной группе SeeDance2): для эндпоинта генерации видео.

Пайплайн в общих чертах

Локальное изображение → 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 объектов постоянны — загрузите один раз, используйте в ссылках всегда.

Полный код

Указывайте ресурсы как «Изображение 1», «Изображение 2» в prompt (в соответствии с их порядком в массиве content) — никогда не указывайте в prompt исходный 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–3 audio_url элемента (role: "reference_audio"); требуется как минимум одно изображение или одно видео, а аудио должно отправляться вместе с изображением или видео.
  • Ресурсы реального человека: сначала запустите полностью автоматизированный поток проверки реального человека — актер проходит проверку на живость, и вы получаете отдельную группу ресурсов для реального человека GroupId; передавайте ее как groupId при загрузке. Код на стороне генерации идентичен коду на этой странице.

Распространённые ошибки

Связанные страницы

Обзор Seedance 2.0

Выбор модели, цены, таблицы разрешений и FAQ

API генерации видео

Полная таблица параметров, четыре режима генерации и формат ответа

Библиотека ресурсов

Все эндпоинты библиотеки ресурсов, веб-интерфейс без кода и верификация реального человека