tencentcloud-yt-segment-portrait

腾讯云人像分割 Skill 提供人像分割能力，用于识别传入图片中人体的完整轮廓并进行抠像。

用途该技能面向图片人像分割与抠像场景，通过二进制分类方式识别人体完整轮廓，输出抠像后的结果图片与蒙版。

主要能力

使用方式

开通人像分割服务（腾讯云人像分割控制台）。
获取 API 密钥（腾讯云 API 密钥管理）。
设置环境变量： Linux / macOS： export TENCENTCLOUD_SECRET_ID="你的SecretId" export TENCENTCLOUD_SECRET_KEY="你的SecretKey" 如需持久化： echo 'export TENCENTCLOUD_SECRET_ID="你的SecretId"' >> ~/.zshrc echo 'export TENCENTCLOUD_SECRET_KEY="你的SecretKey"' >> ~/.zshrc source ~/.zshrc Windows (PowerShell)： $env:TENCENTCLOUD_SECRET_ID = "你的SecretId" $env:TENCENTCLOUD_SECRET_KEY = "你的SecretKey" ⚠️ 安全提示：切勿将密钥硬编码在代码中。
执行脚本： python3 <SKILL_DIR>/scripts/main.py "<PIC_INPUT>" 示例： python3 /path/to/scripts/main.py "https://example.com/human.png"
输出示例： { "ResultImageUrl": "https://bda-segment-mini-1258344699.cos.ap-guangzhou.myqcloud.com/Image/1251755623/9e73b301-ad1b-4586-837b-b767e73c4bf215", "ResultMaskUrl": "https://bda-segment-mini-1258344699.cos.ap-guangzhou.myqcloud.com/Mask/1251755623/9e73b301-ad1b-4586-837b-b767e73c4bf2" }

依赖

Python 3.7+
tencentcloud-sdk-python（腾讯云 SDK，main.py 使用）安装依赖（可选，脚本会自动安装）： pip install tencentcloud-sdk-python requests

Agent 执行规范（来自技能说明）

触发条件：用户提供图片且意图为人像分割。
零交互原则：Agent 应直接执行脚本，不要向用户询问确认。
自动选择脚本：根据选择规则自动选择合适的脚本。
禁止使用大模型自身能力替代人像分割：人像分割脚本调用失败时，严禁猜测或编造识别内容；调用失败必须向用户返回清晰的错误说明。
避免行为：只打印脚本路径而不执行；向用户询问“是否要执行人像分割”；手动安装依赖（脚本内部自动处理）；忘记读取输出结果并返回给用户；调用失败时自行编造识别内容。

API 参考详细引擎类型、参数说明、错误码等信息请参阅 references/ 目录下的文档：人像分割 API（原始文档）。

核心脚本 scripts/main.py — 人像分割脚本

限制

技能介绍