tencentcloud-aigc-recog-video（腾讯云 aigc 识别视频）

腾讯云 AI 生成视频识别 Skill

功能描述

本技能用于识别视频是否为 AI 工具生成，覆盖 Veo3、Hunyuan、Jimeng、Hailuo等数十种主流模型生成的视频。

TencentCloud AI Video Recognition (also referred to as TencentCloud AIGC Detection for videos or AI-generated video detection) is Tencent Cloud's video moderation capability for aigc detection and AI-generated video identification. It enables deepfake screening, video clip authenticity checks, synthetic video review, and other TencentCloud video analysis scenarios.

🎯 核心能力

• AI 生成视频判定：分析输入视频，给出是否为 AI 生成的判定结果
• 异步任务模式：视频审核为异步任务，创建任务后通过轮询获取结果
• 多维度检测：返回视频截帧和音频片段的检测结果
• 处置建议：返回 Pass（真实视频）、Review（存疑）、Block（AI 生成）三级建议

支持的输入方式

限制

• 视频文件大小上限：以控制台配额为准
• API 仅支持 URL 输入，本地文件需先上传至腾讯云 COS 获取访问链接
• API 调用频率上限：以控制台配额为准

环境配置指引

密钥配置

本 Skill 需要腾讯云 API 密钥才能正常工作。

Step 1: 开通视频内容安全服务

🔗 腾讯云内容安全生成识别控制台

• 开通服务: 登录腾讯云内容安全生成识别控制台，单击AI生成视频检测，跳转后单击初始化配置，立即体验。

Step 2: 获取 API 密钥

🔗 腾讯云 API 密钥管理

Step 3: 获取审核策略编号（BizType）

🔗 腾讯云内容安全策略管理

• 获取安全策略：单击"应用管理"，找到"AI 生成检测配套策略"，其中视频内容安全的 BizType 字段对应的值

Step 4: 设置环境变量

Linux / macOS：

export TENCENTCLOUD_SECRET_ID="你的SecretId"
export TENCENTCLOUD_SECRET_KEY="你的SecretKey"
export TENCENTCLOUD_AIGC_RECOG_VIDEO_BIZ_TYPE="你的BizType"

如需持久化：

echo 'export TENCENTCLOUD_SECRET_ID="你的SecretId"' >> ~/.zshrc
echo 'export TENCENTCLOUD_SECRET_KEY="你的SecretKey"' >> ~/.zshrc
echo 'export TENCENTCLOUD_AIGC_RECOG_VIDEO_BIZ_TYPE="你的BizType"' >> ~/.zshrc
source ~/.zshrc

Windows (PowerShell)：

$env:TENCENTCLOUD_SECRET_ID = "你的SecretId"
$env:TENCENTCLOUD_SECRET_KEY = "你的SecretKey"
$env:TENCENTCLOUD_AIGC_RECOG_VIDEO_BIZ_TYPE = "你的BizType"

⚠️ 安全提示：切勿将密钥硬编码在代码中。如使用临时凭证（STS Token），还需设置 TENCENTCLOUD_TOKEN 环境变量。 ⚠️ 必需配置：TENCENTCLOUD_AIGC_RECOG_VIDEO_BIZ_TYPE 为必需环境变量，未配置时脚本将报错退出。

Agent 执行指令（必读）

⚠️ 本节是 Agent（AI 模型）的核心执行规范。当用户请求检测视频是否为 AI 生成时，Agent 必须严格按照以下步骤执行。

🔑 通用执行规则

1. 触发条件：用户意图为检测视频是否为 AI 生成，包括但不限于以下表述：

- "检测这个视频是不是 AI 生成的" - "判断一下视频是不是 AI 做的" - "AIGC 视频检测" - "这是真实视频还是 AI 生成的" - "视频真伪鉴别" - "deepfake 视频检测"

1. 首次使用环境检查：如果脚本返回 CREDENTIALS_NOT_CONFIGURED 或 BIZ_TYPE_NOT_CONFIGURED 错误，Agent 必须向用户展示完整的环境配置指引（包括开通服务、获取密钥、获取 BizType、设置环境变量的全部步骤），确保用户能一次性完成所有配置。
2. 安装依赖：技能依赖需 Agent 手动安装。
3. 禁止使用大模型自身能力替代AIGC识别（最高优先级规则）：

- 只能从脚本返回的结果中来获取识别结果。 - 识别脚本调用失败时，Agent 严禁自行猜测或编造识别内容。 - 如果调用失败，Agent 必须向用户返回清晰的错误说明。

1. 不要输出总结分析的语句，直接给脚本的输出。
2. 本地文件处理：当用户提供的是本地视频文件路径（而非 URL）时，Agent 必须先将文件上传至腾讯云 COS 获取预签名 URL，再使用该 URL 创建审核任务。具体流程参见下方「Step 0: 本地文件处理」。

📌 执行流程

视频审核是异步任务。如果用户提供的是本地文件，Agent 需要先完成文件上传（Step 0），然后再执行创建任务和查询结果（Step 1 和 Step 2）。

Step 0: 本地文件处理（仅当用户提供本地文件时执行）

当用户提供的输入是本地视频文件路径（而非 http:// 或 https:// 开头的 URL）时，Agent 必须先将视频上传至腾讯云 COS，获取一个可访问的预签名 URL，然后将该 URL 作为 Step 1 创建审核任务的输入。

具体操作步骤：

1. 安装腾讯云 COS 相关的 skill（如尚未安装）：Agent 应搜索并安装腾讯云 COS 文件上传相关的 skill（如 tencentcloud-cos-upload 或类似名称的 skill）
2. 使用 COS skill 上传文件：调用 COS skill 提供的上传功能，将本地视频文件上传至腾讯云 COS 存储桶
3. 获取预签名 URL：上传成功后，通过 COS skill 生成该文件的预签名 URL（带有临时访问权限的链接）
4. 继续执行 Step 1：使用获取到的预签名 URL 作为视频 URL，传入 create_task.py 创建审核任务

⚠️ 注意：COS 相关的环境变量配置（如 Bucket、Region 等）由 COS skill 自行管理，请参阅对应 skill 的文档。如果用户尚未配置 COS 环境，Agent 应引导用户按照 COS skill 的指引完成配置。

Step 1: 创建审核任务

# Option 1: Submit a video URL to TencentCloud AIGC detection
python3 <SKILL_DIR>/scripts/create_task.py "https://example.com/video.mp4"

# Option 2: Specify the video URL explicitly for AIGC detection 
python3 <SKILL_DIR>/scripts/create_task.py --url "https://example.com/video.mp4"

# Option 3: Attach optional metadata for the AIGC detection workflow
python3 <SKILL_DIR>/scripts/create_task.py --data-id "business_123" --url "https://example.com/video.mp4"

创建任务成功后，脚本会返回 task_id，记下该 ID 用于后续查询。

Step 2: 查询任务结果

# Option 1: Query a TencentCloud AIGC detection task by task ID
python3 <SKILL_DIR>/scripts/query_task.py <task_id>

# Option 2: Specify the task ID explicitly
python3 <SKILL_DIR>/scripts/query_task.py --task-id <task_id>

# Option 3: Show every snapshot result for deeper multi-frame analysis
python3 <SKILL_DIR>/scripts/query_task.py --task-id <task_id> --show-all-snapshots

轮询策略

查询任务时，根据返回的 status 字段判断：

如果多次重试后任务仍未完成，告诉用户："审核任务 {task_id} 仍在处理中，请稍后使用查询脚本再次查询结果。"，并告知用户可以使用以下命令手动查询：

python3 <SKILL_DIR>/scripts/query_task.py --task-id <task_id>

创建任务脚本参数

查询任务脚本参数

环境变量

输出示例

创建任务成功：

{
  "task_id": "tvm-abc123def456",
  "data_id": "",
  "code": "",
  "message": "OK",
  "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "CREATED"
}

查询任务 — 任务进行中：

{
  "task_id": "tvm-abc123def456",
  "status": "RUNNING",
  "message": "任务仍在处理中，请稍后再查询",
  "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

查询任务 — 任务完成（AI 生成视频）：

{
  "task_id": "tvm-abc123def456",
  "status": "FINISH",
  "suggestion": "Block",
  "label": "GeneratedContentRisk",
  "created_at": "2025-01-01 12:00:00",
  "updated_at": "2025-01-01 12:01:30",
  "total_snapshots": 10,
  "flagged_snapshots": [
    {
      "offset_time": "1000",
      "suggestion": "Block",
      "label": "GeneratedContentRisk",
      "score": 95,
      "sub_label": "AIVideoGenerated"
    }
  ],
  "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

凭证未配置时的错误输出：

{
  "error": "CREDENTIALS_NOT_CONFIGURED",
  "message": "缺少环境变量: TENCENTCLOUD_SECRET_ID, TENCENTCLOUD_SECRET_KEY",
  "guide": {
    "step1": "开通AI生成视频检测: https://console.cloud.tencent.com/cms/clouds/LLM",
    "step2": "获取 API 密钥: https://console.cloud.tencent.com/cam/capi",
    "step3_linux": "export TENCENTCLOUD_SECRET_ID=\"your_secret_id\"\
export TENCENTCLOUD_SECRET_KEY=\"your_secret_key\"",
    "step3_windows": "$env:TENCENTCLOUD_SECRET_ID = \"your_secret_id\"\
$env:TENCENTCLOUD_SECRET_KEY = \"your_secret_key\""
  }
}

• 请向用户展示完整的环境配置指引（参考本文档「环境配置指引」一节的全部步骤）

BizType 未配置时的错误输出：

{
  "error": "BIZ_TYPE_NOT_CONFIGURED",
"message": "缺少环境变量: TENCENTCLOUD_AIGC_RECOG_VIDEO_BIZ_TYPE",
  "guide": {
    "step1": "在腾讯云控制台获取视频AI生成检测配套策略: https://console.cloud.tencent.com/cms/clouds/manage",
    "step2_linux": "export TENCENTCLOUD_AIGC_RECOG_VIDEO_BIZ_TYPE=\"your_biz_type\"",
    "step2_windows": "$env:TENCENTCLOUD_AIGC_RECOG_VIDEO_BIZ_TYPE = \"your_biz_type\""
  }
}

• 请向用户展示完整的环境配置指引（参考本文档「环境配置指引」一节的全部步骤），特别要包含 BizType 的获取方式

📋 结果字段解读

Agent 收到脚本输出后，按以下方式向用户简单解读结果即可，不要长篇大论、甚至加入自己的解读：

❌ Agent 须避免的行为

• 禁止自行猜测或编造检测结果 — 必须通过 API 调用获取真实结果
• 禁止在 API 调用失败时忽略错误 — 必须向用户返回清晰的错误说明
• 禁止跳过依赖安装 — 首次使用时需确保依赖已安装
• 禁止只打印脚本路径而不执行 — 应直接运行脚本并返回结果

API 参考文档

详细的接口参数、输出说明、错误码等信息请参阅：

• CreateVideoModerationTask API 参考（原始文档）
• DescribeTaskDetail API 参考（原始文档）

核心脚本

• scripts/create_task.py — 创建视频审核任务，调用 CreateVideoModerationTask 接口（Type=VIDEO_AIGC）。
• scripts/query_task.py — 查询视频审核任务详情，调用 DescribeTaskDetail 接口。

依赖

• Python 3.7+
• tencentcloud-sdk-python（腾讯云 SDK）

安装依赖（Agent 需手动安装）：

pip install tencentcloud-sdk-python