Seedance 数字人素材库
使用原生 Action 接口完成 Seedance 数字人素材创建、核验、上传和引用。
Seedance 数字人素材库用于管理 Seedance 2.0 和 Seedance 2.5 可引用的真人形象与虚拟形象素材。原生接口保留 Action、Version 和对应的请求响应结构，并通过 AGTCloud API Key 调用。
选择素材类型
| 素材类型 | 创建方式 | 适合场景 | 主要限制 |
|---|---|---|---|
| 虚拟形象（AIGC） | 直接创建素材容器后上传 | 虚拟主播、角色和产品素材 | 上传地址必须能被服务端访问 |
| 真人形象（LivenessFace） | 先完成活体人脸核验 | 真人数字人和本人形象 | 素材必须与核验人脸一致 |
虚拟形象接入流程
创建素材容器
调用 CreateAssetGroup 创建 AIGC 素材组，并保存返回的素材组 ID。
上传素材
向素材组上传公网可访问的图片、视频或音频。上传成功只表示请求已受理，素材通常先进入处理中状态。
等待素材可用
轮询素材查询接口，直到状态变为 Active。进入 Failed 后读取错误信息，不要继续使用该素材。
在视频任务中引用
使用 asset://素材ID 或 asset://素材组ID 作为 Seedance 原生创建请求中的素材 URL。被引用的素材必须属于当前账户并处于可用状态。
真人形象接入流程
真人形象需要先创建核验会话，引导用户在手机浏览器中完成活体采集，再调用 GetVisualValidateResult 取得真人素材组 ID；会话失效后应重新创建。
取得真人素材组后可以继续上传素材，但人脸必须与核验人一致。不匹配的素材会进入失败状态并返回 FaceMismatch。
素材状态与结果
Processing：素材仍在处理，建议间隔约 3 秒查询，不要无间隔轮询。Active：素材可以用于视频生成。Failed：读取错误原因并停止轮询；修正素材后重新上传。GetAsset返回的签名 URL 有效期约 11.5 小时，不应作为永久地址保存或公开分发。
素材与 API Key 所属账户绑定。访问不存在或不属于当前账户的素材时可能返回 ResourceNotFound。删除素材组会连同组内素材一起删除，操作前应确认目标 ID 和删除范围。
相关接口
- 从创建素材组或创建真人核验会话开始。
- 素材可用后，可前往 Seedance 2.5 原生创建视频或 Seedance 2.0 原生创建视频提交
asset://...引用。