Real-human asset verification

Create verified real-human assets for Seedance 2.0 video generation with BytePlus real-person verification.

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 type	Supported formats	Limits
Image	JPEG, JPG, PNG, WebP, GIF, HEIC	Less than 30 MB, 300-6000 px, aspect ratio 0.4-2.5
Video	MP4, MOV	Up to 50 MB, 2-15 seconds, 24-60 FPS, aspect ratio 0.4-2.5
Audio	MP3, WAV	Up 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

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

Related APIs

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.