🟣SwapFace换脸

TTAPI SwapFace换脸服务

创建换脸 Create SwapFace

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

创建换脸服务,此接口交互与 TTAPI Midjourney API 交互模式相同(Async)

Headers

NameValue

Content-Type

application/json

TT-API-KEY

用于请求授权 TT-API 的API密钥

Body

参数类型是否必须描述

targetImage

string

模板图像:换脸的模板图片url地址

swapImage

string

人脸图像:要换脸的图片url地址,会将该地址的图片中的人脸,换到targetImage的人脸中

hookUrl

string

回调地址,任务完成或失败将通过请地址进行通知,通知数据结构与fetch结构一致。如果未设置,则需要请求fetch接口进行查询。

请求示例

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

响应示例

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

获取换脸结果 Fetch SwapFace

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

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

Headers

NameValue

Content-Type

application/json

TT-API-KEY

用于请求授权 TT-API 的API密钥

Query / Body

参数类型是否必须描述

jobId

string

创建换脸接口返回的jobId

请求示例

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

换脸结果数据结构 HookUrl JSON

{
  "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
  }
}

换脸返回参数详解

参数详解

status

换脸结果状态, ON_QUEUE:队列中 SUCCESS:成功 FAILED:失败

targetImage

用户上传的模板图像地址

swapImage

用户上传的人脸图像地址

discordImage

任务成功返回结果的discord地址,国内不可直接访问

cdnImage

任务成功返回结果的ttapi代理地址,国内可直接访问

Last updated