SwapFace换脸 - TTAPI Docs

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

POST

insightFace

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

换脸功能说明

换脸功能基于 Midjourney 图片编辑能力实现，支持上传人像图片与参考风格图，生成符合指定比例的换脸效果。使用前请确保：

参考图片清晰，面部特征可识别；
避免上传违规、侵权的图片内容；
生成结果仅用于合法合规的场景。

授权

TT-API-KEY

string

header

必填

请前往 TTAPI 控制台获取 API 密钥。

请求体

application/json

targetImage

string

必填

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

swapImage

string

必填

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

hookUrl

string

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

响应

请求成功

status

string

必填

示例:

"SUCCESS"

message

string

必填

示例:

"success"

data

object

必填

示例:

{ "job_id": "job_id" }

Last modified on March 26, 2026

查询任务结果获取换脸结果 Fetch SwapFace

Documentation Index

​换脸功能说明

授权

请求体

响应

换脸功能说明