A2E
  1. Manage Face Swap Resource
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
    • Train a Personalized Lip-sync Model (Optional) a.k.a. Continue Training 💠
    • Remove A Customized Avatar
    • Get Status of All Tasks
    • Get All Ongoing "Training" Tasks
    • Status of One Task
    • Clone Voice from a Video
  • 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
        POST
      • Get Records of Face Swap Images
        GET
      • Delete User Face Swap Image
        DELETE
    • 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. Manage Face Swap Resource

Add Face Swap Image

Global Server
https://video.a2e.ai
Global Server
https://video.a2e.ai
POST
/api/v1/userFaceSwapImage/add
The POST request to /api/v1/userFaceSwapImage/add endpoint is used to add a user's face swap image.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
face_url
string 
required
The URL of the user's face image
Example
{
  "face_url": "https://d1tzkvq5ukphug.cloudfront.net/adam2eve/beta/face_swap/ab2fca41-90e5-41a6-aa66-08a960b035e4.jpg"
}

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/userFaceSwapImage/add' \
--header 'Content-Type: application/json' \
--data-raw '{
    "face_url":"https://d1tzkvq5ukphug.cloudfront.net/adam2eve/beta/face_swap/ab2fca41-90e5-41a6-aa66-08a960b035e4.jpg"
}'

Responses

🟢200add
application/json
Body
code
integer 
required
0 is OK
data
array [object {4}] 
required
face_url
string 
required
The URL of the user's face image
_id
string 
required
The unique identifier of the user's face swap image
user_id
string 
required
The user ID associated with the image
createdAt
string 
required
The timestamp of when the image was created
Example
{
  "code": 0,
  "data": [
    {
      "face_url": "https://dh24as48lv9ce.cloudfront.net/adam2eve/beta/face_swap/ab2fca41-90e5-41a6-aa66-08a960b035e4.jpg",
      "_id": "6673bee3e7aea87e7bcddd5d",
      "createdAt": "2024-06-20T05:32:19.714Z",
      "updatedAt": "2024-06-20T05:32:19.714Z"
    },
    {
      "face_url": "https://dh24as48lv9ce.cloudfront.net/adam2eve/stable/faceSwap/2024067/1717730089329.png",
      "_id": "66627b2a4a609ccee1ca24ff",
      "createdAt": "2024-06-07T03:14:50.580Z",
      "updatedAt": "2024-06-07T03:14:50.580Z"
    }
  ]
}
Modified at 2025-02-25 06:10:54
Previous
Delete Custom Image
Next
Get Records of Face Swap Images
Built with