腾讯云人像分割

要解决的问题

在图片处理流程中，常见需求是把人物从复杂背景里单独抠出来，用于海报合成、视频素材制作、电商主图或虚拟形象处理。传统方式依赖手动蒙版或通用大模型“看”图，结果不稳定，且难以保证输出的是真实抠像结果。该技能把这项任务收敛为一次同步 API 调用：输入图片，识别人体完整轮廓，返回人像分割结果，避免把“看起来像抠像”的内容误当成最终产物。

技能如何工作

该技能基于腾讯云 SegmentPortraitPic 能力，通过核心脚本 scripts/main.py 执行。它接收待处理图片，调用腾讯云人像分割服务，完成人体轮廓识别与抠像处理，再同步返回结果。使用前提是在腾讯云控制台开通人像分割服务，配置 API 密钥与环境变量，并满足 Python 3.7+ 与 tencentcloud-sdk-python 依赖条件；资料说明脚本可自动安装依赖。对 Agent 的执行边界也比较明确：当用户提供图片且意图是人像分割时，应直接调用脚本，不应只打印路径、不询问确认、不手动安装依赖；如果调用失败，必须返回清晰错误，严禁由模型自行猜测或编造抠像内容。

适用边界与注意点

该技能适合单张图片或少量图片的人像分割处理，输入图片大小限制为 ≤5MB，返回方式为同步。它不是通用图像分割工具，也不承诺处理任意人体姿态、多人重叠、遮挡严重或非人像主体场景。实际接入时应检查腾讯云服务开通状态、密钥权限和网络可达性；对失败响应应保留原始错误信息，便于定位是参数、配额、服务状态还是图片本身导致。适合嵌入已有媒体处理流水线，作为从“原图”到“人像素材”的确定性步骤。