面部性别转换API集成指南

用户00045392116
5 阅读3分钟

在现代科技的推动下，面部图像处理已经成为了一项热门应用。Ace Data Cloud 提供的面部性别转换API，允许用户上传面部图像，并利用人脸编辑与生成算法输出转换后的性别图像。无论是男性转女性，还是女性转男性，API 都能实现如美化、轻妆、刘海、长发等效果。

申请流程

要使用此API，首先需要在 面部性别转换API 页面申请相应服务。进入页面后，点击“获取”按钮，如下图所示：

若未登录或注册，系统会自动重定向至登录页面，邀请您进行注册和登录。登录或注册成功后，您将自动返回当前页面。

在首次申请时，系统会提供免费的配额，允许您免费使用该API。

基本用法

使用此API的基本方法是输入图像链接和性别信息，以获取处理结果图像。您只需传递一个 image_url 字段，面部图像如下所示：

接下来，我们需要上传面部性别信息参数 gender_infos，这是一个数组，允许我们传递多条信息。界面上填入相应内容，如下图所示：

在请求头部分，我们需要设置：

  • accept: 期望接收的响应结果格式，填写为 application/json，即表示JSON格式。
  • authorization: 调用API的密钥，申请后可直接选择。

请求体中需要设置：

  • image_url: 需要处理的面部图像链接。
  • gender_infos: 面部性别及区域信息，性别为必填参数，0表示男性转女性，1表示女性转男性。

完成选择后，您可以看到右侧生成了相应的代码，如下图所示：

点击“尝试”按钮进行测试，您将获得如下结果：

{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/ft/SwapGenderPic/1256437459/1d85ceb9-6847-41ec-a9fd-7a20ddbd13b6"
}

从返回结果中可以看到，包含 image_url 字段，指向根据输入性别转换参数生成的面部图像。转换后的面部信息如下：

您可以看到，图像中的面部特征已根据输入性别变化。

此外，如果您希望生成相应的集成代码，可以直接复制，例如，CURL代码如下：

curl -X POST 'https://api.acedata.cloud/face/change-gender' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
  "gender_infos": [{"gender":1}]
}'

Python的集成代码如下：

import requests

url = "https://api.acedata.cloud/face/change-gender"

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

payload = {
    "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
    "gender_infos": [{"gender":1}]
}

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

错误处理

在调用API时，如果发生错误，API会返回相应的错误代码和信息。例如：

  • 400 token_mismatched: 错误请求，可能由于缺少或无效参数。
  • 400 api_not_implemented: 错误请求，可能由于缺少或无效参数。
  • 401 invalid_token: 未授权，授权令牌无效或缺失。
  • 429 too_many_requests: 请求过多，超过了频率限制。
  • 500 api_error: 服务器内部错误，服务器出现问题。

错误响应示例

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

总结

通过本文，您已经学习了如何使用面部性别转换API，根据用户上传的面部图像进行性别转换。希望本指南能帮助您更好地集成和使用该API。如有任何疑问，请随时联系技术支持团队。

Ace Data Cloud 官网 | API 文档 | 授权管理

标签：#面部识别 #API #图像处理 #深度学习 #AceDataCloud

avatar
文章
阅读
粉丝