tencent-mps

腾讯云媒体处理服务（MPS）

💰 费用提示：本 Skill 调用腾讯云 MPS 服务会产生相应费用，包括转码费、AI 处理费、存储费等。具体计费标准请参考 腾讯云 MPS 定价。每次使用MPS的媒体处理/图片处理/生图/生视频功能，一定要给出提示。

通过腾讯云官方 Python SDK 调用 MPS API，所有脚本位于 scripts/ 目录，均支持 --help 和 --dry-run。

详细参数：见 references/params.md 完整示例集：见 references/scripts-detail.md

环境配置

检查环境变量：

python scripts/load_env.py --check-only

配置（~/.profile 或 ~/.bashrc）：

# 必须（所有脚本）
export TENCENTCLOUD_SECRET_ID="your-secret-id"
export TENCENTCLOUD_SECRET_KEY="your-secret-key"

# 以下场景必须配置 COS 变量：
#   1. 输入源为 --cos-object（即 COS 对象路径，非 URL）
#   2. 使用 mps_cos_upload.py / mps_cos_download.py 上传/下载本地文件
#   3. 脚本需要将处理结果写回 COS（OutputStorage）
export TENCENTCLOUD_COS_BUCKET="your-bucket"        # COS 存储桶名
export TENCENTCLOUD_COS_REGION="your-bucket-region" # 存储桶地域，如 ap-guangzhou

安装依赖：

pip install tencentcloud-sdk-python cos-python-sdk-v5

本地文件处理流程

MPS 只接受 URL 或 COS 对象作为输入，本地文件必须先上传。

用户输入本地文件时的自动处理流程

当用户请求涉及本地文件路径（如 ./video.mp4、/path/to/image.jpg）时，按以下步骤自动处理：

步骤 1：上传文件到 COS

python scripts/mps_cos_upload.py --local-file <本地文件路径> --cos-key <目标路径>

• 使用 --cos-key 指定合理的存储路径（默认路径 input/）
• 记录上传返回的 COS 信息：bucket、region、key

步骤 2：使用 COS 路径参数执行脚本 根据脚本类型，使用各个脚本中 传递 COS 路径的方式，如下：

注意：使用 --cos-object 的脚本依赖环境变量 TENCENTCLOUD_COS_BUCKET 和 TENCENTCLOUD_COS_REGION；AIGC 类脚本需要显式传递完整的 COS 信息。

步骤 3：下载处理结果（如需要）

python scripts/mps_cos_download.py --cos-key <输出key> --local-file <本地保存路径>

输入方式说明

根据输入来源不同，支持两种方式：

方式一：COS 路径方式（推荐用于本地上传文件）

使用 --cos-object <key> 参数（或 --cos-input-bucket/--cos-input-region/--cos-input-key）

• 适用场景：用户上传本地文件到 COS 后处理
• 原因：本地上传的文件可能没有公开读取权限，直接使用 URL 可能会失败
• 示例：--cos-object input/video.mp4

方式二：URL 方式（适用于已有 URL）

使用 --url <url> 参数

• 适用场景：用户直接提供文件 URL（包括其他账号/来源的 COS URL、外部链接等）
• 要求：URL 必须可公开访问或已携带有效签名
• 示例：--url https://example-bucket.cos.ap-guangzhou.myqcloud.com/video.mp4

⚠️ 注意：如果 URL 来自本地上传的 COS 文件且没有公开权限，请使用方式一（COS 路径方式），脚本会自动生成带签名的 URL。

手动处理示例

如需手动执行，完整流程如下：

# 1. 上传
python scripts/mps_cos_upload.py --local-file ./video.mp4 --cos-key input/video.mp4
# 2. 执行任务（使用 COS 路径）
python scripts/mps_transcode.py --cos-object input/video.mp4
# 3. 下载结果
python scripts/mps_cos_download.py --cos-key output/result.mp4 --local-file ./result.mp4

返回结果含链接时，用 Markdown 格式返回给用户：[文件名](URL)

异步任务说明

所有脚本默认自动轮询等待完成。

• 只提交不等待：加 --no-wait，脚本返回 TaskId
• 手动查询：音视频用 mps_get_video_task.py，图片用 mps_get_image_task.py

脚本功能映射（职责边界）

💰 以下操作将调用腾讯云 MPS 服务并产生费用。

选择脚本时必须严格按照映射关系，不得混用：

重要：mps_erase.py 职责是擦除/遮挡画面视觉元素，不涉及质量检测。 "画质检测"、"模糊"、"花屏"、"播放兼容性"、"音频质检" → 必须用 mps_qualitycontrol.py。

生成命令的强制规则

1. 脚本路径前缀：所有生成的 python 命令必须包含 scripts/ 路径前缀，格式为 python scripts/mps_xxx.py ...。禁止生成 python mps_xxx.py ...（缺少 scripts/ 前缀）的命令。

2. 禁止占位符：所有参数值必须是真实值。若用户未提供必需值，先询问，不得用 <视频URL>、YOUR_URL 等占位符。

3. mps_qualitycontrol.py 必须含 --definition：

   • 音频质检：--definition 50
   • 画面质检（默认）：--definition 60
   • 播放兼容性：--definition 70

4. mps_av_understand.py 必须含 --mode 和 --prompt：

   • --mode video（理解视频画面）或 --mode audio（仅音频，视频自动提取音频）
   • --prompt 控制大模型理解侧重点，缺失时结果可能为空

5. mps_narrate.py 必须含 --scene：

   • 值必须是预设枚举之一：short-drama | short-drama-no-erase
   • 用户说"有字幕"/"带硬字幕"时默认选含擦除场景（short-drama）
   • 用户说"没有字幕"/"原片无字幕"/"不擦除"时选 -no-erase 场景（short-drama-no-erase）
   • 多集视频时，第一集用 --url/--cos-object，后续集用 --extra-urls 按顺序追加
   • 禁止传入 scriptUrls 相关参数（本次不支持输入自定义脚本）

6. mps_highlight.py 必须含 --scene：

   • 值必须是预设枚举之一：vlog | vlog-panorama | short-drama | football | basketball | custom
   • 用户提到"篮球"/"足球"/"短剧"/"VLOG"等关键词时直接映射到对应 --scene，无需二次询问
   • --prompt 和 --scenario 仅在 --scene custom 时生效，但二者非必填
   • --top-clip 仅允许在 vlog / vlog-panorama / custom 场景下使用
   • 禁止生成预设表以外的 ExtendedParameter 字段或值
   • 用户请求处理直播流集锦时，告知当前 skill 不支持直播流，需使用 MPS API 直接调用

关键脚本说明

视频增强 (mps_enhance.py)

大模型增强模板（--template），按场景+目标分辨率选择：

去字幕擦除 (mps_erase.py)

预设模板：101 去字幕 | 102 去字幕+OCR | 201 去水印高级版 | 301 人脸模糊 | 302 人脸+车牌模糊

大模型音视频理解 (mps_av_understand.py)

通过 AiAnalysisTask.Definition=33 + ExtendedParameter(mvc.mode + mvc.prompt) 控制。

# 视频内容理解
python scripts/mps_av_understand.py \
    --url https://example.com/video.mp4 \
    --mode video \
    --prompt "请分析这个视频的主要内容、场景和关键信息"

# 音频模式（视频自动提取音频）
python scripts/mps_av_understand.py \
    --url https://example.com/video.mp4 \
    --mode audio \
    --prompt "请进行语音识别，输出完整文字内容"

# 对比分析（两段音视频）
python scripts/mps_av_understand.py \
    --url https://example.com/v1.mp4 \
    --extend-url https://example.com/v2.mp4 \
    --mode audio \
    --prompt "对比两段音频，分析差异"

# 查询任务
python scripts/mps_av_understand.py --task-id 2600011633-WorkflowTask-xxxxx --json

媒体质检 (mps_qualitycontrol.py)

脚本支持以下 3 种系统预设模板（--definition 参数）：

预设模板：

• 60（默认）：格式质检-Pro版，检测画面模糊、花屏、画面受损等内容问题
• 50：Audio Detection，音频质量/音频事件检测
• 70：内容质检-Pro版，检测播放卡顿、播放异常、播放兼容性问题

# 画面质检（默认，使用预设模板 60）
python scripts/mps_qualitycontrol.py --url https://example.com/video.mp4 --definition 60

# 播放兼容性质检（预设模板 70）
python scripts/mps_qualitycontrol.py --url https://example.com/video.mp4 --definition 70

# 音频质检（预设模板 50）
python scripts/mps_qualitycontrol.py --url https://example.com/audio.mp3 --definition 50

# 异步提交
python scripts/mps_qualitycontrol.py --url https://example.com/video.mp4 --definition 60 --no-wait

视频去重 (mps_vremake.py)

# 画中画去重（等待结果）
python scripts/mps_vremake.py --url https://example.com/video.mp4 --mode PicInPic --wait

# 视频扩展去重
python scripts/mps_vremake.py --url https://example.com/video.mp4 --mode BackgroundExtend --wait

# 换脸模式
python scripts/mps_vremake.py --url https://example.com/video.mp4 --mode SwapFace \
    --src-faces https://example.com/src.png --dst-faces https://example.com/dst.png --wait

# 换人模式
python scripts/mps_vremake.py --url https://example.com/video.mp4 --mode SwapCharacter \
    --src-character https://example.com/src_full.png \
    --dst-character https://example.com/dst_full.png --wait

# 画中画 + LLM 提示词
python scripts/mps_vremake.py --url https://example.com/video.mp4 --mode PicInPic \
    --llm-prompt "生成一个唯美的自然风景背景图片" --wait

# 异步提交（默认，不加 --wait）
python scripts/mps_vremake.py --url https://example.com/video.mp4 --mode PicInPic

# 查询任务
python scripts/mps_vremake.py --task-id 2600011633-WorkflowTask-xxxxx --json

去重模式：PicInPic（画中画）BackgroundExtend（视频扩展）VerticalExtend（垂直填充）HorizontalExtend（水平填充）AB（视频交错）SwapFace（换脸）SwapCharacter（换人）
主要参数：--url / --cos-object / --task-id / --mode（必填）/ --wait / --llm-prompt / --llm-video-prompt / --src-faces+--dst-faces（换脸）/ --src-character+--dst-character（换人）/ --json / --dry-run

AI 解说二创 (mps_narrate.py)

输入原始视频，一站式自动完成解说脚本生成、脚本匹配成片、AI 配音、去字幕等操作，输出带有解说文案、配音和字幕的新视频。

# 短剧单集解说（默认含擦除，输出1个视频）
python scripts/mps_narrate.py --url https://example.com/drama.mp4 --scene short-drama

# COS对象输入
python scripts/mps_narrate.py --cos-object /input/drama.mp4 --scene short-drama

# 原视频无字幕，关闭擦除
python scripts/mps_narrate.py --url https://example.com/drama.mp4 --scene short-drama-no-erase

# 短剧三集合并解说，输出3个不同版本
python scripts/mps_narrate.py \
    --url https://example.com/ep01.mp4 \
    --extra-urls https://example.com/ep02.mp4 https://example.com/ep03.mp4 \
    --scene short-drama \
    --output-count 3

# Dry Run（预览转义后的 ExtendedParameter）
python scripts/mps_narrate.py --url https://example.com/drama.mp4 --scene short-drama --dry-run

预设场景：short-drama（短剧，含擦除） | short-drama-no-erase（短剧，无擦除）
主要参数：--url / --cos-object（第一集，必填） / --scene（必填） / --extra-urls（第2集起） / --output-count（输出数量，默认1，最大5） / --no-wait / --dry-run

精彩集锦 (mps_highlight.py)

使用 MPS 智能分析功能，通过 AI 算法自动捕捉并生成视频中的精彩片段（高光集锦）。固定使用 26 号预设模板，支持 VLOG、短剧、足球赛事、篮球赛事等多种场景。

# 足球赛事精彩集锦
python scripts/mps_highlight.py --cos-object /input/football.mp4 --scene football

# 短剧影视高光
python scripts/mps_highlight.py --cos-object /input/drama.mp4 --scene short-drama

# VLOG 全景相机
python scripts/mps_highlight.py --url https://example.com/vlog.mp4 --scene vlog-panorama

# 自定义场景（大模型版）
python scripts/mps_highlight.py --url https://example.com/skiing.mp4 \
    --scene custom --prompt "滑雪场景，输出人物高光" --scenario "滑雪"

# 篮球赛事
python scripts/mps_highlight.py --cos-object /input/basketball.mp4 --scene basketball

# 指定输出片段数（仅 vlog/vlog-panorama/custom 支持）
python scripts/mps_highlight.py --cos-object /input/vlog.mp4 --scene vlog --top-clip 10

# Dry Run（仅打印请求参数）
python scripts/mps_highlight.py --cos-object /input/game.mp4 --scene football --dry-run

预设场景：

• vlog：VLOG、风景、无人机视频（大模型版）
• vlog-panorama：全景相机（开启全景优化，大模型版）
• short-drama：短剧、影视剧，提取主角出场/BGM高光（大模型版）
• football：足球赛事，识别射门/进球/红黄牌/回放（高级版）
• basketball：篮球赛事（高级版）
• custom：自定义场景，可传 --prompt 和 --scenario（大模型版）

主要参数：--url / --cos-object（必填） / --scene（必填） / --prompt（custom场景） / --scenario（custom场景） / --top-clip（vlog/vlog-panorama/custom场景可用） / --no-wait / --dry-run

⚠️ 重要限制：

• 本脚本仅支持处理离线文件，不支持直播流
• --top-clip 仅允许在 vlog / vlog-panorama / custom 场景下使用
• --prompt 和 --scenario 仅在 --scene custom 时生效，但二者非必填
• ExtendedParameter 必须从预设场景参数中选择，禁止自行拼装

用量统计 (mps_usage.py)

python scripts/mps_usage.py --days 30 --all-types
python scripts/mps_usage.py --start 2026-01-01 --end 2026-01-31
python scripts/mps_usage.py --type Transcode Enhance AIGC AIAnalysis

--type 支持：Transcode Enhance AIAnalysis AIRecognition AIReview Snapshot AnimatedGraphics AiQualityControl Evaluation ImageProcess AddBlindWatermark AddNagraWatermark ExtractBlindWatermark AIGC

API 参考