Img Open

超级换脸 faceFusion

POST

/AIGCImgOpenServ/saas/tool/face/fusion

支持使用者上传两张原始图片和一张目标图片，其中目标图片类似于两人合照，基于本接口可实现将原始图的人脸替换至目标图中。

请求参数

Header 参数

X-Request-req-accessKeyId

string

必填

可选

示例值:

accessKeyId

X-Request-req-accessKeySecret

string

必填

可选

示例值:

accessKeySecret

Body 参数application/json

sourceUrl

array[string]

源图片

必需

用户传入的提供面部信息的图片url地址

>= 1 items<= 2 items

targetUrl

string

目标图片

必需

用户传入的接受面部信息的图片url地址

faceIdx

integer

可选

用于换多张脸中一张脸时使用
source中人脸需要替换到target中多张人脸中具体序号
人脸的顺序是按其在图片中的位置从左至右排列；若tager image中有三张人脸，face_idx的取值范围为[1, 3]

businessTaskId

string

任务ID

必需

任务ID

callbackUrl

string

回调地址

可选

用于服务端回传绘图结果有部分接口是异步接口 , 请查看备注收到响应的json字符串 code = 200 我们才会标记为请求成功如 {"code":"200"} 阶梯间隔重试 3 、5、15、30、60 、600、3600秒最多重试10次

示例

{
  "businessTaskId": "10086996",
  "sourceUrl": [
    "https://aigcoss.zhiqiteai.cn/Output-Img2/zjy/pic3-1.png",
    "https://aigcoss.zhiqiteai.cn/Input-Img/superJ/8696fa0a-6dfc-4907-97fc-a4db0c24a04a.jpeg"
  ],
  "targetUrl": "https://aigcoss.zhiqiteai.cn/Input-Img/superJ/151b18c7-7e2b-4313-8d21-65de676ef264.jpeg"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zhiqite.com/AIGCImgOpenServ/saas/tool/face/fusion' \
--header 'X-Request-req-accessKeyId: accessKeyId' \
--header 'X-Request-req-accessKeySecret: accessKeySecret' \
--header 'Content-Type: application/json' \
--data-raw '{
    "businessTaskId": "10086996",
    "sourceUrl": ["https://aigcoss.zhiqiteai.cn/Output-Img2/zjy/pic3-1.png", "https://aigcoss.zhiqiteai.cn/Input-Img/superJ/8696fa0a-6dfc-4907-97fc-a4db0c24a04a.jpeg"],
    "targetUrl": "https://aigcoss.zhiqiteai.cn/Input-Img/superJ/151b18c7-7e2b-4313-8d21-65de676ef264.jpeg"
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

msg

string

必需

data

object

必需

taskId

string

任务ID

必需

businessTaskId

string

业务任务ID

必需

toolTask

string

任务类型

必需

status

string

任务状态

必需

outputImageUrl

string

图片地址

必需

示例

{
  "code": "200",
  "msg": "success",
  "data": {
    "taskId": "pre1715827520336429778183",
    "businessTaskId": "10086996",
    "toolTask": "faceFusion",
    "status": 1,
    "outputImageUrl": "https://aigcoss.zhiqiteai.cn/Output-Img2/roop/pro1703734845555845969817.png"
  }
}

修改于 2024-06-12 06:27:56

高级换脸

面部检测(脸部提取) faceDetection