Face Swap

POST

/v1/aiart/faceswap

Enhance your photos with our Face Swap API, seamlessly swapping faces between images for entertaining and realistic transformations. Whether you’re looking to swap faces with friends, family, or even celebrities, the possibilities are limitless. Our advanced AI ensures natural blending for high-quality results. Plus, explore a variety of templates to create fun and unique edits effortlessly.

Request

Header Params

Authorization

string

required

Example:

Bearer <your api key>

Body Params application/json

userImageUrl

string

required

The URL or BASE64 encoded image of the face image provided by the user.

templateImageUrl

string

required

The URL or BASE64 encoded image of the target to Swap Face in This Image.

Example

{
  "userImageUrl": "https://pub-static.fotor.com/assets/goart-effects/examples/mini-figure-after.jpg",
  "templateImageUrl": "https://pub-static.fotor.com/assets/goart-effects/examples/mini-figure-after.jpg"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-b.fotor.com/v1/aiart/faceswap' \
--header 'Authorization: Bearer <your api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userImageUrl": "https://pub-static.fotor.com/assets/goart-effects/examples/mini-figure-after.jpg",
    "templateImageUrl": "https://pub-static.fotor.com/assets/goart-effects/examples/mini-figure-after.jpg"
}'

Responses

🟢200success

application/json

Body

code

string

required

000: Success，999: Unknown error

Example:

000

msg

string

required

Example:

success

data

object

required

taskId

string

required

Task ID, used to query task information.

Example:

e0dc194703174b6eafeacb4ee8e02850

Example

{
  "code": "000",
  "msg": "success",
  "data": {
    "taskId": "e0dc194703174b6eafeacb4ee8e02850"
  }
}

Modified at 2025-03-14 02:45:11

Photo Restoration

Query Task Details