选择素材类型
素材组与素材
group_id 只用来整理素材，生成视频时要传素材本身的 id。如果返回 Seedance material asset not found or not accessible，请确认 ID 没有填错、素材仍然存在、属于当前账户，并且状态为 ACTIVE。
自动图片素材
所选 Seedance 模型支持素材库时，可以在image、image_url、image_urls、reference_images、start_image 或 end_image 中直接传入图片 URL 或支持的内联 data URL。TokenLab 会把图片保存到当前账户的默认素材组，并保留它是首帧、尾帧还是参考图。
素材在 60 秒内变为 ACTIVE 时，视频会继续生成。仍在准备时，API 返回 409 seedance_material_preparing 和 auto_material_asset_ids。等这些素材变为 ACTIVE 后，用 material_asset_id 或 material_asset_ids 重新提交。已经存在的素材 ID 不会重复导入。
真人验证
真人会被反复用于 Seedance 生成时，产品必须取得本人同意并完成人脸验证。- 调用 创建视觉验证会话，传入
CallbackURL，并保存返回的Result.BytedToken。 - 为待验证人员打开
Result.H5Link。如需指定语言，请在 H5 链接后追加lng。 - 验证完成后，浏览器会打开
Result.CallbackURL，并带上bytedToken、resultCode等查询参数。 - 使用
BytedToken查询视觉验证结果，直到返回Result.GroupId。 - 保存
GroupId；创建liveness_face素材时将其作为group_id。
BytedToken 的有效期为 30 分钟。两次 Action 请求必须使用相同的 ProjectName。认证使用 Authorization: Bearer <TOKENLAB_API_KEY>，不接受火山引擎 AK/SK 签名。
也可以在 Seedance 素材 页面检查请求、回调、素材组和验证记录。正式功能仍应直接调用 API。
创建素材组
使用创建素材组新建aigc_avatar 组。真人组会在验证成功后创建，不能手动伪造成已验证真人。
使用 列出素材组、获取素材组、更新素材组 和 删除素材组 管理已有素材组。
删除素材组也会删除其中所有素材，而且无法恢复。没有删除权限时，API 会返回权限错误。
上传素材
使用创建素材导入一个可从互联网访问的 URL。aigc_avatar 可以省略 group_id，TokenLab 会使用当前账户的默认组。liveness_face 必须传入 group_id，并且这个 ID 必须来自视觉验证结果。
TokenLab 会检查 URL、媒体格式和文件大小。宽高、比例、时长、分辨率、总像素和 FPS 是否合格，还取决于所选模型。
素材需要一些时间处理。请查询获取素材，直到
status 变为 ACTIVE。HTTP 请求成功只表示已经开始处理；状态变为 FAILED 时，请根据 error_message 修改源文件并重新创建。
asset_url 只是素材的导入地址。TokenLab 会返回素材 id，以后生成视频请使用这个 ID。
素材 ID 类似 asset-20260720123456-qn7wr，素材组 ID 类似 group-20260720123456-vrt01。素材会保留在当前账户中，直到你删除素材或整个素材组。
一个真人素材组只对应一个人。上传内容会与已经验证的人脸比对；出现多张脸或人物不一致时可能失败。建议准备一张正面全身照和一张清晰的正脸特写。
在视频生成中使用素材
素材变为ACTIVE 后，调用创建视频时，把它的 id 传给 material_asset_id，多份素材则放进 material_asset_ids。这些素材都会计入 Seedance 的参考数量上限。
REST 还是火山 Action
新接入使用 snake_case 的/v1/videos/assets* REST API。已有火山客户端可以保留 PascalCase 请求体，改用火山兼容素材 Action。两种 API 访问的是当前账户与 ProjectName 下的同一份素材。
API 示例
下面的示例创建虚拟人像素材组并上传一张图片。素材变为ACTIVE 后，就可以把返回的素材 ID 用于视频请求。
GroupId 后才能上传。
使用 Action 上传真人素材
取得验证结果返回的GroupId 后，将它传给 CreateAsset：
GetAsset 查询，状态变为 Active 后即可在视频生成中使用素材 ID。