Seedance 2 Real Avatar Assets

• Follows an APIMart-style task flow
• verify-tasks.completed means the verification session was created, not that the user has passed verification
• The returned H5 link expires after 120 seconds

​

Authorizations

​

Workflow

​

1. Create Verification Task

• POST /v1/videos/doubao-seedance-2-0/real-avatar/verify-tasks

• Creates a new real-person verification task
• Returns a task_id
• You will use that task_id to fetch verification details

curl --request POST \
  --url https://toapis.com/v1/videos/doubao-seedance-2-0/real-avatar/verify-tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "callback_url": "https://your-app.example.com/doubao/callback",
    "locale": "zh",
    "biz_id": "user-123"
  }'

​

2. Get Verification Task Details

• GET /v1/videos/doubao-seedance-2-0/real-avatar/verify-tasks/{task_id}

• Returns the verification task details
• Gives you the h5_link for the end user
• Gives you the byted_token used in the next step

​

3. Get Verification Result

• GET /v1/videos/doubao-seedance-2-0/real-avatar/verify-results

• task_id
• byted_token
• result_code is recommended

• Confirms whether verification has passed
• Returns the group_id required for asset upload

curl --request GET \
  --url 'https://toapis.com/v1/videos/doubao-seedance-2-0/real-avatar/verify-results?task_id=tsk_dav_01K...&result_code=10000' \
  --header 'Authorization: Bearer <token>'

• verify_status=verified
• group_id is present

​

4. Upload Real Avatar Asset

• POST /v1/videos/doubao-seedance-2-0/real-avatar/assets

• Uploads one real-avatar asset into the verified group
• Returns an asset_id
• Starts asynchronous processing

​

5. Get Asset ステータス

• GET /v1/videos/doubao-seedance-2-0/real-avatar/assets/{asset_id}

• Returns the current asset status
• Tells you whether the asset is ready for video generation

​

Use In 動画生成

• POST /v1/videos/generations

{
  "image_with_roles": [
    {
      "url": "asset://asset-20260318071009-*****",
      "role": "reference_image"
    }
  ]
}