🟣SwapFace换脸

TTAPI SwapFace换脸服务

创建换脸 Create SwapFace

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

创建换脸服务，此接口交互与 TTAPI Midjourney API 交互模式相同（Async）

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
targetImage	string	是	模板图像：换脸的模板图片url地址
swapImage	string	是	人脸图像：要换脸的图片url地址，会将该地址的图片中的人脸，换到targetImage的人脸中
hookUrl	string	否	回调地址，任务完成或失败将通过请地址进行通知，通知数据结构与fetch结构一致。如果未设置，则需要请求fetch接口进行查询。

请求示例

Python

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())

Node

const axios = require('axios');

let config = {
  method: 'post',
  url: '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"
  }
};

axios(config).then(function (response) {
  console.log(JSON.stringify(response.status));
}).catch(function (error) {
  console.log(error);
});

响应示例

200

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

400

{
  "status": "FAILED",
  "message": "'action' parameter error!",
  "data": null
}

获取换脸结果 Fetch SwapFace

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

获取换脸任务结果查询，返回数据结构与hookUrl中返回一致

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Query / Body

参数	类型	是否必须	描述
jobId	string	是	创建换脸接口返回的jobId

请求示例

Python

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())

Node

const axios = require('axios');

let config = {
  method: 'post',
  url: 'https://api.ttapi.io/insightFace/v1/fetch',
  headers: { 
    'TT-API-KEY': 'your_key'
  },
  data : {
     "jobId": "SWAP-FACE-171349414479347616"
  }
};

axios(config).then(function (response) {
  console.log(JSON.stringify(response.status));
}).catch(function (error) {
  console.log(error);
});

换脸结果数据结构 HookUrl JSON

SUCCESS

{
  "status": "SUCCESS",
  "message": null,
  "jobId": "SWAP-FACE-171349414479347616",
  "data": {
    "jobId": "SWAP-FACE-171349414479347616",
    "targetImage": "https://pics1.baidu.com/feed/a5c27d1ed21b0ef42316cbd385d68fd780cb3e64.jpeg@f_auto?token=0d9295cb14265da251460e7e8918db0a",
    "swapImage": "https://img2.baidu.com/it/u=2626318104,3413060045&fm=253&fmt=auto&app=138&f=JPEG?w=500&h=625",
    "discordImage": "https://cdn.discordapp.com/attachments/1225427359679909939/1230708397020811325/2aa3ab1495b844d084aa6eaaa4fb9bcf_ins.jpg?ex=66344d83&is=6621d883&hm=a0ac9fbb17cf52302662e2f50b40a9894977624d55bcc4f32d6ed09e7c56a415&",
    "cdnImage": "https://mjcdn.ttapi.io/attachments/1225427359679909939/1230708397020811325/2aa3ab1495b844d084aa6eaaa4fb9bcf_ins.jpg?ex=66344d83&is=6621d883&hm=a0ac9fbb17cf52302662e2f50b40a9894977624d55bcc4f32d6ed09e7c56a415&",
    "hookUrl": null,
    "quota": 3
  }
}

ON_QUEUE

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

FAILED

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

换脸返回参数详解

参数	详解
status	换脸结果状态， ON_QUEUE：队列中 SUCCESS：成功 FAILED：失败
targetImage	用户上传的模板图像地址
swapImage	用户上传的人脸图像地址
discordImage	任务成功返回结果的discord地址，国内不可直接访问
cdnImage	任务成功返回结果的ttapi代理地址，国内可直接访问
quota	实际消耗额度