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
:此次换脸生成任务的唯一标识。
生成的图像效果如下:
可以明显看到,这张图像成功将目标图像中的人脸替换到了源图像中。