Face Swap API 的整合与使用手册

Face Swap API 的整合与使用手册

Face Swap API 是一款功能强大的工具，能够通过提供一张源图像和一张目标图像，将目标图像中的人脸巧妙地替换为源图像中对应的位置。

在本手册中，我们将逐步指导您如何整合 Face Swap API，以便您能轻松掌握并充分利用其独特功能。借助 Face Swap API，您可以轻松地将目标图像中的面孔转移至源图像。

申请流程

在使用 Face Swap API 之前，您需要访问申请页面 Face Swap API 提交申请。访问页面后，请点击「Acquire」按钮，如下所示：

如果您尚未登录或注册，系统会将您引导至登录页面。请按提示完成注册或登录，完成后系统将引导您返回申请页面。

首次申请时，您将获得免费的使用额度，可以体验这个 API 的强大特性。

请求示范

接下来，我们将通过两个图像的实际案例演示如何利用这个 API。首先，我们的源图像如下：

而这是我们的目标图像：

下面将展示如何把目标图像中的人脸放入源图像中。

请求头与请求体的设置

请求头（Request Headers） 应该包含以下内容：

• accept：表明您希望接收 JSON 格式的响应，设置为 application/json。
• authorization：API 调用所需的密钥，注册后可以直接从下拉菜单中选择。

请求体（Request Body） 包括：

• source_image_url：源图像的 URL 地址。
• target_image_url：目标图像的 URL 地址。

请参考下方图示进行具体设置：

代码示例

您将注意到，页面右侧会自动生成多种编程语言的调用示例，如下所示：

以下是几个代码示例：

CURL

bash curl -X POST 'https://api.acedata.cloud/face/swap' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "source_image_url": "https://cdn.zhishuyun.com/77e05993-a3ab-4628-b827-abb904382663.png", "target_image_url": "https://cdn.zhishuyun.com/e10a16b2-52b7-4854-99e7-7a6b9faa017b.png" }'

Python

```python import requests

url = "https://api.acedata.cloud/face/swap"

headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" }

payload = { "source_image_url": "https://cdn.zhishuyun.com/77e05993-a3ab-4628-b827-abb904382663.png", "target_image_url": "https://cdn.zhishuyun.com/e10a16b2-52b7-4854-99e7-7a6b9faa017b.png" }

response = requests.post(url, json=payload, headers=headers) print(response.text) ```

响应示例

如果 API 请求成功，您将收到处理完成的换脸结果，示例如下：

json { "image_url": "https://platform.cdn.acedata.cloud/face/4b13bdeb-1b19-4ea5-bddf-c2da14ba72e3.png", "image_width": 2008, "image_height": 1942, "image_size": 4006213, "task_id": "4b13bdeb-1b19-4ea5-bddf-c2da14ba72e3" }

从中可以看出，响应中包含 image_url 字段，指向处理后的图片链接，同时还提供了其它相关信息，包括：

• image_url：生成的图像链接。
• image_width：生成图像的宽度。
• image_height：生成图像的高度。
• image_size：生成图像的文件大小。
• task_id：此次换脸生成任务的唯一标识。

生成的图像效果如下：

可以明显看到，这张图像成功将目标图像中的人脸替换到了源图像中。