Real-person verification

Real-person assets let Seedance use authorized media of a real person. Your integration only needs an AiToEarn X-Api-Key; no Volcengine access key or secret key is required.

Use this feature only with the person’s explicit authorization. Keep the API key on your backend.

Separate from virtual portrait assets

Virtual portraits are documented in Virtual portrait assets. This page covers real-person verification only.

If generating a video with a real-person asset fails, use Create virtual portrait group.

Integration flow

Create a verification session and store bytedToken.
Send shortLink or h5Link to the person being verified.
Complete the session from your backend with the same API key.
Store the returned RealPerson group ID.
Create an asset and wait until its status is Active.
Pass asset://{assetId} to Seedance.

Create and complete verification

This request has one field. Do not send the virtual portrait fields name or description:

Parameter	Required	Meaning
`callbackUrl`	Yes	HTTP(S) URL to open after verification

Call Create verification session:

curl --request POST 'https://aitoearn.ai/api/ai/volcengine/assets/visual-validation-sessions' \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <API_KEY>' \
  --data '{"callbackUrl":"https://example.com/real-person/callback"}'

Store data.bytedToken. AiToEarn retains the session for 30 minutes. After verification, the browser redirects to your callbackUrl with bytedToken, resultCode, and other query parameters. Your backend must still call Complete verification with the same API key:

curl --request POST \
  'https://aitoearn.ai/api/ai/volcengine/assets/visual-validation-sessions/<BYTED_TOKEN>/complete' \
  --header 'X-Api-Key: <API_KEY>'

Completion has no request body. Store data.groupId. Business code 12329 means the result is not ready; retry the same bytedToken. If generating a video with a real-person asset fails, use Create virtual portrait group.

Create an asset

If the file is local or private, use Asset upload first. Then call Create asset:

curl --request POST 'https://aitoearn.ai/api/ai/volcengine/assets/items' \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <API_KEY>' \
  --data '{
    "groupId": "group_xxx",
    "url": "https://assets.example.com/person-reference.jpg",
    "assetType": "Image"
  }'

Store data.assetId. Query Asset details until the status becomes Active:

curl 'https://aitoearn.ai/api/ai/volcengine/assets/items/<ASSET_ID>' \
  --header 'X-Api-Key: <API_KEY>'

Processing means the asset is still being processed. Failed means you should check the source file and create a new asset.

Use the asset in Seedance

Send the following body to POST /api/ai/video/generations with the same X-Api-Key:

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "Preserve the person identity and facial features",
  "mode": "multi-ref",
  "images": ["asset://<ASSET_ID>"],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5
}

Keep one verified person per real-person group.
Use clear face media and avoid multiple faces.
Keep the source URL publicly accessible while processing.
Match the asset type to images, videos, or audios.
Append only the asset ID after asset://.
Use only Active assets.

If generating a video with a real-person asset fails, use Create virtual portrait group.

Getting Started

Publishing

Assets

AI Generation

AI Tool Integration

Deployment

Separate from virtual portrait assets

Integration flow

Create and complete verification

Create an asset

Use the asset in Seedance

​Separate from virtual portrait assets

​Integration flow

​Create and complete verification

​Create an asset

​Use the asset in Seedance

Separate from virtual portrait assets

Integration flow

Create and complete verification

Create an asset

Use the asset in Seedance