video-shuoshan/docs/API文档/「保密信息」【申请权限填客户名称】控制台上传自有虚拟人像至素材资产库(邀测用户版).md
seaislee1209 ee7cdec9e3
All checks were successful
Build and Deploy / build-and-deploy (push) Successful in 5s
add docs
2026-04-04 13:27:13 +08:00

129 lines
7.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 「⚠️保密信息」【申请权限填客户名称】控制台上传自有虚拟人像至素材资产库(邀测用户版)
> 请注意,仅开白用户在控制台可见**《上传虚拟人像素材合规承诺函》**的签署入口,若仅可见**《素材资产功能使用规则》**,则需申请开白
# 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)