Skip to main content
POST
/
insightFace
/
v1
/
swap
cURL
curl --request POST \
  --url https://api.ttapi.io/insightFace/v1/swap \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "targetImage": "<string>",
  "swapImage": "<string>",
  "hookUrl": "<string>"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "job_id"
  }
}

​
Face Swap Feature Description

The face swap feature leverages Midjourney’s image editing capabilities, allowing you to upload a portrait image along with a reference style image to generate a face swap effect according to the specified proportions. Before using, please ensure:
  1. The reference image is clear, with recognizable facial features.
  2. Do not upload illegal or copyrighted content.
  3. Generated results are intended for legal and compliant use only.
Example of Face Swap Result

Authorizations

​
TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
​
targetImage
string
required

Template image: URL of the face swap template image

​
swapImage
string
required

Face image: URL of the image to be face swapped

​
hookUrl
string

Callback URL address. When the task completes or fails, notifications will be sent to this address. The notification data structure [blocked] is consistent with the fetch structure. If not set, you need to call the fetch [blocked] endpoint to query the result.

Response

Request successful

​
status
string
required
Example:

"SUCCESS"

​
message
string
required
Example:

"success"

​
data
object
required
Example:
{ "job_id": "job_id" }
Last modified on April 18, 2026