私域虚拟人像素材资产库使用指南

概述

Seedance 2.0 系列模型具有完备的防范 Deepfake 和侵犯版权风险能力。为确保创作者能充分利用 Seedance 2.0 强大的视频生成能力高效生成视频内容，同时规避 AI 生成内容的潜在风险，方舟推出了私域可信素材库。完成入库的可信素材将进入您的私域素材库，在视频生成中使用。

使用流程

创建素材资产组

上传素材资产

查询素材状态，等待状态变为 Active

使用素材 Asset ID 进行视频生成

素材资产库结构说明

Asset Group（素材资产组合）：单个素材文件为一个 Asset，每个 Asset 属于一个 Asset Group。可以使用素材组自由管理素材，例如可将同一虚拟人物素材放入同一素材组合进行管理。

Asset（素材资产）：一个素材文件（当前支持上传图像、视频、音频），是方舟 Seedance 2.0 系列模型可直接用于推理的可信资产。

注意
仅需入库推理需使用的素材资产，不需使用的素材资产请勿入库。
仅可使用已入库素材资产的 Id (Asset ID) 进行视频生成，同一形象未入库素材无法使用。
每个上传的素材资产需经过预处理，可轮询调用 GetAsset 接口查询素材状态（对应参数为 Status），仅当状态变为 Active 后，该素材资产方可用于后续推理使用；若状态为 Failed 则表示处理失败。

图像资产上传要求

格式：jpeg、png、webp、bmp、tiff、gif、heic/heif

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

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

大小：单张图片小于 30 MB

鉴权说明

调用素材资产（Assets）API 接口需使用 Access Key（AK/SK）鉴权。

接口列表

Asset (Group) 创建接口

接口	说明
创建资产组	创建素材资产组合
上传素材资产	创建素材资产（上传素材）

Asset (Group) 管理接口

接口	说明
查询素材组	查询素材资产组信息
查询资产组素材列表	查询资产组内素材列表
查询单个素材	查询单个素材具体信息
删除素材	删除单个素材资产
删除资产组	删除指定素材组
查询素材状态	素材上传成功后需要查询是否审核通过

提示词中引用素材的方式

在提示词（content.text）中使用 "素材类型+序号" 格式引用素材：

图片 1、图片 2... — 引用 image_url 类型素材（按请求体中同类素材的顺序编号）

视频 1、视频 2... — 引用 video_url 类型素材

音频 1、音频 2... — 引用 audio_url 类型素材

⚠️ 请勿在提示词中使用 Asset ID 指代素材，应使用"图片1"、"视频1"等格式。

项目隔离说明

素材库按项目（Project）隔离：

向指定的 Asset Group 内创建或查询 Asset 时，需保证两者的 ProjectName 一致。

Asset 所属的 ProjectName 需与调用视频生成 API 接口时使用的 API Key 所属的 ProjectName 一致。

如果请求中不指定 ProjectName，默认将资源创建至 default 项目中。

常见问题

为什么素材上传成功后，无法使用素材生成视频或获取素材信息？

素材库按项目（Project）隔离：

在视频生成时，必须使用素材所在项目中的推理接入点进行推理。

如果素材上传成功，但使用获取素材接口获取素材失败，可能是因为调用上传素材（CreateAsset）和获取素材接口时传入了不同的 ProjectName。

ProjectName 默认值为 default，建议在同一个项目中管理素材。

提示词（content.text）中应该如何准确指代参考素材？

需在提示词输入中使用"素材类型+序号"格式引用素材，例如 图片 1、视频 1、音频 1。序号为请求体中该素材在同类素材中的排序。请勿在提示词中使用 Asset ID 指代素材。

seedance 2.0 人像授权说明

私域虚拟人像素材资产库使用指南#

概述#

使用流程#

素材资产库结构说明#

图像资产上传要求#

鉴权说明#

接口列表#

Asset (Group) 创建接口#

Asset (Group) 管理接口#

提示词中引用素材的方式#

项目隔离说明#

常见问题#

为什么素材上传成功后，无法使用素材生成视频或获取素材信息？#

提示词（content.text）中应该如何准确指代参考素材？#