视频
Seedance 素材管理
Seedance 素材组、媒体素材和真人认证接口的请求契约。
这组页面已将 Seedance 素材管理的 13 个接口接入 Modelflare 文档站，字段、状态和归属规则与当前实现保持一致。
仿真人与真人
Section titled “仿真人与真人”Seedance 2.0 和 Seedance 2.5 不能把仿真人、真人照片或写实人脸直接作为图片地址或 Base64 放进生成请求。先把图片上传到素材库，状态变为 Active 后，在生成请求的 content[] 里使用 asset://素材ID。真人必须先完成下方的活体认证，认证成功后再使用返回的真人素材组。不含写实人脸的图片仍可以直接使用图片地址。
| 接口 | 路径 | 用途 |
|---|---|---|
| 创建素材组 | /volc/asset/CreateAssetGroup |
创建素材组，用于组织 Seedance 工作流中的图片、视频和音频素材。 |
| 创建图片素材 | /volc/asset/CreateAsset |
向已有素材组添加图片。处理完成后，可在支持的 Seedance 请求中用 asset://<ID> 引用。 |
| 创建视频素材 | /volc/asset/CreateAsset |
向已有素材组添加视频。处理完成后，返回的素材 ID 可用于支持该能力的 Seedance 工作流。 |
| 创建音频素材 | /volc/asset/CreateAsset |
向已有素材组添加音频，供支持该能力的 Seedance 工作流使用。 |
| 创建真人认证会话 | /volc/asset/CreateVisualValidateSession |
创建移动端真人活体认证会话。用户打开返回的 H5Link 完成认证。 |
| 查询真人认证结果 | /volc/asset/GetVisualValidateResult |
使用 CreateVisualValidateSession 返回的临时凭证查询真人认证结果。 |
| 查询素材组列表 | /volc/asset/ListAssetGroups |
按名称、ID 和素材组类型筛选素材组列表。查询操作不产生生成计费。 |
| 查询素材列表 | /volc/asset/ListAssets |
按名称、素材组和素材组类型筛选素材。只有 Status: Active 后，才能在 Seedance 请求中使用素材 ID。 |
| 查询素材 | /volc/asset/GetAsset |
按 ID 查询单个素材。用于轮询异步上传，直到 Status 变为 Active 或 Failed。 |
| 更新素材组 | /volc/asset/UpdateAssetGroup |
更新已有素材组的信息，例如素材组名称。 |
| 更新素材 | /volc/asset/UpdateAsset |
更新素材名称，或将素材移动到另一个素材组。 |
| 删除素材 | /volc/asset/DeleteAsset |
按 ID 删除单个素材。 |
| 删除素材组 | /volc/asset/DeleteAssetGroup |
按 ID 删除单个素材组。 |
- 创建素材组并保存
GroupId。 - 上传图片、视频或音频，保存返回的素材
Id。 - 轮询
GetAsset或ListAssets，直到状态为Active。 - 在支持的 Seedance 请求中使用
asset://<ID>。 - 不再需要时删除素材或素材组。
真人认证接口单独使用会话凭证和具备相应权限的 API Key，不应与普通素材上传混用。