AI MediaKit 图像人脸打码工具，能够自动检测图片中的所有人脸区域，并对检测到的人脸进行马赛克处理，实现一键人脸隐私保护。该工具适用于社交平台内容审核、街景或监控画面脱敏、新闻媒体素材处理、AI 训练数据集脱敏等多种需要批量保护人脸隐私的场景。本篇开发指南将引导您： * 快速体验通过一次 API 调用，为图片中的所有人脸打上马赛克。 * 理解如何通过调整参数，精细化控制打码的形状、强度与检测灵敏度。 ## 效果示例 |输入原图 |打码效果 | |---|---| |![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/c79942b0dc1a4f3f9f291cf38db0f9d2) |![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/a6296e174acb4f6d9ff739f3a88e7730) | ## 快速体验：一键为人脸打码图像人脸打码是一个**同步任务**，您发起的请求会直接在响应中返回处理结果。 ### 准备工作 1. **获取访问凭证**：在开始之前，访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **AI MediaKit API Key**（用于媒体处理功能鉴权）。 2. **准备图像文件**：准备一张待处理的图片，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。为方便您快速测试，本文后续步骤的示例代码中提供了一个可直接使用的演示图像 URL。 ### 操作流程您只需调用[提交图像人脸打码任务 API](https://www.volcengine.com/docs/6448/2534914)，即可在 API 的响应体中直接获取打码后的图片地址。 #### 步骤 1：提交任务并获取结果可直接复制以下 cURL 命令，替换其中的参数后执行。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/face-blur-image' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "image_url": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/street.jpeg" }' ```

说明

将 {Your_API_Key} 替换为您的有效 API Key。

image_url 替换为您真实的图片地址。

#### 步骤 2：查看响应由于是同步接口，请求成功后，您会在几秒内收到包含最终结果的响应。您可以直接从 `result.image_url` 字段获取打码后图片的下载地址（有效期为 24 小时）。 ```JSON { "success": true, "task_id": "amk-tool-face-blur-image-123456789", "task_type": "face-blur-image", "request_id": "20260617202100EXAMPLE123456789", "result": { "image_url": "https://example-domain.com/path/to/blurred_image.webp?auth_key=...", "image_size": 111174, "image_format": "webp", "image_width": 2732, "image_height": 1534, "face_count": 4, "face_location": [ { "top_left_x": 2017, "top_left_y": 637, "bottom_right_x": 2215, "bottom_right_y": 894, "confidence": 0.9995 }, { "top_left_x": 581, "top_left_y": 576, "bottom_right_x": 766, "bottom_right_y": 848, "confidence": 0.9993 }, { "top_left_x": 1299, "top_left_y": 604, "bottom_right_x": 1447, "bottom_right_y": 837, "confidence": 0.9962 }, { "top_left_x": 1761, "top_left_y": 669, "bottom_right_x": 2027, "bottom_right_y": 1045, "confidence": 0.9907 } ] }, "expires_at": 1781785262 } ``` ## 进阶使用您可以通过配置不同的 Body 参数，对打码效果进行精细化控制。 ### 控制打码样式通过 `blur_shape` 和 `mosaic_step` 参数，调整打码的形状与强度。 |参数 |说明 | |---|---| |`blur_shape` |人脸模糊区域的形状。

* `circle`：（默认）圆形

* `rectangle`：矩形 | |`mosaic_step` |马赛克像素格大小，单位为 px 的正整数。值越大马赛克颗粒越大、脱敏强度越高。建议范围 `[5, 100]`，默认值为 `12`。 | #### **示例：使用矩形、高强度的马赛克** ```JSON { "image_url": "https://example.com/source.jpg", "blur_shape": "rectangle", "mosaic_step": 20 } ``` ### 调整检测灵敏度通过 `face_detect_thresh` 参数，您可以调整人脸检测的置信度阈值，取值范围为 (0, 1)。 * **调高此值**：检测更严格，可以减少对非人脸区域的误判，但可能漏掉一些清晰度较低或非正面的人脸。 * **调低此值**：检测更宽松，可以召回更多模糊、遮挡的人脸，但可能会增加误判。默认值为 `0.9`。 #### **示例：降低检测阈值以召回更多模糊人脸** ```JSON { "image_url": "https://example.com/source.jpg", "face_detect_thresh": 0.8 } ``` ## 参考信息 ### 性能与限制 |限制项 |说明 | |---|---| |输入图像限制 |* 图像来源：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、火山引擎对象存储 (`tos://`) 三种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://www.volcengine.com/docs/6448/2536893)。

* 文件大小：建议不超过 35 MB，图片文件过大可能导致处理失败。

* 分辨率限制：图片宽度和高度的乘积不得超过 4 亿像素。

* 支持格式：支持 `.png`、`.jpg`、`.jpeg`、`.webp` 、`.avif` 等主流图像格式，不支持动图。 | ## 相关 API 文档 * [提交图像人脸打码任务 API](https://www.volcengine.com/docs/6448/2534914)