跳转到主要内容
当你需要在 Seedance 2.0 视频生成中使用已授权真人肖像时，使用真人形象素材录入流程。火山方舟官方中文文档将该流程称为录入真人形象素材，用于将已授权真人肖像素材加入可信素材库。 在 Anyfast 中，该流程对应 LivenessFace 素材组。你先创建移动端认证会话，授权人用手机完成真人认证，然后上传与本人一致的图片、视频或音频素材，并在 Seedance 2.0 请求中通过 asset://<asset_id> 使用。
官方中文术语包含真人形象素材、真人认证、可信素材库和私域素材库。Anyfast API 中保留 LivenessFace 作为素材组类型，因为这是认证流程返回的上游素材组类型。
录入真人形象素材必须使用选择了 Byteplus-Direct 分组的 API 令牌。普通 AIGC 素材分组仅支持 GroupType: "AIGC"，无法创建真人认证会话或 LivenessFace 真人素材。

​
适用场景

  • 已获得真人肖像授权。
  • 需要为 Seedance 2.0 视频生成复用真人肖像素材。
  • 希望使用 asset://<asset_id> 引用已认证素材，而不是公开 URL。

​
工作流

1

创建认证会话

调用 CreateVisualValidateSession 获取 H5Link 和 BytedToken。
cURL
curl https://www.anyfast.ai/volc/asset/CreateVisualValidateSession \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "CallbackURL": "https://example.com/callback"
  }'
2

让授权人在手机上完成认证

将返回的 H5Link 发给授权人。授权人在手机上打开链接并完成真人认证。
3

查询认证结果

认证完成后，使用 BytedToken 查询结果。认证成功会返回 LivenessFace 素材组的 GroupId。
cURL
curl https://www.anyfast.ai/volc/asset/GetVisualValidateResult \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "BytedToken": "2026070222152680501D985EA34A3BE3D8"
  }'
4

上传本人一致的真人素材

将图片、视频或音频上传到返回的素材组。图片和视频会与认证本人做人脸一致性校验。
cURL
curl https://www.anyfast.ai/volc/asset/CreateAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volc-asset",
    "GroupId": "group-20260702221642-5czvq",
    "Name": "portrait-front",
    "AssetType": "Image",
    "URL": "https://example.com/portrait.jpg"
  }'
5

在 Seedance 2.0 中使用素材

素材状态变为 Active 后，在对应的内容 URL 字段中传入 asset://<asset_id>。
{
  "type": "image_url",
  "image_url": {
    "url": "asset://asset-20260702223855-bdv2r"
  },
  "role": "reference_image"
}

​
素材要求

请上传与认证本人一致、清晰可识别的素材。BytePlus 官方建议使用清晰的正面图片，以提高一致性校验通过率。
素材类型支持格式限制
图片JPEG, JPG, PNG, WebP, GIF, HEIC小于 30 MB，300-6000 px，宽高比 0.4-2.5
视频MP4, MOV不超过 50 MB，2-15 秒，24-60 FPS，宽高比 0.4-2.5
音频MP3, WAV不超过 15 MB，2-15 秒
不支持将不同人的素材上传到同一个真人素材组。每次上传都会根据该素材组的认证本人做一致性校验。

​
常见问题

现象含义处理方式
GroupType must be one of [AIGC]令牌路由到了普通 AIGC 素材分组。创建选择了 Byteplus-Direct 分组的令牌。
FaceMismatch上传素材的人脸与认证本人不一致。上传同一人的清晰正面素材。
GroupId 为空认证未完成，或未生成素材组。让授权人完成 H5 认证后再次查询。
asset group ... not found素材组属于其他令牌或账号。使用创建认证会话时的同一个令牌。

​
相关接口

创建真人认证会话

创建移动端真人认证会话。

查询真人认证结果

查询认证会话创建的 LivenessFace 素材组。

创建素材

向认证后的素材组上传本人一致的图片素材。

Seedance 2.0 素材管理

管理素材组和可复用的 asset:// 引用。

​
官方参考

参见火山方舟：录入真人形象素材。