> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Загружает ли Seedance 2.0 автоматически референсы лиц в библиотеку ассетов? Срабатывает ли при этом фильтр deepfake?

> Seedance 2.0 не может напрямую принимать reference images с реалистичными человеческими лицами — сначала их нужно загрузить в библиотеку ассетов, чтобы получить asset:// ID. На этой странице описаны правильный рабочий процесс и обходной путь для фильтра deepfake.

## Краткий ответ

Два вопроса, два ответа:

1. **Нет, автоматической загрузки не происходит.** Референсные изображения НЕ отправляются автоматически в библиотеку ассетов при вызове Seedance 2.0. Вам нужно отдельно загрузить их через API библиотеки ассетов, чтобы получить ID `asset://`, а затем указать его в запросе на генерацию видео.
2. **Да, фильтр deepfake срабатывает.** Референсные изображения с реалистичными человеческими лицами, переданные напрямую, будут заблокированы вышестоящей системой проверки контента. Отправка фотографий реальных людей для генерации видео завершится ошибкой.

Выберите правильный рабочий процесс в зависимости от типа персонажа:

* **Виртуальный аватар** (реалистичный человек, сгенерированный ИИ, без реального прототипа): используйте путь «ингест виртуального аватара» → получите ID `asset://` → укажите его
* **Реальное человеческое лицо** (знаменитость, модель, фото конечного пользователя): сначала выполните сканирование на живость → выполните ingest с `groupId`, специфичным для человека → получите ID `asset://` → укажите его
* **Результат из Seedance за последние 30 дней**: можно использовать как референс для воссоздания (разрешённый платформой путь)

## Подробное объяснение

### Почему нельзя передавать изображения лиц напрямую?

Seedance 2.0 **не может напрямую принимать reference images с реалистичными человеческими лицами** (deepfake filter). Это ограничение upstream на content-safety, а не политика apiyi.

### Правильный рабочий процесс

<Steps>
  <Step title="Определите тип ассета">
    Определите, к какой категории относится ваше изображение:

    * **Аниме / стилизованные персонажи**: без реалистичного лица, **ingest не требуется** — передавайте public URL или base64 напрямую
    * **Виртуальные аватары** (реалистичные люди, сгенерированные AI): пройдите через «ингест виртуального аватара» — полностью автоматически, без проверки
    * **Изображения реальных людей** (знаменитость, модель, конечный пользователь): сначала требуется liveness scan
  </Step>

  <Step title="Загрузите в библиотеку ассетов, чтобы получить ID asset://">
    * В веб-интерфейсе: загрузите в [библиотеку ассетов icover.ai](https://icover.ai/zh/seedance-official/asset-library), дождитесь, пока статус не станет «Доступно», скопируйте `asset://xxx`
    * API: используйте `presign` + `POST /api/asset-library/assets` для полного пути интеграции — см. [Asset reference end-to-end](/ru/api-capabilities/seedance2/asset-reference)
  </Step>

  <Step title="Укажите ID ассета в запросе на генерацию видео">
    В `content` запроса Seedance 2.0 поместите `asset://<Id>` в `image_url` и используйте «image 1» в prompt, чтобы обозначить персонажа. См. [Seedance 2.0 Video Generation API](/ru/api-capabilities/seedance2/video-generation).
  </Step>
</Steps>

<Info>
  **Два ключа — не путайте их**:

  * **KEY библиотеки ассетов** (создаётся в icover.ai): только для загрузки / ingest / получения списка / удаления
  * **APIYI SeeDance2 token** (создаётся на api.apiyi.com, должна быть включена группа `SeeDance2`): только для эндпоинта генерации видео

  Подробности в [Asset library](/ru/api-capabilities/seedance2/asset-library).
</Info>

### Особый сценарий для ассетов реальных людей

Фотографии реальных людей не могут обойти deepfake-фильтр, просто «загрузив в библиотеку» — **сам человек** должен пройти liveness scan (войти в свой аккаунт Volcano и пройти распознавание лица). Это закрепляет права на портрет на исходном уровне; прокси не допускается.

<Steps>
  <Step title="Сгенерируйте ссылку для liveness scan">
    Попросите человека отсканировать QR-код / открыть ссылку на телефоне и пройти liveness-check через свой аккаунт Volcano
  </Step>

  <Step title="Получите результат liveness scan">
    Получите группу ассетов реального человека, привязанную к конкретному субъекту `groupId`
  </Step>

  <Step title="Выполните ingest с groupId">
    Загрузите ассет с `groupId` этой группы. После прохождения проверки согласованности лица вы получите ID `asset://`. Один и тот же субъект повторно использует ту же группу для разных образов — повторная верификация не нужна
  </Step>
</Steps>

<Warning>
  **Реальный человек ≠ AI-сгенерированный реалистичный человек.** AI-сгенерированные реалистично выглядящие люди, у которых нет аналога в реальном мире (например, сгенерированные Nano Banana), относятся к «виртуальным аватарам» — проходите через «ингест виртуального аватара» напрямую, без шага авторизации. Только фотографии **реальных людей** считаются «изображениями реальных человеческих лиц» — загрузка такой фотографии не равнозначна авторизации; субъект должен пройти liveness scan.
</Warning>

## Вопросы и ответы

<AccordionGroup>
  <Accordion title="Срок действия asset IDs истекает?">
    Нет. `asset://` asset IDs являются постоянными — ingest выполняется один раз, ссылка остается навсегда. Однако `content.video_url`, возвращаемый после успешной генерации, — это подписанный URL со сроком действия 24 часа — **скачайте и сразу разместите у себя после успешного завершения задачи**.
  </Accordion>

  <Accordion title="Если проверка соответствия лица для одного изображения не пройдена, можно ли заменить его другим?">
    Да. Вы можете загрузить несколько изображений в одну и ту же группу активов (боковые ракурсы, несколько лиц, размытые изображения могут не пройти — рекомендуются четкие фронтальные ракурсы). `asset://` ID находится на уровне группы активов, а не отдельного изображения — все изображения в одной группе используют один и тот же ID.
  </Accordion>

  <Accordion title="Тарифицируется ли библиотека активов отдельно?">
    Нет. ingest виртуального аватара, верификация реального человека и другие функции частной библиотеки активов включены в Seedance 2.0 API без дополнительной годовой платы.
  </Accordion>

  <Accordion title="Почему при прямой передаче изображения лица возвращается 400?">
    Фильтр upstream по безопасности контента блокирует это. 400 не списывает баланс, но запрос отклоняется — сначала завершите ingest библиотеки активов, затем укажите `asset://` ID.
  </Accordion>
</AccordionGroup>

## Связанные документы

* [Seedance 2.0 API генерации видео](/ru/api-capabilities/seedance2/video-generation)
* [Seedance 2.0 библиотека assets](/ru/api-capabilities/seedance2/asset-library)
* [Сквозной справочник assets (с полным кодом)](/ru/api-capabilities/seedance2/asset-reference)
* [Обзор Seedance 2.0](/ru/api-capabilities/seedance2/overview)