企业官网建设流程全解析

面部美化 API 集成指南

在本教程中，我们将介绍如何集成面部美化 API。该 API 能够准确识别面部特征，并通过用户上传的面部图像实现皮肤平滑、皮肤美白和去痘等美化功能（每张图像最多可处理五张面孔）。

环境准备

在使用 API 之前，您需要在 Face Beautification API 页面申请相应的服务。确保您已经注册并登录到平台。

应用流程

1. 申请 API 服务：访问上面的链接后，点击“获取”按钮，如下图所示：

2. 登录或注册：如果您尚未登录或注册，系统会自动重定向到登录页面。完成登录或注册后，您将返回到申请页面。

3. 使用免费配额：首次申请时，您将获得免费的 API 调用配额。

基本使用方法

使用 API 的基本方法是输入图像链接和美化参数，以获取处理后的结果图像。您需要传递image_url字段，示例如下图所示：

接下来，您还需上传与面部美化相关的参数。请求体信息如下所示，您可以在界面上填写相应内容，如下图所示：

请求头中包含：

• accept：期望返回的结果格式，这里填写为application/json，表示返回 JSON 格式。
• authorization：调用 API 的密钥，可以在申请后直接选择。

请求体包括：

• image_url：需要处理的面部图像链接。
• smoothing：皮肤平滑程度，范围为 [0,100]，0 表示不平滑，100 表示最高程度，默认值为 10。
• whitening：皮肤美白程度，范围为 [0,100]，0 表示不美白，100 表示最高程度，默认值为 30。
• face_lifting：面部瘦身程度，范围为 [0,100]，0 表示不瘦身，100 表示最高程度，默认值为 70。
• eye_enlarging：眼睛放大程度，范围为 [0,100]，0 表示不放大，100 表示最高程度，默认值为 70。

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

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

{"image_url":"https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/fmu/BeautifyPic/1256437459/1a68c13b-b03c-4c7b-92a1-e4a9b5f1d7ec"}

返回结果包含image_url字段，即根据输入的美化信息处理后的面部图像。如下图所示，您可以看到图像中的面部已根据输入的美化信息进行了变化：

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

curl-XPOST'https://api.acedata.cloud/face/beautify'\-H'accept: application/json'\-H'authorization: Bearer {token}'\-H'content-type: application/json'\-d'{ "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg", "smoothing": 50, "whitening": 50, "face_lifting": 50, "eye_enlarging": 50 }'

Python 集成代码如下：

importrequests url="https://api.acedata.cloud/face/beautify"headers={"accept":"application/json","authorization":"Bearer {token}","content-type":"application/json"}payload={"image_url":"https://cdn.acedata.cloud/lrbtcn.jpg","smoothing":50,"whitening":50,"face_lifting":50,"eye_enlarging":50}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。如有任何疑问，请随时联系技术支持团队。

技术标签：#面部美化 #API集成 #Python #数据处理 #AceDataCloud