Библиотека ресурсов цифровых персонажей Seedance
Создавайте, проверяйте, загружайте и используйте ресурсы цифровых персонажей Seedance через нативные интерфейсы Action.
Библиотека ресурсов цифровых персонажей Seedance управляет ресурсами реальных людей и виртуальных персонажей, которые можно использовать в Seedance 2.0 и Seedance 2.5. Нативные интерфейсы сохраняют Action, Version и соответствующие структуры запросов и ответов; вызовы выполняются с ключом API AGTCloud.
Выбор типа ресурса
| Тип ресурса | Способ создания | Сценарии использования | Основные ограничения |
|---|---|---|---|
| Виртуальный персонаж (AIGC) | Создайте контейнер ресурсов напрямую, затем загрузите ресурсы | Виртуальные ведущие, персонажи и материалы продуктов | Адрес загрузки должен быть доступен серверу |
| Реальный человек (LivenessFace) | Сначала пройдите проверку живого лица | Цифровые персонажи реальных людей и собственный образ | Ресурсы должны соответствовать проверенному лицу |
Подключение виртуального персонажа
Создать контейнер ресурсов
Вызовите CreateAssetGroup для создания группы ресурсов AIGC и сохраните возвращённый ID группы.
Загрузить ресурс
Загрузите в группу публично доступное изображение, видео или аудио. Успешная загрузка означает лишь принятие запроса; обычно ресурс сначала переходит в состояние обработки.
Дождаться доступности ресурса
Опрашивайте интерфейс получения ресурса до состояния Active. При Failed прочитайте информацию об ошибке и не используйте этот ресурс.
Использовать в видеозадаче
Используйте asset://ASSET_ID или asset://GROUP_ID как URL ресурса в нативном запросе создания Seedance. Ресурсы должны принадлежать текущему аккаунту и быть доступны для использования.
Подключение реального человека
Для реального человека сначала создайте сеанс проверки, предложите пользователю выполнить захват данных живого человека в браузере телефона, затем вызовите GetVisualValidateResult для получения ID группы ресурсов реального человека; если сеанс истёк, создайте новый.
После получения группы ресурсов реального человека можно загружать дополнительные ресурсы, но лицо должно соответствовать проверенному человеку. Несоответствующие ресурсы переходят в состояние ошибки с FaceMismatch.
Состояние и результаты ресурсов
Processing: ресурс ещё обрабатывается; проверяйте состояние примерно каждые 3 секунды, избегая опроса без интервалов.Active: ресурс доступен для генерации видео.Failed: прочитайте причину ошибки и прекратите опрос; исправьте ресурс и загрузите повторно.- Подписанный URL из
GetAssetдействует около 11,5 часа; не сохраняйте его как постоянный адрес и не распространяйте публично.
Ресурсы привязаны к аккаунту ключа API. Доступ к несуществующему ресурсу или ресурсу другого аккаунта может возвращать ResourceNotFound. Удаление группы удаляет также её ресурсы; перед операцией проверьте целевой ID и область удаления.
Связанные интерфейсы
- Начните с создания группы ресурсов или создания сеанса проверки человека.
- После готовности ресурсов отправляйте ссылки
asset://...через нативное создание видео Seedance 2.5 или нативное создание видео Seedance 2.0.