SwapFace API

TTAPI SwapFace face-changing service

demo

Create SwapFace

POST https://api.ttapi.io/insightFace/v1/swap


Create a face swap request. Task results is async

Headers

NameTypeDescription
TT-API-KEY*StringYour API Key in TT API used for request authorization

Request Body

NameTypeRequiredDescription
targetImageStringtrueURL(jpg,jpeg,png,webp) string for the image whose face will be swapped with the swap_image face
swapImageStringtrueURL(jpg,jpeg,png,webp) string for the image whose face will be swapped with
hookUrlStringfalseSend a request to the address for task completion or failed notification. If not set you need to request fetch endpoint to get response

Example Request

import requests
endpoint = "https://api.ttapi.io/insightFace/v1/swap"
headers = {
    "TT-API-KEY": your_key
}
data = {
    "targetImage": "https://cdnb.ttapi.io/2024-04-23/tar_image.jpg",
    "swapImage": "https://cdnb.ttapi.io/2024-04-23/face_image.jpg",
    "hookUrl": "https://webhook-test.com/10ffa7e6d1e6886e746d19a5458d167d"
}
response = requests.post(endpoint, headers=headers, json=data)
print(response.status_code)
print(response.json())

Example Response

{
    "status": "SUCCESS",
    "message": "",
    "data": {
        "jobId": "SWAP-FACE-171349414479347616"
    }
}

Fetch SwapFace

POST/GET https://api.ttapi.io/insightFace/v1/fetch


Get the face-changing task result query, the returned json data is same with the return in hookUrl

Headers

NameTypeDescription
TT-API-KEY*StringYour API Key in TT API used for request authorization

Request Body / Query param

NameTypeRequiredDescription
jobIdStringtrueSWAP-FACE-171349414479347616

Example Request

import requests
endpoint = "https://api.ttapi.io/insightFace/v1/fetch"
headers = {
    "TT-API-KEY": your_key
}
data = {
    "jobId": "SWAP-FACE-171349414479347616",
}
response = requests.post(endpoint, headers=headers, json=data)
print(response.status_code)
print(response.json())

Async callback & fetch json

{
    "status": "SUCCESS",
    "jobId": "SWAP-FACE-171383611748093575",
    "data": {
        "jobId": "SWAP-FACE-171383611748093575",
        "targetImage": "https://cdnb.ttapi.io/2024-04-23/tar_image.jpg",
        "swapImage": "https://cdnb.ttapi.io/2024-04-23/face_image.jpg",
        "discordImage": "https://cdn.discordapp.com/attachments/1225427359679909939/1232142735067054162/fef8556fdd514b29b42f7c464cb4efb9_ins.jpg?ex=662861d8&is=66271058&hm=91e513ad6a48350f1c97a3bb367e1f1902bf26265bc1de5ac0968afcaa94e93f&",
        "cdnImage": "https://mjcdn.ttapi.io/attachments/1225427359679909939/1232142735067054162/fef8556fdd514b29b42f7c464cb4efb9_ins.jpg?ex=662861d8&is=66271058&hm=91e513ad6a48350f1c97a3bb367e1f1902bf26265bc1de5ac0968afcaa94e93f&",
        "hookUrl": "https://webhook-test.com/10ffa7e6d1e6886e746d19a5458d167d",
        "quota": 2
    }
}