跳转到主要内容
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"
  }
}

​
换脸功能说明

换脸功能基于 Midjourney 图片编辑能力实现，支持上传人像图片与参考风格图，生成符合指定比例的换脸效果。使用前请确保：
  1. 参考图片清晰，面部特征可识别；
  2. 避免上传违规、侵权的图片内容；
  3. 生成结果仅用于合法合规的场景。
换脸效果示例

授权

​
TT-API-KEY
string
header
必填

授权字段，控制台获取授权信息

请求体

application/json
​
targetImage
string
必填

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

​
swapImage
string
必填

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

​
hookUrl
string

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

响应

请求成功

​
status
string
必填
示例:

"SUCCESS"

​
message
string
必填
示例:

"success"

​
data
object
必填
示例:
{ "job_id": "job_id" }
Last modified on March 12, 2026