Real-person assets - AiToEarn Open Platform

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.

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

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>'

Store data.groupId. Business code 12329 means the result is not ready; wait briefly and retry. The regular group creation endpoint returns avatarType: Virtual; a real-person group is created only by completing verification.

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.

​Integration flow

​Create and complete verification

​Create an asset

​Use the asset in Seedance

Integration flow

Create and complete verification

Create an asset

Use the asset in Seedance