A2E
  1. Manage Face Swap Resource
A2E
  • AI Avatar API
  • Get Tokens
    • Getting API Tokens (2025 version)
  • TTS and Voice Clone
    • List Public TTS Options
      GET
    • 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
      GET
    • List One or All Avatars
      GET
    • Obtain the Status of One Avatar Video Task
      POST
    • 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
        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
    • Start and Manage Face Swap Tasks
      • Start a 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
    • List Available Languages
    • Save URL to A2E's storage
    • Add Watermark to Video or Image
    • Get R2 Upload Presigned URL
  • Text to Image
    • Start Text-to-Image
    • List Tasks of Text-to-Image Tasks
    • Get Details of One Task
    • Delete Record
    • Quick Add Avarar
  • Nano Banana(Gemini-2.5-Flash-Image-Preview
    • Start a text-to-image or image-editing task
    • Query the detail of one task
    • List all records
    • Delete a record
  • Talking Photo
    • Start a Task
    • List Tasks
    • Get Task Detail
    • Delete Task
  • Talking Video
    • Start a Task
    • Get Task Detail
    • Delete Task
    • List Tasks
  • Virtual Try-On
    • Start Virtual Try-On
    • List Tasks of Virtual Try-On
    • Get Details of One Task
    • Delete Record
  • Video to Video
    • Start Video to Video
    • List Tasks of Video to Video
    • Get Details of One Task
    • Delete Record
  • Product Avatar
    • Start Product Avatar
  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

Example
{
    "face_url":"https://d1tzkvq5ukphug.cloudfront.net/adam2eve/beta/face_swap/ab2fca41-90e5-41a6-aa66-08a960b035e4.jpg"
}

Request Code 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 'Authorization: Bearer <token>' \
--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

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