前言¶
內容審覈、風控和運營側經常要判斷一張圖是實拍還是 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。
