Зачем нужна библиотека активов
При генерации видео с сохранением консистентности персонажа Seedance 2.0 не принимает изображения-референсы, содержащие лица людей, напрямую (фильтрация против deepfake). Сначала вы должны загрузить изображение как доверенный asset, получить ID assetasset://xxx и указать этот ID в запросе на генерацию видео.
Этот сервис берет загрузку на себя: просто загрузите изображение → получите ID asset → сгенерируйте видео. Есть два способа использования, и данные полностью общие между ними:
Способ 1: Web UI (рекомендуется для новичков)
Зарегистрируйтесь и войдите
Загрузите и выполните ingest
- Группа ресурсов необязательна; система автоматически использует вашу группу по умолчанию. Сначала создайте группу, если хотите организовать resources по персонажам.
- Требования к изображениям: jpeg / png / webp / bmp / tiff / gif / heic; соотношение сторон 0.4–2.5; длина стороны 300–6000 px; размер каждого файла не более 30 MB.
Скопируйте ID ресурса
asset://xxx ID ресурса.Сгенерируйте видео
asset://. Для одного и того же актера в разных образах используется та же группа, повторная проверка не нужна.

The asset library web UI: the ingest tab for manual uploads, the asset list / archive tab for browsing assets and copying asset:// IDs, and the real-person verification tab for verifying and uploading real-face assets
Способ 2: API (для разработчиков)
Шаг 0: Создайте ключ Asset Library
После входа в icover.ai перейдите в Настройки → Asset Library KEY (icover.ai/en/settings/apikeys) и создайте KEY в формате sk-....

Settings → Asset Library KEY: click the create button and copy the generated sk-... key (note this is separate from the APIYI Token entry in the sidebar)
Шаг 1: Загрузите файл и получите публичный URL
Файл ассета (изображение; ассеты реальных людей также поддерживают видео / аудио) сначала должен быть доступен по публичному URL. Выберите один из вариантов: A. У вас уже есть публичный URL (ваш CDN / файловый хост) → перейдите к шагу 2. B. Загрузите в наше хранилище (два вызова: запросить подписанный URL для загрузки → PUT файла):Шаг 2: Импортируйте ассет
groupIdнеобязателен: ваша группа по умолчанию используется / создается автоматически. Чтобы организовать по персонажу: сначала выполнитеPOST /api/asset-library/groups {"name":"actor-A"}, чтобы получить ID группы, затем укажите здесь"groupId":"group-xxx".labelнеобязателен; он помогает идентифицировать ассеты в веб-интерфейсе.
Шаг 3: Опрос до Active
Импорт выполняется асинхронно (примерно 13 секунд на изображение, без SLA). Выполняйте опрос по возвращенному Id:Active в течение 90 секунд тайм-аутом, требующим проверки.
Шаг 4: Сгенерируйте видео с ID ассета (через APIYI)
Укажите ID ассета какasset://<Id> и вызовите APIYI с вашим собственным APIYI SeeDance2 token (не с ключом Asset Library):
Полная справка по эндпоинтам
[client] (400/401/403/404/502); records, GET/PATCH/DELETE для real-person/sessions и ассет PATCH возвращают {code, message, data} JSON (код 0 = успех).
Активы реального человека (полностью автоматизированный API)
Портреты реальных людей требуют, чтобы человек, которого снимают (актёр), один раз прошел проверку живости, закрепляя права на портрет на уровне источника. Весь процесс теперь полностью управляется через API; вкладка веб-интерфейса «Проверка реального человека» — это тот же процесс с интерфейсом:Шаг 1: Запустите сеанс верификации и получите ссылку H5
- Отправьте
H5Linkактёру, чтобы он открыл её на телефоне (или преобразуйте её в QR-код для сканирования). Он войдет в свою личную учетную запись Volcengine и завершит проверку живости. Освещение / угол камеры могут привести к неудачной попытке — просто повторите. BytedToken— это учетные данные для запроса; мы сохраняем их вместе с сеансом.GET /api/asset-library/real-person/sessionsпозволяет в любой момент просмотреть ваши сеансы (включая id / status / h5Link).
Шаг 2: Получите результат после завершения актером
GroupId статус сеанса становится authorized, а группа активов реального человека автоматически архивируется в вашей учетной записи (она также отображается в группе активов веб-интерфейса). Примечание: для ожидающей верификации возвращается тот же NotFound, что и для истекших учетных данных — различить эти два случая невозможно. Ссылка, долго остававшаяся без использования, может истечь; просто создайте новый сеанс.
Шаг 3: Отправьте активы в группу реального человека
Тот же endpoint для загрузки, что и для виртуальных аватаров — просто передайтеgroupId группы реального человека. Поддерживаются изображения, видео и аудио:
Active как обычно и создавайте видео с помощью asset://<Id> (Шаг 4 без изменений).
Правила и форматы активов реального человека:
- Одна группа реального человека содержит только одного человека; тот же актёр в разном стиле повторно использует ту же группу — повторная верификация не нужна.
- Каждая загрузка проходит проверку согласованности лица (видео сэмплируются каждую секунду, и каждый выбранный кадр должен пройти проверку). Профильный ракурс, несколько людей или размытый материал приведут к ошибке — используйте четкий фронтальный материал.
- Изображения до 30MB; видео mp4 / mov, 2–15 секунд, ≤50MB, соотношение сторон 0.4–2.5; аудио mp3 / wav, 2–15 секунд, ≤15MB.
Примечания
- Срок действия Image URL: preview URLs, возвращаемые query / list endpoints, — это временные адреса, действительные примерно 12 часов; не кэшируйте их надолго, сам asset ID является постоянным.
- Лимиты запросов (на уровне аккаунта Volcengine): status query — 100 QPS, ingest и другие операции — около 10 QPS. Управляйте concurrency и выполняйте повторные попытки при сбое.
- Синхронизация статуса в Web UI: после ingest через API, если статус ни разу не запрашивался, в web archive может отображаться «processing»; откройте страницу списка assets и нажмите «Refresh List», чтобы синхронизировать фактический статус.
volcengine.com/docs/82379/2333565, onboarding assets реальных людей volcengine.com/docs/82379/2315856.
ЧаВО
Чем библиотека ассетов отличается от прямой передачи референсного изображения?
Чем библиотека ассетов отличается от прямой передачи референсного изображения?
asset:// можно переиспользовать в любом числе задач генерации, сохраняя лицо и одежду персонажа единообразными между эпизодами и сценами — это идеально подходит для серийного контента, такого как анимационная драма, короткая драма и IP-персонажи. В кадре также могут появляться реальные люди: просто пройдите описанный выше поток верификации реального человека.Библиотека ассетов следует аккаунту или KEY? Как реализована изоляция ассетов?
Библиотека ассетов следует аккаунту или KEY? Как реализована изоляция ассетов?
asset:// утечет, другие вызывающие стороны на том же канале смогут использовать его в запросах на генерацию. Считайте ID ассетов секретами.Хранятся ли ассеты на собственных серверах APIYI / icover.ai?
Хранятся ли ассеты на собственных серверах APIYI / icover.ai?
asset://. Мы сами не храним и не логируем исходный контент ассетов — мы сохраняем только этот ID и его принадлежность аккаунту (это используется для описанной выше изоляции по каждому аккаунту).Для ассетов с реальным лицом есть дополнительное жесткое требование: человек на фото должен лично пройти проверку живого лица (войдя в свой аккаунт Volcengine и пройти распознавание лица), что закрепляет право на портрет на источнике — никто другой не может пройти эту проверку вместо него. Полный поток см. в разделе «Реальные лица» выше.Как нескольким отделам / командам внутри компании совместно использовать или изолировать библиотеку ассетов?
Как нескольким отделам / командам внутри компании совместно использовать или изолировать библиотеку ассетов?
asset:// по отделам — достаточно иметь ID, чтобы сослаться на него в запросе на генерацию видео (генерация видео использует собственный APIYI SeeDance2 token каждого отдела, и это не связано с KEY библиотеки ассетов). Вы также можете создать несколько KEY в рамках одного аккаунта и выдать их разным отделам (удобно для ротации / отзыва учетных данных) — эти KEY все равно будут иметь доступ к одной и той же библиотеке.Изолировать между отделами: зарегистрируйте отдельный аккаунт icover.ai для каждого отдела, у каждого будут свои KEY. Обратите внимание, что изоляция охватывает получение списка / запрос / удаление — утекший ID ассета все равно можно будет использовать, поэтому не распространяйте ID без необходимости даже между отделами.Это полноценный SeeDance 2.0?
Это полноценный SeeDance 2.0?
doubao-seedance-2-0-260128 — параметры модели, разрешения и длительности полностью совпадают с официальным предложением, без каких-либо урезаний. См. Обзор Seedance 2.0 для подробностей о модели и тарификации.Считается ли фотореалистичный портрет, сгенерированный AI, реальным человеком? Означает ли загрузка авторизацию?
Считается ли фотореалистичный портрет, сгенерированный AI, реальным человеком? Означает ли загрузка авторизацию?

Virtual-avatar example: an AI-generated photorealistic portrait with no real-world counterpart. Put the frontal face close-up plus full-body front / side / back views into one asset group for the best character consistency
Требуют ли реалистичные цифровые люди (виртуальные аватары) проверки?
Требуют ли реалистичные цифровые люди (виртуальные аватары) проверки?
asset:// сразу же можно использовать для генерации видео. Только ассеты с реальным лицом требуют, чтобы человек на фото прошел проверку живости (см. раздел про реальные лица выше).Можно ли перенести ассеты, уже загруженные / верифицированные у другого провайдера?
Можно ли перенести ассеты, уже загруженные / верифицированные у другого провайдера?
asset://, полученный через другого провайдера, принадлежит аккаунту Volcengine этого провайдера, а обращение к нему через канал APIYI возвращает asset not found. Ассеты нужно заново загрузить через этот сервис.- Ассеты виртуального аватара: их можно перенести программно массово — напишите скрипт, который повторно загрузит исходные изображения через API на этой странице, а затем обновите старые ID в своей системе на новые ID
asset://. Мы рекомендуем хранить в своей системе слой сопоставления asset-ID: в ваших бизнес-данных сохраняются только внутренние ID, поэтому при смене провайдера позже нужно будет обновить только сопоставление. - Ассеты, верифицированные по реальному человеку: верификация реального человека тоже привязана к аккаунту и не может быть перенесена — требуется повторная верификация: человек, которого снимают, должен снова пройти проверку живости (см. раздел про реальные лица выше).
- Совет для продуктов для конечных пользователей: при большом объеме существующих ассетов переносите виртуальные ассеты незаметно через фоновую задачу на сервере — пользователи ничего не заметят; для части с верифицированными реальными людьми предлагайте пользователям пройти повторную верификацию при обновлении системы или выпуске новой версии, так это воспринимается гораздо естественнее.