Библиотека ассетов Seedance 2.0 (видео с сохранением персонажа)

​

Зачем нужна библиотека активов

​

Способ 1: Web UI (рекомендуется для новичков)

​

Метод 2: API (разработчиков)

​

Шаг 0: Создайте ключ Asset Library

Authorization: Bearer sk-your-asset-library-KEY

​

Шаг 1: Загрузите файл и получите публичный URL

# 1. Request a presigned upload URL
curl -X POST https://icover.ai/api/storage/presign \
  -H "Authorization: Bearer sk-your-asset-library-KEY" \
  -H "Content-Type: application/json" \
  -d '{"ext":"jpg","contentType":"image/jpeg"}'
# → { "code":0, "data": { "uploadUrl":"...", "publicUrl":"https://cdn.icover.ai/..." } }

# 2. PUT the file to uploadUrl (Content-Type must match the presign request)
curl -X PUT "the-uploadUrl-you-just-received" \
  -H "Content-Type: image/jpeg" \
  --data-binary @portrait.jpg
# Once it succeeds, publicUrl is your file's public address
# Same for video/audio: swap ext/contentType to mp4/video/mp4, mp3/audio/mpeg, etc.

​

Шаг 2: Загрузите asset

curl -X POST https://icover.ai/api/asset-library/assets \
  -H "Authorization: Bearer sk-your-asset-library-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "https://cdn.icover.ai/uploads/seedance/xxx.jpg",
    "label": "actor-A-front"
  }'
# → Raw Volcengine response: { ..., "Result": { "Id": "asset-20260702xxxx-xxxxx" } }

• groupId необязателен: будет использована или автоматически создана ваша группа по умолчанию. Чтобы организовать по character: сначала POST /api/asset-library/groups {"name":"actor-A"}, чтобы получить ID группы, затем укажите "groupId":"group-xxx" здесь.
• label необязателен; он помогает вам идентифицировать asset в веб-интерфейсе.

​

Шаг 3: Опрос до состояния Active

curl https://icover.ai/api/asset-library/assets/asset-20260702xxxx-xxxxx \
  -H "Authorization: Bearer sk-your-asset-library-KEY"
# → Result.Status == "Active" means ready; "Failed" means re-upload

​

Шаг 4: Сгенерируйте видео с идентификатором ресурса (через APIYI)

curl -X POST https://api.apiyi.com/seedance/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-your-APIYI-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {"type":"text","text":"The character in Image 1 smiles at the camera, slow push-in, natural light"},
      {"type":"image_url","image_url":{"url":"asset://asset-20260702xxxx-xxxxx"},"role":"reference_image"}
    ],
    "ratio":"16:9","duration":5,"resolution":"720p"
  }'
# Returns a task id; poll GET .../tasks/{id} until status=succeeded, then read content.video_url

​

Полный справочник эндпоинтов

• Эндпоинты для одного объекта (создать группу / импортировать / получить статус / удалить) передают необработанный JSON Volcengine без изменений как при успехе, так и при ошибке.
• Списковые эндпоинты (GET на groups / assets) объединяются и фильтруются по вашим собственным ассетам, поэтому это не побайтный вывод upstream: сохраняется каждое исходное поле Volcengine, а также несколько наших собственных полей метаданных с префиксом _ (например, _library). Игнорируйте неизвестные поля с префиксом _ при разборе — добавление новых таких полей не нарушает обратную совместимость.
• Наши собственные ошибки — это обычный текст с префиксом [client] (400/401/403/404/502).
• records, GET/PATCH/DELETE для real-person/sessions и ассет PATCH возвращают JSON {code, message, data} (код 0 = успех).

​

Активы реального человека (полностью автоматизированный API)

​

Шаг 1: Запустите сеанс верификации и получите ссылку H5

curl -X POST https://icover.ai/api/asset-library/real-person/sessions \
  -H "Authorization: Bearer sk-your-asset-library-KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"actor-A"}'
# → Raw Volcengine response: { "Result": { "BytedToken":"2026...", "H5Link":"https://ark.volcengine.com/..." } }

• Отправьте H5Link актёру, чтобы он открыл её на телефоне (или преобразуйте её в QR-код для сканирования). Он войдет в свою личную учетную запись Volcengine и завершит проверку живости. Освещение / угол камеры могут привести к неудачной попытке — просто повторите.
• BytedToken — это учетные данные для запроса; мы сохраняем их вместе с сеансом. GET /api/asset-library/real-person/sessions позволяет в любой момент просмотреть ваши сеансы (включая id / status / h5Link).

​

Шаг 2: Получите результат после завершения актером

curl -X POST https://icover.ai/api/asset-library/real-person/sessions/{session-id} \
  -H "Authorization: Bearer sk-your-asset-library-KEY"
# Verified → { "Result": { "GroupId": "group-xxxx" } }  ← the actor's dedicated real-person asset group
# Not yet  → 404 NotFound.<token> (raw Volcengine text; this is normal — query again after verification)

​

Шаг 3: Отправьте активы в группу реального человека

curl -X POST https://icover.ai/api/asset-library/assets \
  -H "Authorization: Bearer sk-your-asset-library-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "groupId": "group-xxxx",
    "imageUrl": "https://cdn.icover.ai/uploads/seedance/xxx.jpg",
    "label": "actor-A-front-full-body",
    "assetType": "Image"
  }'

• Одна группа реального человека содержит только одного человека; тот же актёр в разном стиле повторно использует ту же группу — повторная верификация не нужна.
• Каждая загрузка проходит проверку согласованности лица (видео сэмплируются каждую секунду, и каждый выбранный кадр должен пройти проверку). Профильный ракурс, несколько людей или размытый материал приведут к ошибке — используйте четкий фронтальный материал.
• Изображения до 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», чтобы синхронизировать фактический статус.

​

FAQ

Чем библиотека ресурсов отличается от прямой передачи референсного изображения?

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

Взимается ли дополнительная плата за библиотеку ресурсов? Чем это отличается от самостоятельного официального подключения?

На APIYI это бесплатно — просто используйте библиотеку вместе с API Seedance 2.0. Никакой ежегодной платы и отдельного договора.Официально частная библиотека ресурсов оплачивается отдельно для клиентов без рамочного соглашения: годовая закупка стоимостью в несколько сотен тысяч юаней (Volcengine также продаёт её напрямую). Иными словами, самостоятельное подключение означает ежегодную плату сверх стоимости использования модели и обычно требует прохождения процедур подтверждения статуса корпоративного клиента и закупки. При использовании APIYI достаточно одного видеотокена Seedance — библиотека ресурсов работает сразу после подключения.Мы ценим долгосрочных пользователей, поэтому эта стоимость уже включена в цену нашего API; для клиентов, использующих SD2 в обычном режиме, дополнительная плата при стандартных объёмах бизнеса не взимается.

Привязана ли библиотека ресурсов к аккаунту или к ключу? Как реализована изоляция ресурсов?

Одной строкой: icover.ai изолирует ресурсы, а APIYI обеспечивает унифицированный вызов — сторона генерации проверяет только ID ресурса, и для его использования достаточно иметь этот ID.Она привязана к аккаунту. Архитектура устроена следующим образом: все пользователи icover.ai используют единый общий аккаунт APIYI Volcengine, которому принадлежит библиотека ресурсов; icover.ai добавляет на уровне сервиса изоляцию по аккаунтам — каждый аккаунт может просматривать, запрашивать и удалять только собственные ресурсы и не может видеть ID ресурсов других пользователей.Ключи не обеспечивают изоляцию: несколько ключей библиотеки ресурсов в одном аккаунте эквивалентны и получают доступ к одной и той же библиотеке. Если вам нужна изоляция ресурсов (например, для разделения данных между клиентами или направлениями бизнеса), зарегистрируйте отдельный аккаунт icover.ai для каждой стороны и создайте ключи в каждом из них — создание нового ключа в том же аккаунте ничего не изолирует.Учитывайте границу безопасности: эта изоляция распространяется на просмотр, запрос и удаление, но Volcengine не может выполнять авторизацию по ID — если asset:// ID утечёт, другие вызывающие стороны в том же канале смогут указать его в запросах на генерацию. Считайте ID ресурсов конфиденциальными данными.

Хранятся ли ресурсы на собственных серверах APIYI / icover.ai?

Это зависит от способа передачи файла:

• Вы указываете общедоступный URL (собственный CDN / хостинг изображений): исходный файл никогда не проходит через нас — мы только передаём этот URL в Volcengine.
• Вы загружаете файл через /api/storage/presign: сначала файл сохраняется в нашем объектном хранилище (cdn.icover.ai) для получения общедоступного URL, который затем передаётся в Volcengine. Исходный файл остаётся в нашем хранилище.

В обоих случаях сам ресурс в итоге обрабатывается на стороне Volcengine, который возвращает asset:// ID. Наша собственная база данных хранит только этот ID и сведения о принадлежности аккаунту (используемые для описанной выше изоляции по аккаунтам); содержимое ресурса мы не сохраняем.Для ресурсов с реальными лицами действует дополнительное обязательное требование: фотографируемый человек должен лично пройти проверку лица в реальном времени (войти в собственный аккаунт Volcengine и пройти распознавание лица), что закрепляет права на портрет непосредственно в источнике — никто другой не может пройти эту проверку от его имени. Полное описание процедуры приведено выше в разделе «Ресурсы с реальными лицами».

Как несколько отделов или команд внутри компании могут совместно использовать библиотеку ресурсов или изолировать её?

Использовать одну библиотеку (рекомендуется, самый простой вариант): достаточно одного аккаунта и одного ключа. Управляйте ID ресурсов централизованно в собственной системе и передавайте asset:// ID каждому отделу — для указания ресурса в запросе на генерацию видео достаточно иметь его ID (для генерации видео используется собственный видеотокен APIYI Seedance каждого отдела, не связанный с ключом библиотеки ресурсов). Также можно создать несколько ключей в одном аккаунте и передать их разным отделам (это удобно для ротации и отзыва учётных данных) — такие ключи всё равно получают доступ к одной и той же библиотеке.Изолировать отделы друг от друга: зарегистрируйте отдельный аккаунт icover.ai для каждого отдела, используя собственные ключи для каждого аккаунта. Обратите внимание: изоляция распространяется на просмотр, запрос и удаление — утёкший ID ресурса всё равно можно использовать, поэтому не следует без необходимости распространять ID даже между отделами.

Это полнофункциональная версия SeeDance 2.0?

Да. Канал Seedance в APIYI использует официальные полнофункциональные doubao-seedance-2-5-260628 и doubao-seedance-2-0-260128 — параметры модели, разрешения и длительность полностью совпадают с официальным предложением, без каких-либо ограничений. Подробные сведения о модели и ценах приведены в разделе Обзор Seedance 2.0 / 2.5.

Считается ли фотореалистичный портрет, созданный ИИ, реальным человеком? Означает ли загрузка наличие разрешения?

Нет, он не считается реальным человеком. Фотореалистичный портрет, созданный ИИ и не имеющий соответствия в реальном мире (например, персонаж, созданный с помощью модели вроде Nano Banana), является виртуальным аватаром — он сразу проходит процедуру добавления виртуального аватара без этапа авторизации. Реальным лицом считается только фотография реального существующего человека — для таких изображений загрузка НЕ означает наличие разрешения; канал добавления виртуальных аватаров отклоняет их, а фотографируемый человек должен пройти проверку живого присутствия (см. раздел о реальных лицах выше).Существует три типа материалов персонажа:

Тип материала	Примеры	Способ использования
Анимированные / стилизованные персонажи	Аниме, мультяшные персонажи, персонажи в стиле 3D-мультфильмов	Фотореалистичное лицо отсутствует, поэтому такие материалы обычно не блокируются: используйте общедоступный URL / Base64-референсное изображение напрямую, добавление в библиотеку не требуется
Виртуальный аватар (фотореалистичный портрет, созданный ИИ)	Создано моделью, соответствующего человека не существует (см. пример ниже)	Используйте процедуру добавления виртуального аватара на этой странице и указывайте asset:// ID
Реальное лицо	Фотографии знаменитостей, моделей или самого пользователя	Используйте полностью автоматизированную процедуру верификации реального человека через API; ресурс можно использовать после прохождения человеком проверки живого присутствия

Требуют ли реалистичные цифровые люди (виртуальные аватары) проверки?

Нет. Добавление виртуального аватара полностью автоматизировано — ручная проверка и этап авторизации не требуются: после загрузки система автоматически предварительно обрабатывает изображение, примерно через 13 секунд статус меняется на Active, а asset:// ID сразу становится доступен для генерации видео. Только ресурсы с реальными лицами требуют, чтобы фотографируемый человек прошёл проверку живого присутствия (см. раздел о реальных лицах выше).

Можно ли перенести ресурсы, уже добавленные в библиотеку или верифицированные у другого провайдера?

Их нельзя повторно использовать напрямую. И библиотека ресурсов Volcengine, и верификация реального человека привязаны к исходному аккаунту: asset:// ID, полученный через другого провайдера, принадлежит аккаунту Volcengine этого провайдера, а обращение к нему через канал APIYI возвращает asset not found. Ресурсы необходимо повторно добавить с помощью этого сервиса.

• Ресурсы виртуальных аватаров: их можно программно перенести массово — напишите скрипт, который повторно загрузит исходные изображения через API на этой странице, а затем замените старые ID в своей системе на новые asset:// ID. Мы рекомендуем хранить слой сопоставления ID ресурсов в собственной системе: бизнес-данные будут содержать только ваши внутренние ID, поэтому при последующей смене провайдера достаточно обновить сопоставление.
• Ресурсы, верифицированные для реальных людей: верификация реального человека также привязана к аккаунту и не может быть перенесена — требуется повторная верификация: фотографируемый человек должен снова пройти проверку живого присутствия (см. раздел о реальных лицах выше).
• Рекомендации для продуктов, ориентированных на потребителей: если у вас уже есть большое количество ресурсов, перенесите виртуальные ресурсы незаметно с помощью фоновой задачи на серверной стороне — пользователи этого не заметят; для ресурсов с верифицированными реальными людьми предложите пользователям повторно пройти проверку во время обновления системы или выпуска новой версии — это будет восприниматься гораздо естественнее.

​

Свяжитесь с нами