Video Twin API Documentation

Overview

Build a personalised video twin - a digital double trained on your own footage - that can speak and present content on your behalf with natural motion.

Primary Endpoint

POST/api/v1/userVideoTwin/startTraining

Start video twin training

Request Parameters

Name	Type	Required	Description
name	string	No	Name for the video twin
image_url	string	No	URL of the source image
video_url	string	No	URL of the source video
video_background_image	string	No	URL of background image
video_background_color	string	No	Background color in RGBA format

Request Example

curl -X POST "https://www.a2e.com.cn/api/v1/userVideoTwin/startTraining" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My Video Twin",
  "image_url": "https://example.com/face.jpg",
  "video_url": "https://example.com/video.mp4",
  "video_background_image": "https://example.com/bg.jpg",
  "video_background_color": "rgba(255,255,255,1)"
}'

Related Endpoints

POST/api/v1/userVideoTwin/upload

Upload file

POST/api/v1/userVideoTwin/training

Start training

GET/api/v1/userVideoTwin/uploadStatus

Get video twin upload status

GET/api/v1/userVideoTwin/userRecords

Get user video twin records

POST/api/v1/userVideoTwin/remove

Remove video twin

GET/api/v1/userVideoTwin/records

Get video twin records

POST/api/v1/userVideoTwin/startTraining

Start video twin training

POST/api/v1/userVideoTwin/continueTraining

Continue video twin training

GET/api/v1/userVideoTwin/trainingRecords

Get training records

POST/api/v1/userVideoTwin/batchDetail

Batch query task details

GET/api/v1/userVideoTwin/{_id}

Get record details

POST/api/v1/userVideoTwin/retry

Retry a failed task

POST/api/v1/userVideoTwin/eyeContact

Start eye contact enhancement

Responses

200

Video twin training started successfully

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid or missing bearer token