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

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

# 1. 介绍

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



# 2. 使用流程

![画板 1](images/whiteboard_1_1774075398978.png)

|                 | 释义                                              | 举例                                                                                                                                                                                                                                                        |
| --------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **素材资产（Asset）** | 一个素材文件（本期**仅支持图片**），是方舟Seedance系列模型可直接用于推理的可信资产 | ![Image Token: QwfCbg7HWodX84x6Jwdl8iWxg6d](images/QwfCbg7HWodX84x6Jwdl8iWxg6d.png)                                                                                                                                                                       |
| **资产组合（Group）** | 将原子化的资产（Asset）组合起来，可以人物、工作室、项目组等维度将素材进行分组管理     | ![Image Token: KXmAbBvXTophYGxhUzulqOfWgab](images/KXmAbBvXTophYGxhUzulqOfWgab.png)![Image Token: S1KRbfaOzoyqNux7uh4laVqVgZc](images/S1KRbfaOzoyqNux7uh4laVqVgZc.png)![Image Token: YMKAbeeLpowghBxfQxmlzfPngAf](images/YMKAbeeLpowghBxfQxmlzfPngAf.png) |

## 2.1 方舟控制台

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

![Image Token: ZD36bcZEgo9FXnxm6lvlEX00gqY](images/ZD36bcZEgo9FXnxm6lvlEX00gqY.png)

![体验中心【我的资产】首次进入时，调起协议弹窗 (Token: EHCSbgUCyocNvdxn4Qql6nHfgab)](images/EHCSbgUCyocNvdxn4Qql6nHfgab.png)

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

![【我的素材资产】面板，右上角点击【添加素材资产组】 (Token: HfQvbsOknoJ2MfxVTuVlpKqjg0c)](images/HfQvbsOknoJ2MfxVTuVlpKqjg0c.png)

![Image Token: H7fabAsJSon7mqx0yzklmB20gXb](images/H7fabAsJSon7mqx0yzklmB20gXb.png)

![点击上传/拖拽上传文件 (Token: XNrTbx6f9onxK6xzEHmlpPApgNb)](images/XNrTbx6f9onxK6xzEHmlpPApgNb.png)

* 单次创建上限为**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有差异）  |

  ![Image Token: OLX5bqDmuoFvScxMSjoldvMngcg](images/OLX5bqDmuoFvScxMSjoldvMngcg.png)

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

  > 命名规范：`{AssetName1}&&{GroupName1}&&{GroupDescription1(选填)}.jpg`
  >
  > 若无`&&`连接符，则文件名=`GroupName`=`AssetName`

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

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

![资产组合标题、描述修改 (Token: CpDGb1DkHoT0H7xymYXl0fl5gci)](images/CpDGb1DkHoT0H7xymYXl0fl5gci.png)

![资产名称修改 (Token: FGx3bIe8toKJVixJekllAYmXgsc)](images/FGx3bIe8toKJVixJekllAYmXgsc.png)



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

![点击某一Group进入详情 (Token: J2bibWD6SoH170xehXWler3ugrg)](images/J2bibWD6SoH170xehXWler3ugrg.png)

![Image Token: NfxBbdQa9oXQpWxT1GoljirmgXe](images/NfxBbdQa9oXQpWxT1GoljirmgXe.png)

![点击右上角【添加素材资产】上传Asset (Token: CsgQbFnXOoTJACx2TeZlrQlHgrd)](images/CsgQbFnXOoTJACx2TeZlrQlHgrd.png)

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

* 单个素材上传要求：

> - **图片格式**：控制台本期仅支持文件后缀为`.jpg`、`.jpeg`、`.png`（与API有差异）
>
> - **文件大小**：单张图片小于30M
>
> - **宽高比（宽/高）**：(0.4, 2.5)
>
> - **宽高长度（px）**：(300, 6000)

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

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

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

![报错示意 (Token: Bt9Vbf3ajohV07xVrK1lYKe2gOc)](images/Bt9Vbf3ajohV07xVrK1lYKe2gOc.png)



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

![Image Token: Cv3AbbvFHoQuTcxacZclfNfggRc](images/Cv3AbbvFHoQuTcxacZclfNfggRc.png)

![Image Token: DuDib9l3Ao8NsTx8E0Fl9eQEglb](images/DuDib9l3Ao8NsTx8E0Fl9eQEglb.png)

![体验中心使用流程示意 (Token: YdKqbTI8fojMc5xAqAElrdOggff)](images/YdKqbTI8fojMc5xAqAElrdOggff.png)



## 2.2 API入库 

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

![Image Token: Vvu2bZwhGoTs8MxPc9jlB1rigjh](images/Vvu2bZwhGoTs8MxPc9jlB1rigjh.png)



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

  > **【对客材料】**
  >
  > * **素材资产库实践手册：**[ 【申请权限填客户名称】私域虚拟人像素材资产库（邀测用户版）](https://bytedance.larkoffice.com/wiki/RtHgwpJgviwFXLkQ9hLcRooEnVe)
  >
  > * **Asset API文档：**[ 【申请权限填客户名称】Asset API 参考文档（邀测用户版）](https://bytedance.larkoffice.com/wiki/FtqVwjinYisraGkT5uncWyd0nEb)