Seedance2.0 真人人像素材使用

Seedance 2.0 真人人像素材能力用于先完成真人认证，再上传该真人对应的可信素材，供后续视频生成使用。

流程图

使用流程

Step 1. 创建真人认证 H5 链接

调用 1-创建真人认证H5链接，获取认证页面链接。

终端用户打开 H5 链接后，按照页面提示完成真人认证。

Step 2. 在业务方 callback 中接收 `bytedToken`

认证完成后，业务方提供的 callback 地址会收到认证结果参数。

建议重点关注以下字段：

resultCode：认证结果，10000 表示成功

bytedToken：后续换取 GroupId 的凭证

当 resultCode=10000 时，说明该次真人认证通过，可以继续下一步。

Step 3. 使用 `bytedToken` 获取 `GroupId`

调用 2-使用BytedToken获取GroupId，传入 bytedToken，获取该真人对应的 GroupId。

GroupId 是后续上传和管理素材时的核心标识。一个 GroupId 对应一个真人。

Step 4. 上传素材 URL 创建 Asset

调用 3-上传素材URL创建Asset，传入 GroupId 和素材 URL 创建素材。

说明：

当前仅支持通过 URL 上传素材

不支持文件流上传

每次请求上传一个素材文件

Step 5. 查询素材状态

调用 4-查询素材状态查询素材处理状态。

CreateAsset 为异步接口，只有当素材状态变为 Active 后，才可以用于后续视频生成；如果状态为 Failed，表示该素材处理失败，不能继续使用。

素材使用说明

一个 GroupId 对应一个真人，同组素材应为同一人。

上传素材时，系统会校验素材与认证真人是否一致；不一致时，素材可能无法入库。

仅 Active 状态的素材可用于后续视频生成。

建议业务方保存好 GroupId 和 AssetId，便于后续查询、管理和删除。

接口清单

1-创建真人认证H5链接

2-使用BytedToken获取GroupId

参考资料

火山引擎官方文档：录入真人形象素材

流程图#

使用流程#

Step 1. 创建真人认证 H5 链接#

Step 2. 在业务方 callback 中接收 bytedToken#

Step 3. 使用 bytedToken 获取 GroupId#

Step 4. 上传素材 URL 创建 Asset#

Step 5. 查询素材状态#

素材使用说明#

接口清单#

参考资料#

流程图