TTAPI 中文文档
  • TTAPI 中文文档
  • API能力
    • 🔥Midjourney API
    • Flux API
    • Recraft API
    • 📖LLM API
    • 🔀Midjourney Hold Account
    • 🟢OpenAI Image Models
    • 🔵Luma
    • 🎵Suno
    • 🔗账户体系
    • ⭕状态码详解
  • 企业服务
    • Midjourney离线服务
  • 问答专区
    • Midjourney
      • 常见问题解答
      • 账户托管
      • 科学使用你的Midjourney账户
    • Luma
    • 使用相关
    • 其他杂项
  • 升级日志
Powered by GitBook
On this page
  • 创建换脸 Create SwapFace
  • 获取换脸结果 Fetch SwapFace
  • 换脸结果数据结构 HookUrl JSON
  • 换脸返回参数详解

Was this helpful?

  1. API能力

SwapFace换脸

TTAPI SwapFace换脸服务

Last updated 9 months ago

Was this helpful?

创建换脸 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

否

请求示例

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

响应示例

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "SWAP-FACE-171349414479347616"
  }
}
{
  "status": "FAILED",
  "message": "'action' parameter error!",
  "data": null
}

获取换脸结果 Fetch SwapFace

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

Headers

Name
Value

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

{
  "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
  }
}
{
  "status": "ON_QUEUE",
  "message": null,
  "jobId": "SWAP-FACE-171349414479347616",
  "data": null
}
{
  "status": "FAILED",
  "message": null,
  "jobId": "SWAP-FACE-171349414479347616",
  "data": null
}

换脸返回参数详解

参数
详解

status

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

targetImage

用户上传的模板图像地址

swapImage

用户上传的人脸图像地址

discordImage

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

cdnImage

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

quota

实际消耗额度

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

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

🟣
hookUrl
通知数据结构
fetch