文档中心

AI MediaKit

图像工具

图像人脸打码

AI MediaKit 图像人脸打码工具，能够自动检测图片中的所有人脸区域，并对检测到的人脸进行马赛克处理，实现一键人脸隐私保护。该工具适用于社交平台内容审核、街景或监控画面脱敏、新闻媒体素材处理、AI 训练数据集脱敏等多种需要批量保护人脸隐私的场景。

本篇开发指南将引导您：

效果示例

输入原图	打码效果

快速体验：一键为人脸打码

图像人脸打码是一个同步任务，您发起的请求会直接在响应中返回处理结果。

准备工作

获取访问凭证：在开始之前，访问 AI MediaKit 控制台 API Key 管理页面，创建并获取 AI MediaKit API Key（用于媒体处理功能鉴权）。

准备图像文件：准备一张待处理的图片，并将其上传至公网可访问的服务器或视频点播服务中，以获取可供 API 调用的 URL。为方便您快速测试，本文后续步骤的示例代码中提供了一个可直接使用的演示图像 URL。

操作流程

您只需调用提交图像人脸打码任务 API，即可在 API 的响应体中直接获取打码后的图片地址。

步骤 1：提交任务并获取结果

可直接复制以下 cURL 命令，替换其中的参数后执行。

说明

步骤 2：查看响应

由于是同步接口，请求成功后，您会在几秒内收到包含最终结果的响应。您可以直接从 result.image_url 字段获取打码后图片的下载地址（有效期为 24 小时）。

进阶使用

您可以通过配置不同的 Body 参数，对打码效果进行精细化控制。

控制打码样式

通过 blur_shape 和 mosaic_step 参数，调整打码的形状与强度。

参数	说明
blur_shape	人脸模糊区域的形状。 circle：（默认）圆形 rectangle：矩形
mosaic_step	马赛克像素格大小，单位为 px 的正整数。值越大马赛克颗粒越大、脱敏强度越高。建议范围 [5, 100]，默认值为 12。

示例：使用矩形、高强度的马赛克

调整检测灵敏度

通过 face_detect_thresh 参数，您可以调整人脸检测的置信度阈值，取值范围为 (0, 1)。

默认值为 0.9。

示例：降低检测阈值以召回更多模糊人脸

参考信息

性能与限制

限制项

说明

输入图像限制

图像来源：支持公网 HTTP/HTTPS URL、本地上传 (mediakit://)、火山引擎对象存储 (tos://) 三种输入协议。关于各协议的具体说明和使用示例，请参阅多源媒体输入与本地上传。