前言¶
内容审核、风控和运营侧经常要判断一张图是实拍还是 AIGC 产出。若只在对话里让大模型「看一眼」，结果不可复现，也难对接业务规则。更稳妥的做法是走云侧专用检测接口，再把调用方式封装成 Agent 能执行的 Skill。
下面介绍 SkillHub 上的 TencentCloud Image AIGC Detection（坐标 @tencent-adm/tencentcloud-aigc-recog-image）。它把腾讯云图片内容安全里的 AI 生成图片识别能力，收敛为 SKILL.md 规范与 scripts/main.py 脚本，便于在 Cursor、Claude Code 等支持 Skills 的客户端里直接跑检测。
这是什么¶
TencentCloud Image AIGC Detection 是腾讯云内容识别团队发布的企业来源 Skill（SkillHub 分类 it-ops-security，当前版本 1.0.8）。定位是 AI 生成内容检测工具：对输入图像做是否为 AIGC 生成的判定，适用于 AI 生成图片检测、图片真伪鉴别、AI 绘画检测、Deepfake 检测等场景。
Skill 标签标明 requires_api_key=true，依赖腾讯云 API 密钥及控制台策略编号；底层通过 ImageModeration 接口、Type=IMAGE_AIGC 完成识别（详见 Skill 内 references/image_moderation_api.md）。
在 SkillHub 社区页可见：评分 100000，下载 4626 次，安装 372 次（数据以 SkillHub 页面展示为准）。
核心功能¶
以下能力均来自 Skill 官方 SKILL.md 与脚本说明，可与安装包内文档核对。
- AI 生成图片判定：分析输入图片，返回是否为 AI 生成。
- 风险评分：0–100 置信度，分数越高越可能为 AI 生成。
- 处置建议：
Pass（真实图片）、Review（存疑）、Block（AI 生成）。 - 详细结果：包含命中标签、子标签等（如
GeneratedContentRisk、AIImageGenerated）。
输入方式
| 方式 | 说明 |
|---|---|
| 图片 URL | 传入网络地址 |
| 本地文件 | 传入路径，脚本读取并 Base64 编码 |
限制（Skill 文档写明）
- 单图大小上限 5MB
- 格式：PNG、JPG、JPEG、BMP、GIF、WEBP
- API 调用频率以腾讯云控制台配额为准
文档还提到可对 Stable Diffusion、Midjourney、GPT-4o 等主流模型生成图像做识别，具体效果以线上服务为准。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行（仅 CLI）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
完整安装说明见：https://skillhub.cn/install/skillhub.md
2. 安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
skillhub install @tencent-adm/tencentcloud-aigc-recog-image --dir <你的 skills 目录>
常用路径示例（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可按 SkillHub 技能页提示，让 Agent 阅读 https://skillhub.cn/install/skillhub.md 后安装 @tencent-adm/tencentcloud-aigc-recog-image。
3. 开通服务并配置环境变量¶
在跑脚本前，需完成控制台开通与密钥配置（Skill 文档「环境配置指引」）。
- 在 腾讯云内容安全生成识别控制台 开通 AI 生成图片检测（初始化配置后体验）。
- 在 API 密钥管理 获取
SecretId/SecretKey。 - 在 策略管理 的「应用管理」中找到 AI 生成检测配套策略，记下图片内容安全对应的 BizType。
- 设置环境变量（Linux / macOS 示例）：
export TENCENTCLOUD_SECRET_ID="你的SecretId"
export TENCENTCLOUD_SECRET_KEY="你的SecretKey"
export TENCENTCLOUD_AIGC_RECOG_IMAGE_BIZ_TYPE="你的BizType"
TENCENTCLOUD_AIGC_RECOG_IMAGE_BIZ_TYPE 为必需项，未配置时脚本会以 BIZ_TYPE_NOT_CONFIGURED 退出。若使用 STS 临时凭证，可额外设置 TENCENTCLOUD_TOKEN。
4. 安装 Python 依赖¶
Skill 要求 Python 3.7+，并依赖腾讯云 SDK：
pip install tencentcloud-sdk-python
典型用法¶
核心入口为 Skill 目录下的 scripts/main.py。将 <SKILL_DIR> 替换为安装后的实际路径（例如 ~/.cursor/skills/@tencent-adm/tencentcloud-aigc-recog-image）。
用图片 URL 检测：
python3 <SKILL_DIR>/scripts/main.py "https://example.com/image.jpg"
或显式指定 URL：
python3 <SKILL_DIR>/scripts/main.py --url "https://example.com/image.jpg"
用本地文件检测：
python3 <SKILL_DIR>/scripts/main.py /path/to/image.png
python3 <SKILL_DIR>/scripts/main.py --file /path/to/image.png
附带业务数据 ID（最长 128 字符）：
python3 <SKILL_DIR>/scripts/main.py --data-id "business_123" /path/to/image.png
成功时脚本输出 JSON，例如：
{
"suggestion": "Block",
"label": "GeneratedContentRisk",
"score": 95,
"sub_label": "AIImageGenerated",
"detail_results": [...],
"request_id": "..."
}
suggestion 可直接映射为业务动作：Pass 倾向真实图，Review 建议人工复审，Block 倾向 AI 生成。score 在 0–60、60–80、80–100 区间对应低、中、高风险档（以 Skill 文档为准）。
在 Agent 场景下，Skill 要求 必须以脚本/API 结果为准，不得在调用失败时由模型自行猜测结论。
适用场景与注意¶
适合谁
- 需要在 Agent 工作流里做 AIGC 图片抽检、投稿审核、素材入库前鉴别 的团队。
- 已使用或计划使用腾讯云图片内容安全、希望少写 SDK 胶水代码的开发者。
使用注意
- 密钥与 BizType 不要写进代码仓库；生产环境建议用环境变量或密钥管理服务。
- 单图 5MB、格式与配额限制需在上传链路提前校验。
- 检测结果用于辅助决策，
Review档仍建议保留人工复核。 - 企业来源 Skill，使用前请在 SkillHub 与腾讯云控制台确认计费与合规要求。
结尾¶
TencentCloud Image AIGC Detection 把腾讯云 AI 生成图片识别封装成可安装的 Agent Skill：配置密钥与 BizType 后，一条 python3 .../main.py 即可拿到结构化判定。官方 Skill 包地址：https://api.skillhub.cn/tencent-adm/tencentcloud-aigc-recog-image；社区介绍页：https://www.skillhub.cn/skills/tencent-adm/tencentcloud-aigc-recog-image。
