{"skill":{"slug":"tencentcloud-faceid-detectaifakefaces","displayName":"TencentCloud FaceID DetectAIFakeFaces","summary":"腾讯云AI人脸防护盾(DetectAIFakeFaces)接口调用技能。当用户需要对人脸图片或视频进行防攻击检测时,应使用此技能。可针对性有效识别高仿真的AIGC换脸、高清翻拍、批量黑产攻击、水印等攻击痕迹,增强对图片和视频的防伪安全能力。支持图片Base64和视频Base64两种输入方式。","description":"---\nname: tencentcloud-faceid-detectaifakefaces\ndescription: 腾讯云AI人脸防护盾(DetectAIFakeFaces)接口调用技能。当用户需要对人脸图片或视频进行防攻击检测时,应使用此技能。可针对性有效识别高仿真的AIGC换脸、高清翻拍、批量黑产攻击、水印等攻击痕迹,增强对图片和视频的防伪安全能力。支持图片Base64和视频Base64两种输入方式。\n---\n\n# 腾讯云 AI 人脸防护盾 (DetectAIFakeFaces)\n\n## 用途\n调用腾讯云人脸核身 AI 人脸防护盾接口，基于多模态的 AI 大模型算法，提供对人脸图片、视频的防攻击检测能力。\n\n## 注意事项\n请确保您委托本服务处理人脸等个人信息已获得个人信息主体合法、有效的同意或具备其他的合法性基础，本服务的相关具体事项以本服务官网所载服务协议约定为准。\n\n核心能力：\n- **AIGC换脸检测**：识别高仿真的 AI 生成/合成换脸攻击\n- **翻拍检测**：识别高清翻拍攻击痕迹\n- **黑产攻击检测**：识别批量黑产攻击行为\n- **水印检测**：识别图片/视频中的水印等攻击痕迹\n- **多输入类型**：支持图片 Base64、视频 Base64 两种输入方式，传入本地文件时可自动识别类型并转为 Base64（图片仅支持 jpg/png，视频仅支持 mp4/avi/flv）\n\n官方文档：https://cloud.tencent.com/document/product/1007/101561\n\n## 使用时机\n\n当用户提出以下需求时触发此技能：\n- 需要检测人脸图片是否为 AI 合成/换脸\n- 需要检测人脸图片是否为翻拍照片\n- 需要检测人脸视频是否存在攻击痕迹\n- 需要对人脸图片/视频进行防伪安全检测\n- 涉及人脸防攻击、防伪检测的任何场景\n\n## 环境要求\n\n- Python 3.6+\n- 依赖：`tencentcloud-sdk-python`（通过 `pip install tencentcloud-sdk-python` 安装）\n- 环境变量：\n  - `TENCENTCLOUD_SECRET_ID`：腾讯云API密钥ID\n  - `TENCENTCLOUD_SECRET_KEY`：腾讯云API密钥Key\n\n## 使用方式\n\n运行 `scripts/main.py` 脚本完成 AI 人脸防护盾检测。\n\n### 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| FaceInput | str | 是 | 本地图片/视频文件路径（自动转 Base64）或 Base64 字符串 |\n| FaceInputType | int | 否 | 输入类型：`1`(图片) / `2`(视频)。传入本地文件时可省略，自动根据扩展名识别 |\n\n### 图片输入规格\n\n- **格式**：仅支持 jpg、png 格式\n- **分辨率**：建议整体图像 480×640，脸部大小在 100×100 以上\n- **拍摄要求**：由手机前置摄像头拍摄\n- **大小限制**：Base64 编码后的图片数据大小建议不超过 3MB，最大不可超过 10MB\n- **编码规范**：请使用标准的 Base64 编码方式（带=补位），编码规范参考 RFC4648\n\n### 视频输入规格\n\n- **格式**：仅支持 mp4、avi、flv 格式\n- **时长**：建议 2～5 秒，最大不可超过 20 秒\n- **分辨率**：建议 480×640（最大支持 720p）\n- **帧率**：建议 25fps～30fps\n- **拍摄要求**：由手机前置摄像头拍摄\n- **大小限制**：Base64 编码后的大小建议在 8MB 以内，最大不可超过 10MB\n- **编码规范**：请使用标准的 Base64 编码方式（带=补位），编码规范参考 RFC4648\n\n### 输出格式\n\n检测成功后返回 JSON 格式结果：\n\n```json\n{\n  \"AttackRiskLevel\": \"Low\",\n  \"AttackRiskDetailInfos\": [\n    {\n      \"Type\": \"换脸攻击\",\n      \"RiskLevel\": \"Low\"\n    }\n  ],\n  \"RequestId\": \"xxx\"\n}\n```\n\n### 风险等级说明\n\n| 风险等级 | 含义 |\n|----------|------|\n| Low | 低风险，图片/视频为正常人脸 |\n| Mid | 中风险，存在一定攻击嫌疑 |\n| High | 高风险，极有可能为攻击行为 |\n\n### 攻击类型说明\n\n| 攻击类型 | 含义 |\n|----------|------|\n| 换脸攻击 | 检测到 AI 换脸/合成痕迹 |\n| 翻拍攻击 | 检测到屏幕翻拍痕迹 |\n| 活体伪造 | 检测到活体伪造痕迹 |\n| 黑产攻击 | 检测到批量黑产攻击痕迹 |\n| 水印攻击 | 检测到水印攻击痕迹 |\n\n### 调用示例\n\n```bash\n# 传入本地图片文件(自动识别类型并Base64编码)\npython scripts/main.py --face-input ./face.jpg\n\n# 传入本地视频文件(自动识别类型并Base64编码)\npython scripts/main.py --face-input ./face_video.mp4\n\n# 手动指定类型 + Base64字符串\npython scripts/main.py --face-input-type 1 --face-input \"<base64_string>\"\n\n# 手动指定类型 + 视频Base64字符串\npython scripts/main.py --face-input-type 2 --face-input \"<base64_string>\"\n```\n","topics":["接口调用","安全","批量","接口"],"tags":{"latest":"1.0.3"},"stats":{"comments":0,"downloads":658,"installsAllTime":25,"installsCurrent":1,"stars":1,"versions":4},"createdAt":1773226737698,"updatedAt":1778491828096},"latestVersion":{"version":"1.0.3","createdAt":1773913475218,"changelog":"- 增加了隐私与合规性说明，提醒用户需合法取得人脸等个人信息的授权或合法性基础\n- 其他功能和使用方式保持不变","license":"MIT-0"},"metadata":null,"owner":{"handle":"hzzhanglijie","userId":"s1705ep7w9ddwfs64nathvbdr58849tk","displayName":"hzzhanglijie","image":"https://avatars.githubusercontent.com/u/19301985?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089977291}}