video-shuoshan/docs/API文档/「保密信息」【申请权限填客户名称】控制台上传自有虚拟人像至素材资产库（邀测用户版）.md

「⚠️保密信息」【申请权限填客户名称】控制台上传自有虚拟人像至素材资产库（邀测用户版）

请注意，仅开白用户在控制台可见《上传虚拟人像素材合规承诺函》的签署入口，若仅可见《素材资产功能使用规则》，则需申请开白

1. 介绍

3月19日起功能上线后，火山方舟会在控制台支持完成开白的B端客户批量上传和管理虚拟人资产，同时支持使用API创建、管理，允许企业上传自有AIGC虚拟人（含品牌定制 IP、自制数字人、采购的合规虚拟人等），在线勾选确认《上传虚拟人像素材合规承诺函》，承诺上传的虚拟人像为企业合法所有、未侵犯任何第三方权益、不与任何自然人的肖像形象相同或相似、仅用于合规用途，即可完成确权，将虚拟人像上传入库，在推理中使用，仅可使用已入库的素材资产进行视频生成，未入库素材，即使为已入库同一角色的不同妆造，也无法使用。

2. 使用流程

	释义	举例
素材资产（Asset）	一个素材文件（本期仅支持图片），是方舟Seedance系列模型可直接用于推理的可信资产
资产组合（Group）	将原子化的资产（Asset）组合起来，可以人物、工作室、项目组等维度将素材进行分组管理

2.1 方舟控制台

1. 首次使用签署使用承诺函：开白用户可见火山方舟体验中心-视觉模型-视频生成页面顶部【我的素材资产】，点击进入素材资产管理界面，首次使用前需签署《上传虚拟人像素材合规承诺函》《素材资产功能使用规则》（仅需授权一次）

• 创建素材资产组合（Group）：可通过控制台上传单个或多个资产文件批量创建素材资产组合（Group），当前仅支持上传的每个文件分别创建资产组，暂不支持创建一个资产组，同时注入多个资产

• 单次创建上限为100个资产组合（Group），单账号允许的资产组合（Group）数量本期不设限

• 单个素材上传要求：

• 图片格式：控制台本期仅支持文件后缀为.jpg、.jpeg、.png（与API有差异）

• 文件大小：单张图片小于30M

• 宽高比（宽/高）：(0.4, 2.5)

• 宽高长度（px）：(300, 6000)

• 资产组合标题/描述/资产名称字段：

  资产组合名称（Group Name）	必填，最大字符12（与API有差异）
  资产组合描述（Group Description）	选填，最大字符100（与API有差异）
  资产名称（Asset Name）	必填，最大字符12（与API有差异）

  

  • 控制台上传时暂不支持直接编辑上述字段， 支持通过文件命名自动解析

  命名规范：{AssetName1}&&{GroupName1}&&{GroupDescription1(选填)}.jpg

  若无&&连接符，则文件名=GroupName=AssetName

  • GroupName或GroupDescription被审核拦截时，Group会创建失败

  • 创建完成后支持修改上述字段

• 批量新增素材：可点击进入某个资产组合（Group），在当前资产组合（Group）下新增资产（Asset）

• 单次新增素材上限为500个资产，单账号允许的资产（Asset）数量本期不设限

• 单个素材上传要求：

• 图片格式：控制台本期仅支持文件后缀为.jpg、.jpeg、.png（与API有差异）

• 文件大小：单张图片小于30M

• 宽高比（宽/高）：(0.4, 2.5)

• 宽高长度（px）：(300, 6000)

• 文件名会自动解析填入AssetName

资产名称（Asset Name）	必填，最大字符12（与API有差异）

• 文件内容或AssetName被审核拦截时，Asset列表会展示失败状态，有对应报错信息。

• 库内资产使用：可在体验中心界面查看已上传的资产组合（Group）和对应组合下的资产（Asset），一键填入体验中心输入框，或一键复制URI通过API传入

2.2 API入库

1. 首次使用签署使用承诺函：通过火山方舟控制台开通管理，点击右上角的【开通素材资产库权限】，勾选同意协议，进行功能开通使用

• 通过Asset API创建、管理素材资产：

  【对客材料】

  • 素材资产库实践手册： 【申请权限填客户名称】私域虚拟人像素材资产库（邀测用户版）

  • Asset API文档： 【申请权限填客户名称】Asset API 参考文档（邀测用户版）