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}。下面使用通用视频生成接口:
使用限制
- 素材组、素材和视频生成请求使用同一个 API Key。
- 素材源 URL 在创建和处理期间必须可以从公网访问。
asset://后只能填写素材 ID,不能追加路径、查询参数或锚点。- 引用类型必须匹配:图片素材放入
images,视频素材放入videos,音频素材放入audios。 - 只有
Active状态的素材可以用于生成。
创建虚拟人像组
只传
name 和可选的 description。素材管理
创建素材并检查处理状态。

