A2E
  1. Generate Avatar Videos
A2E
  • AI Avatar API
  • Get Tokens
    • 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. Generate Avatar Videos

Obtain the Status of One Avatar Video Task

Global Server
https://video.a2e.ai
Global Server
https://video.a2e.ai
POST
/api/v1/video/awsResult
Get the status of a specific video task.
Candidate status:
- init: initialization
- start: sent to algorithm
- pending: in algorithm queue
- process: being processing
- copy: uploading to cloud storage
- success: success
- fail: algorithm error

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
_id
string 
required
id obtained by video/create
Example
{
  "_id": "652630d6bae4de626f8b49ec"
}

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 POST 'https://video.a2e.ai/api/v1/video/awsResult' \
--header 'Content-Type: application/json' \
--data-raw '{"_id":"652630d6bae4de626f8b49ec"}'

Responses

🟢200awsResult
application/json
Body
code
integer 
required
data
array [object {17}] 
required
_id
string 
required
ID of the data entry
msg
string 
optional
result
string 
required
result (the url) of the video generation
process
integer 
optional
status
string 
required
status of the video generation.
Status values:
- `init`: initialization
- `start`: sent to algorithm
- `pending`: algorithm queue
- `process`: algorithm processing
- `copy`: saved to cloud storage
- `success`: success
- `fail`: algorithm error
anchor_type
string 
optional
web_bg_width
integer 
optional
web_bg_height
integer 
optional
color
string 
optional
result_people_url
string 
optional
result_bg_url
string 
optional
anchor_id
string 
optional
replace_bg_id
string 
optional
custom_backs_id
null 
optional
createdAt
string 
optional
diff_s
integer 
optional
current_date
string 
optional
Example
{
  "code": 0,
  "data": [
    {
      "_id": "652630d6bae4de626f8b49ec",
      "msg": "",
      "result": "https://d1tzkvq5ukphug.cloudfront.net/adam2eve/beta/result_video/0bf86e8c598894900777afdcc983fd49_fe32c2279a497b095626cb7db5aeaf2a_58ac500147c6ed67090a9e13f7af94dd_matting.mp4",
      "process": 100,
      "status": "success",
      "anchor_type": "0",
      "web_bg_width": 1919,
      "web_bg_height": 1080,
      "color": "",
      "anchor_id": "63de16f26c6193fa4ca7a486",
      "replace_bg_id": "629067e435e495933464f034",
      "custom_backs_id": null,
      "createdAt": "2023-10-11T05:21:26.855Z",
      "diff_s": 6644,
      "current_date": "2023-10-11 15:12:11"
    }
  ]
}
Previous
List One or All Avatars
Next
Obtain the List of Personalized Lip-Sync Models
Built with