A2E
  1. Create Avatars and Train Lip-sync Models
A2E
  • AI Avatar API
  • Get Tokens
    • Getting API Tokens (2025 version)
    • Obtain Login Token
      POST
    • Get API token
      POST
    • Delete API token
      POST
    • List api tokens
      GET
    • Getting API Tokens (2025 version)
      GET
  • TTS and Voice Clone
    • List Public TTS Options
      POST
    • List Voice Clone Options
      GET
    • Train TTS Model of The User's Voice (Voice Clone)
      POST
    • List Ongoing Voice Clone Tasks
      GET
    • Generate TTS Audio (Text-to-Speech)
      POST
    • Get Details of a Voice
      GET
    • Delete a User Voice
      DELETE
  • Generate Avatar Videos
    • Generate AI Avatar Videos
      POST
    • List of Result Videos
      POST
    • List One or All Avatars
      POST
    • Obtain the Status of One Avatar Video Task
      POST
    • Obtain the List of Personalized Lip-Sync Models
      GET
    • Delete or Cancel a Video
      DELETE
    • Auto Language Detect
      POST
    • Auto Swith to Public Computing Pool
      POST
  • Create Avatars and Train Lip-sync Models
    • Create A Custom Avatar by a Video or an Image
      POST
    • Train a Personalized Lip-sync Model (Optional) a.k.a. Continue Training 💠
      POST
    • Remove A Customized Avatar
      POST
    • Get Status of All Tasks
      GET
    • Get All Ongoing "Training" Tasks
      GET
    • Status of One Task
      GET
    • Clone Voice from a Video
      POST
  • Background Matting and Replacement
    • Obtain the List of Background Images
    • Add Custom Background Image
    • Delete Custom Image
  • Face Swap
    • Manage Face Swap Resource
      • Add Face Swap Image
      • Get Records of Face Swap Images
      • Delete User Face Swap Image
    • Quickly Preview Face Swap
      • Add User Face Swap Preview
      • Get Status of Face Swap Preview Process
    • Face Swap Tasks
      • Add User Face Swap Task
      • Get Status of Face Swap Task
      • Get Face Swap Task Records
      • Get Details of Face Swap
      • Delete Record
  • AI Dubbing
    • Start dubbing
    • List Dubbing Tasks
    • List All Processing Dubbing Tasks
    • Get Details
    • Delete Record
  • Image to Video
    • Start Image-to-Video
    • Check Status of One Task
    • List Status of All Tasks
    • Delete Record
  • Caption Removal
    • Start Caption Removal
    • Get Records of All Tasks
    • Get Status of All Tasks in Processing
    • Get Details of One Task
    • Delete a Task
  • Streaming Avatar
    • Get All avatars
    • Get a Streaming Avatar Token
    • Set QA Context
    • Get QA Context
    • Ask a Question to the Avatar
    • Let the Avatar Speak Directly
    • Leave the Room
  • Miscellaneous
    • Add a User
    • Get User Remaining Credits
    • Exchange Diamonds
    • List Available Languages
    • Save URL to A2E's storage
  1. Create Avatars and Train Lip-sync Models

Status of One Task

Global Server
https://video.a2e.ai
Global Server
https://video.a2e.ai
GET
/api/v1/userVideoTwin/{_id}
This endpoint retrieves the details of a specific user video twin by its ID.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
_id
string 
required
The id is obtained by api/v1/userVideoTwin/startTraining
Example:
66ebecb24cff1fd59cac23bd

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://video.a2e.ai/api/v1/userVideoTwin/66ebecb24cff1fd59cac23bd'

Responses

🟢200detail
application/json
Body
code
integer 
required
data
object 
required
name
string 
required
gender
string 
required
image_url
string 
required
video_url
string 
required
current_status
string 
required
close_mouth_path
string 
required
task_status
string 
required
video_backgroud_image
string 
required
video_backgroud_color
string 
required
image_result_url
string 
required
sent_time
null 
required
preview_result_url
string 
required
version
integer 
required
isSilent
boolean 
required
hasVideoClone
boolean 
required
_id
string 
required
a.k.a. user_video_twin_id. The ID of the video twin record to query /api/v1/anchor/character_list
createdAt
string 
required
updatedAt
string 
required
Example
{
    "code": 0,
    "data": {
        "_id": "67bd583f7b4ae10c76393899",
        "name": "test",
        "gender": "female",
        "image_url": "",
        "video_url": "https://d1tzkvq5ukphug.cloudfront.net/adam2eve/beta/users/665da3d7bcf6ab778bad0f6a/1e5fa88b-806c-4777-b2c0-0595be2a0e1e.mp4",
        "current_status": "completed",
        "failed_code": null,
        "failed_message": null,
        "wl_model": "live_protrait",
        "close_mouth_path": "",
        "task_id": "",
        "task_status": "",
        "task_result": {},
        "video_backgroud_image": "",
        "video_backgroud_color": "rgb(61,165,82)",
        "image_result_url": "",
        "image_error_code": "",
        "sent_time": "2025-02-25T05:42:23.023Z",
        "preview_result_url": "https://d1tzkvq5ukphug.cloudfront.net/adam2eve/beta/user/665da3d7bcf6ab778bad0f6a/userVideoTwin/67bd583f7b4ae10c76393899/preview_1740462245262.mp4",
        "version": 1,
        "isSilent": false,
        "hasVoiceClone": false,
        "hasVideoClone": false,
        "skipPreview": false,
        "isToPublicPool": false,
        "image_version": 2,
        "hasEyecontact": false,
        "eyecontact_result_url": ""
    }
}
Previous
Get All Ongoing "Training" Tasks
Next
Clone Voice from a Video
Built with