Перейти к основному содержанию
Seedance 2.0 генерирует видео на основе доверенных эталонных ресурсов — лица, одежды, продукта, голоса. Чтобы генерация оставалась согласованной и соответствовала требованиям, эти эталоны хранятся в приватной библиотеке ресурсов, которой модель доверяет на этапе инференса. OrcaRouter предоставляет эту библиотеку по адресу /v1/asset. На этой странице объясняется, как работает библиотека и что требуется. Точные эндпоинты, параметры и интерактивную консоль смотрите в разделе API Reference → Seedance Assets.

​
Как устроена библиотека

  • Группа ресурсов (Asset Group) — контейнер. Для группы реального человека одна группа соответствует одному реальному человеку; для виртуальной группы это логическая группировка (например, один персонаж).
  • Ресурс (Asset) — отдельный файл (изображение, видео или аудио) внутри группы. Только ресурсы, достигшие статуса Active, можно использовать в генерации видео.
На готовый ресурс в запросе на генерацию видео вы ссылаетесь как asset://<asset_id>.

​
Два вида групп

Операции загрузки и управления одинаковы для обоих видов; различаются они только в том, как создаётся группа.
Виртуальная (AIGC)Реальный человек (LivenessFace)
Для чегоВымышленные / ИИ-персонажи, реквизит, сценыОбраз реального человека
Кем создаётсяПрямым вызовом созданияОднократной верификацией лица этим человеком
ПочемуНет личности, которую нужно защищатьПраво на изображение — согласие фиксируется у источника
Обе библиотеки требуют Advanced Creation Rights; квота на объём распределяется между ними. Библиотека реальных людей доступна приглашённым аккаунтам.

​
Требования к файлам ресурсов

Ресурсы передаются как публично доступный URL (без загрузки файлов, без base64). Ограничения:
ТипФорматыОграничения
Изображениеjpeg, png, webp, bmp, tiff, gif, heic/heifсоотношение сторон (Ш/В) 0.4–2.5 · 300–6000 px по каждой стороне · < 30 MB
Видеоmp4, mov480p/720p/1080p · 2–15 с · соотношение 0.4–2.5 · 300–6000 px · всего пикселей 409,600–2,086,876 · 24–60 fps · ≤ 50 MB
Аудиоwav, mp32–15 с · ≤ 15 MB
Портретный контент, рекомендации (для согласованности лица):
  • Эталон в полный рост: вертикальный кадр человека в полный рост анфас.
  • Крупный план лица: вертикальный, нейтральное выражение, кадрирование выше плеч, лицо занимает примерно две трети кадра.
Загрузка нескольких хороших эталонов одного и того же человека в одну группу улучшает то, насколько точно сгенерированное видео воспроизводит его лицо и одежду.

​
Жизненный цикл ресурса (загрузка асинхронна)

Загрузка ресурса немедленно возвращает asset_id; затем файл предобрабатывается в фоне. Опрашивайте ресурс, пока его Status не стабилизируется:
  • Processing — всё ещё предобрабатывается; продолжайте опрос.
  • Active — готов; используйте его в генерации видео.
  • Failed — предобработка отклонила его; изучите Error (например, формат/размер, блокировка модерацией контента или — для групп реальных людей — FaceMismatch).
SLA по времени загрузки не гарантируется; видеоресурсы занимают больше времени, чем изображения. Подписанный URL для скачивания (URL), возвращаемый для ресурса, временный (~12 часов).

​
Процесс верификации реального человека

Группа реального человека создаётся тем, что человек однократно верифицирует себя. Ваш бэкенд никогда не обрабатывает данные его лица — он только оркестрирует процесс:
1

Запустить сессию

Ваш бэкенд просит OrcaRouter запустить сессию верификации. Вы получаете в ответ H5-ссылку (размещённую страницу проверки лица) и session_id.
2

Человек проходит верификацию

Вы передаёте H5-ссылку конечному пользователю. Он открывает её на своём устройстве — вход в OrcaRouter не требуется — и проходит проверку лица. Он авторизуется один раз; позже новые образы того же человека можно добавлять в ту же группу без повторной верификации.
3

Группа создаётся

При успехе страница верификации перенаправляет браузер конечного пользователя обратно на колбэк OrcaRouter (обрабатывается автоматически), и новая группа регистрируется за вами. Если вы передали return_url, пользователь возвращается на вашу страницу.
4

Опросить результат

Ваш бэкенд опрашивает сессию, пока status не станет success (с новым group_id) или failed. После этого вы загружаете ресурсы и генерируете видео точно так же, как для виртуальной группы.
Согласованность лица. Когда вы загружаете изображение в группу реального человека, оно сравнивается с верифицированным эталоном. Другой человек (или несколько лиц на одном изображении) отклоняется — ресурс переходит в Failed / FaceMismatch. Имя и описание группы можно задать после создания через операцию обновления группы.

​
Квота

У вашего аккаунта есть максимальное количество ресурсов (по умолчанию 100, по всем группам суммарно). Загрузки сверх лимита отклоняются с 403.

​
Ссылка на ресурс в генерации видео

Как только ресурс становится Active, ссылайтесь на него через asset://<asset_id> в metadata.content[] запроса на видео Seedance и указывайте на него в промпте по типу + позиции ([Image 1], [Video 1], [Audio 1]) — никогда по сырому asset id: 
{
  "model": "byteplus/dreamina-seedance-2-0-260128",
  "prompt": "The girl in [Image 1] arranges items on the counter.",
  "metadata": {
    "content": [
      { "type": "image_url", "role": "reference_image",
        "image_url": { "url": "asset://asset-20260318071009-xy98z" } }
    ]
  }
}

​
Далее

  • API Reference → Seedance Assets — каждый эндпоинт, полные параметры и интерактивная площадка (именно здесь находятся примеры запросов/ответов).
  • Seedance Video — эндпоинт генерации видео, который потребляет эти ресурсы.