Single Face Swap V2.0

POST

/AIGCImgOpenServ/saas/tool/v2/roop

roop + codeformer
Two pictures with human faces are passed in and are recorded as source_image and target_image respectively. The algorithm copies the face in source_image to target_image to generate a new picture. The anti-parameter is the asynchronous interface response~

Request

Header Params

X-Request-req-accessKeyId

string

optional

X-Request-req-accessKeySecret

string

optional

Body Params application/json

sourceUrl

string

required

The image url address passed by the user to provide facial information

targetUrl

string

required

The image url address passed by the user to accept facial information

businessTaskId

string

required

Task ID

fidelityWeight

string

optional

The value range is [0, 1], used to balance the quality and fidelity of generated images

callbackUrl

string

optional

Some of the interfaces used to return drawing results from the server are asynchronous interfaces. Please check the remarks. Only when the json string code = 200 received in the response will we mark the request as successful, such as {"code":"200"} and the ladder interval to retry 3. , 5, 15, 30, 60, 600, 3600 seconds, retry up to 10 times

Example

{
    "sourceUrl": "https://dbt-aigc.oss-cn-hangzhou.aliyuncs.com/Output-Img2/dalle_face.png",
    "targetUrl": "https://dbt-aigc.oss-cn-hangzhou.aliyuncs.com/Output-Img2/DALL%C2%B7E%202023-11-20%2010.06.53%20-%20Photo-realistic%20illustration%20of%20Liming%20from%20image%20x1%2C%20leaving%20his%20hometown%20and%20embarking%20on%20a%20journey%20to%20the%20Xinjiang%20Production%20and%20Construction%20Corp.png",
    "businessTaskId": "111612"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zhiqite.com/AIGCImgOpenServ/saas/tool/v2/roop' \
--header 'X-Request-req-accessKeyId;' \
--header 'X-Request-req-accessKeySecret;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sourceUrl": "https://dbt-aigc.oss-cn-hangzhou.aliyuncs.com/Output-Img2/dalle_face.png",
    "targetUrl": "https://dbt-aigc.oss-cn-hangzhou.aliyuncs.com/Output-Img2/DALL%C2%B7E%202023-11-20%2010.06.53%20-%20Photo-realistic%20illustration%20of%20Liming%20from%20image%20x1%2C%20leaving%20his%20hometown%20and%20embarking%20on%20a%20journey%20to%20the%20Xinjiang%20Production%20and%20Construction%20Corp.png",
    "businessTaskId": "111612"
}'

Responses

🟢200OK

application/json

Body

code

string

required

msg

string

required

data

object

required

taskId

string

required

businessTaskId

string

required

status

integer

required

1: Generating 2: Success 0: Failure

outputImageUrl

string

required

errCode

integer

required

1: No face failed 2: Image download failed

Example

{
    "code": "200",
    "data": {
        "businessTaskId": "555299995",
        "outputImageUrl": "https://aigcoss.zhiqiteai.cn/Output-Img2/tool/roopV2/pro1707112101440360871154.png",
        "status": 2,
        "taskId": "pro1707112101440360871154"
    },
    "msg": "success"
}

Modified at 2024-08-29 10:07:52

Single Face Swap V1.0

instantID