腾讯云媒体处理服务（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 路径参数方式 | 示例 | |------|----------------|------| | mps_transcode.py | --cos-object <key> | --cos-object input/video.mp4 | | mps_enhance.py | --cos-object <key> | --cos-object input/video.mp4 | | mps_erase.py | --cos-object <key> | --cos-object input/video.mp4 | | mps_subtitle.py | --cos-object <key> | --cos-object input/video.mp4 | | mps_imageprocess.py | --cos-object <key> | --cos-object input/image.jpg | | mps_qualitycontrol.py | --cos-object <key> | --cos-object input/video.mp4 | | mps_av_understand.py | --cos-object <key> | --cos-object input/video.mp4 | | mps_vremake.py | --cos-object <key> | --cos-object input/video.mp4 | | mps_narrate.py | --cos-object <key> | --cos-object input/video.mp4 | | mps_highlight.py | --cos-object <key> | --cos-object input/video.mp4 | | mps_aigc_image.py | --cos-input-bucket <b> --cos-input-region <r> --cos-input-key <k> | --cos-input-bucket xxx --cos-input-region ap-guangzhou --cos-input-key input/img.jpg | | mps_aigc_video.py | --cos-input-bucket <b> --cos-input-region <r> --cos-input-key <k> | --cos-input-bucket xxx --cos-input-region ap-guangzhou --cos-input-key input/img.jpg |

注意：使用 --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 格式返回给用户：文件名

异步任务说明

所有脚本默认自动轮询等待完成。 - 只提交不等待：加 --no-wait，脚本返回 TaskId - 手动查询：音视频用 mps_get_video_task.py，图片用 mps_get_image_task.py

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

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

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

用户需求类型	使用脚本	说明
检查画面质量、检测模糊/花屏	`mps_qualitycontrol.py`	唯一质检脚本，`--definition 60`（默认）
检测播放兼容性、卡顿、播放异常	`mps_qualitycontrol.py`	唯一质检脚本，`--definition 70`
音频质量检测、音频事件检测	`mps_qualitycontrol.py`	唯一质检脚本，`--definition 50`
去除字幕、擦除水印、人脸/车牌模糊	`mps_erase.py`	仅用于画面内容擦除/遮挡
画质增强、老片修复、超分辨率	`mps_enhance.py`	视频画质提升
转码、压缩、格式转换	`mps_transcode.py`	编码格式处理
字幕提取、翻译、字幕类语音识别	`mps_subtitle.py`	字幕相关
图片处理（超分/美颜/降噪）	`mps_imageprocess.py`	图片增强
AI 生图（文生图/图生图）	`mps_aigc_image.py`	AIGC 图片生成
AI 生视频（文生视频/图生视频）	`mps_aigc_video.py`	AIGC 视频生成
音视频内容理解（场景/摘要/分析/语音识别）	`mps_av_understand.py`	大模型理解，必须提供 `--mode` 和 `--prompt`
视频去重（画中画/视频扩展/换脸/换人等）	`mps_vremake.py`	VideoRemake，必须提供 `--mode`
用量统计查询	`mps_usage.py`	调用次数/时长查询
AI解说二创 / 短剧解说 / 自动生成短剧解说视频 / 短剧解说混剪	`mps_narrate.py`	必须从预设 `--scene` 中选择；不支持输入自定义脚本；多集视频按顺序通过 `--extra-urls` 追加
精彩集锦 / 高光提取 / 自动剪辑精彩片段 / 足球进球集锦 / 篮球集锦 / 短剧高光	`mps_highlight.py`	必须从预设 `--scene` 中选择，禁止自拼 ExtendedParameter；不支持直播流
查询音视频处理任务状态	`mps_get_video_task.py`	ProcessMedia 任务查询
查询图片处理任务状态	`mps_get_image_task.py`	ProcessImage 任务查询
上传本地文件到 COS	`mps_cos_upload.py`	本地→COS 前置步骤
从 COS 下载文件	`mps_cos_download.py`	COS→本地后置步骤
列出 COS Bucket 文件	`mps_cos_list.py`	查看 COS 文件列表，支持路径过滤和文件名搜索

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

生成命令的强制规则

禁止占位符：所有参数值必须是真实值。若用户未提供必需值，先询问，不得用 <视频URL>、YOUR_URL 等占位符。
mps_qualitycontrol.py 必须含 --definition：
音频质检：--definition 50
画面质检（默认）：--definition 60
播放兼容性：--definition 70
mps_av_understand.py 必须含 --mode 和 --prompt：
--mode video（理解视频画面）或 --mode audio（仅音频，视频自动提取音频）
--prompt 控制大模型理解侧重点，缺失时结果可能为空
mps_narrate.py 必须含 --scene：
值必须是预设枚举之一：short-drama | short-drama-no-erase
用户说"有字幕"/"带硬字幕"时默认选含擦除场景（short-drama）
用户说"没有字幕"/"原片无字幕"/"不擦除"时选 -no-erase 场景（short-drama-no-erase）
多集视频时，第一集用 --url/--cos-object，后续集用 --extra-urls 按顺序追加
禁止传入 scriptUrls 相关参数（本次不支持输入自定义脚本）
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），按场景+目标分辨率选择：

场景	720P	1080P	2K	4K
真人（Real）	327001	327003	327005	327007
漫剧（Anime）	327002	327004	327006	327008
抖动优化	327009	327010	327011	327012
细节最强	327013	327014	327015	327016
人脸保真	327017	327018	327019	327020

去字幕擦除 (`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 参考

脚本	文档
`mps_transcode.py` / `mps_enhance.py` / `mps_subtitle.py` / `mps_erase.py`	ProcessMedia
`mps_qualitycontrol.py`	ProcessMedia AiQualityControlTask
`mps_imageprocess.py`	ProcessImage
`mps_av_understand.py`	VideoComprehension AiAnalysisTask
`mps_vremake.py`	VideoRemake AiAnalysisTask
`mps_narrate.py`	ProcessMedia AiAnalysisTask
`mps_highlight.py`	ProcessMedia AiAnalysisTask
`mps_aigc_image.py`	CreateAigcImageTask
`mps_aigc_video.py`	CreateAigcVideoTask
`mps_usage.py`	DescribeUsageData
`mps_get_video_task.py`	DescribeTaskDetail
`mps_get_image_task.py`	DescribeImageTaskDetail

tencent-mps

Installation

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

环境配置

本地文件处理流程

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

输入方式说明

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

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

手动处理示例

异步任务说明

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

生成命令的强制规则

关键脚本说明

视频增强 (`mps_enhance.py`)

去字幕擦除 (`mps_erase.py`)

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

媒体质检 (`mps_qualitycontrol.py`)

视频去重 (`mps_vremake.py`)

AI 解说二创 (`mps_narrate.py`)

精彩集锦 (`mps_highlight.py`)

用量统计 (`mps_usage.py`)

API 参考

tencent-mps

Installation

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

环境配置

本地文件处理流程

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

输入方式说明

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

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

手动处理示例

异步任务说明

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

生成命令的强制规则

关键脚本说明

视频增强 (mps_enhance.py)

去字幕擦除 (mps_erase.py)

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

媒体质检 (mps_qualitycontrol.py)

视频去重 (mps_vremake.py)

AI 解说二创 (mps_narrate.py)

精彩集锦 (mps_highlight.py)

用量统计 (mps_usage.py)

API 参考

视频增强 (`mps_enhance.py`)

去字幕擦除 (`mps_erase.py`)

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

媒体质检 (`mps_qualitycontrol.py`)

视频去重 (`mps_vremake.py`)

AI 解说二创 (`mps_narrate.py`)

精彩集锦 (`mps_highlight.py`)

用量统计 (`mps_usage.py`)