Skip to main content
Use real-human asset verification when you need to generate Seedance 2.0 videos with an authorized real person’s portrait. BytePlus documents this flow as Add real-human assets to asset library and describes it as a private trusted asset library for authorized real-human portrait assets. In Anyfast, this flow maps to LivenessFace asset groups. You create a mobile verification session, the authorizing person completes real-person verification on a phone, then you upload face-matched assets and use them with asset://<asset_id> in Seedance 2.0 requests.
Official BytePlus terms include real-human assets, real-person verification, and private trusted asset library. Anyfast keeps LivenessFace as the API group type because it is the upstream asset group type returned by the verification flow.
Real-human asset verification requires an API token created with the Byteplus-Direct group. Tokens routed to regular AIGC assets only support GroupType: "AIGC" and cannot create verification sessions or LivenessFace assets.

​
When to use this flow

  • You have authorization from the real person whose portrait will be used.
  • You need reusable portrait assets for Seedance 2.0 video generation.
  • You want to pass verified images, videos, or audio as asset://<asset_id> instead of public URLs.

​
Workflow

1

Create a verification session

Call CreateVisualValidateSession to get an H5Link and 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

Ask the person to verify on mobile

Send the returned H5Link to the authorizing person. They open it on a phone and complete real-person verification.
3

Query the verification result

After verification is complete, query the result with BytedToken. A successful result returns a GroupId for the LivenessFace asset group.
cURL
curl https://www.anyfast.ai/volc/asset/GetVisualValidateResult \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "BytedToken": "2026070222152680501D985EA34A3BE3D8"
  }'
4

Upload matching real-human assets

Upload a portrait image, video, or audio file to the returned group. Images and videos are checked for consistency with the verified person.
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

Use the asset in Seedance 2.0

After the asset status becomes Active, pass it as asset://<asset_id> in the matching content URL field.
{
  "type": "image_url",
  "image_url": {
    "url": "asset://asset-20260702223855-bdv2r"
  },
  "role": "reference_image"
}

​
Asset requirements

Use clear assets that match the verified person. BytePlus recommends clear, front-facing images for consistency checks.
Asset typeSupported formatsLimits
ImageJPEG, JPG, PNG, WebP, GIF, HEICLess than 30 MB, 300-6000 px, aspect ratio 0.4-2.5
VideoMP4, MOVUp to 50 MB, 2-15 seconds, 24-60 FPS, aspect ratio 0.4-2.5
AudioMP3, WAVUp to 15 MB, 2-15 seconds
Uploading assets from different people into the same real-human asset group is not supported. Each upload is checked against the verified person for that group.

​
Troubleshooting

SymptomMeaningFix
GroupType must be one of [AIGC]The token is routed to the regular AIGC asset group.Create a token with the Byteplus-Direct group.
FaceMismatchThe uploaded face does not match the verified person.Upload a clearer front-facing asset of the same person.
GroupId is emptyVerification is not finished or did not create a group.Ask the person to finish the H5 verification, then query again.
asset group ... not foundThe group belongs to a different token/account.Use the same token that created the verification session.

Create Liveness Session

Create the mobile real-person verification session.

Get Liveness Result

Query the LivenessFace group created by a verification session.

Create Asset

Upload a matching image asset to the verified group.

Seedance 2.0 Asset Management

Manage asset groups and reusable asset:// references.

​
Official reference

See BytePlus ModelArk: Add real-human assets to asset library.