跳转到主要内容
虚拟人像素材不需要活体认证。创建素材组时 name 必填,description 选填。接入方只需要 AiToEarn 的 X-Api-Key,不需要配置或传递火山引擎 AK/SK。
如果你还没有 API Key,请先阅读 获取 API KEY 教程。创建素材组、创建素材和生成视频应使用同一个 API Key。
真人认证见 真人认证。 使用真人素材生成视频失败时,请改用本页的「创建虚拟人像组」。

接入流程

1

创建虚拟人像组

只传 name 和可选的 description,保存返回的 groupId。返回的 avatarType 为 Virtual。
2

准备公网素材地址

素材源文件必须能从公网访问。本地或私有文件先按 资源上传 取得确认后的 data.url。
3

创建素材

把图片、视频或音频登记到该素材组,保存 assetId。
4

等待素材可用

查询素材详情,等待 status 变为 Active。
5

生成视频

将 asset://{assetId} 放入 Seedance 视频生成请求的参考素材字段。

创建虚拟人像组

调用 创建虚拟人像组。请求参数只有下面两个,不要附加真人认证字段: 火山方舟 CreateAssetGroup 没有 avatarType。Name 必填,Description 选填,GroupType 选填且默认 AIGC(虚拟人像素材),当前也只支持 AIGC。本接口不接收 GroupType 和 avatarType,只接收上面两个字段,并固定按虚拟人像创建。响应里的 avatarType 固定为 Virtual。查询素材组时,avatarType 才是可选筛选参数。
name 必填,description 可选。成功后保存 data.groupId:
avatarType 固定为 Virtual。后续创建素材、查询和删除都使用这里返回的 groupId。

上传并创建素材

创建素材时需要公网可访问的 URL。如果文件还在本地或私有存储中,先按 资源上传 获取确认后的 data.url。不要把对象存储的 uploadUrl 当作素材 URL。 然后调用 创建素材:
assetType 可使用 Image、Video 或 Audio。name 可选。创建成功后保存 data.assetId,初始状态通常是 Processing。

等待素材变为 Active

调用 素材详情 会刷新上游处理状态:
素材列表保存的是本地登记记录。等待处理结果时查询单个素材详情,以取得最新状态。

在 Seedance 中使用

素材状态变为 Active 后,把素材 ID 写成 asset://{assetId}。下面使用通用视频生成接口:
先调用 视频生成模型,选择当前站点可用且支持所需输入模式的 Seedance 模型。

使用限制

  • 素材组、素材和视频生成请求使用同一个 API Key。
  • 素材源 URL 在创建和处理期间必须可以从公网访问。
  • asset:// 后只能填写素材 ID,不能追加路径、查询参数或锚点。
  • 引用类型必须匹配:图片素材放入 images,视频素材放入 videos,音频素材放入 audios。
  • 只有 Active 状态的素材可以用于生成。
相关 API:

创建虚拟人像组

只传 name 和可选的 description。

素材管理

创建素材并检查处理状态。
最后修改于 2026年10月30日