腾讯云媒体处理服务（MPS）技能说明用于通过腾讯云官方 Python SDK 调用 MPS API，完成音视频与图片的处理、生成、增强、内容理解、质检和用量查询。文中说明调用该服务会产生转码费、AI 处理费、存储费等，具体计费标准参考腾讯云 MPS 定价；每次使用媒体处理、图片处理、生图或生视频功能时，都需要给出费用提示。
【环境与依赖】 使用前检查环境变量：python scripts/load_env.py --check-only。所有脚本必须配置 TENCENTCLOUD_SECRET_ID 和 TENCENTCLOUD_SECRET_KEY。当输入源为 --cos-object、使用 mps_cos_upload.py 或 mps_cos_download.py 上传下载本地文件，或者需要将结果写回 COS（OutputStorage）时，必须配置 TENCENTCLOUD_COS_BUCKET 和 TENCENTCLOUD_COS_REGION。依赖安装命令为：pip install tencentcloud-sdk-python cos-python-sdk-v5。脚本均位于 scripts/ 目录，支持 --help 和 --dry-run。
【输入方式与本地文件流程】 MPS 只接受 URL 或 COS 对象作为输入，本地文件必须先上传。当用户请求涉及本地文件路径时，推荐流程为：先用 python scripts/mps_cos_upload.py --local-file <本地文件路径> --cos-key <目标路径> 上传（默认路径 input/），记录返回的 bucket、region、key；再用脚本的 --cos-object <key> 参数执行任务（AIGC 类脚本需显式传 --cos-input-bucket/--cos-input-region/--cos-input-key）；最后如需本地结果，用 python scripts/mps_cos_download.py --cos-key <输出key> --local-file <本地保存路径> 下载。若已有可公开访问或带有效签名的 URL，可直接使用 --url 参数。对于本地上传后无公开权限的 COS 文件，应使用 COS 路径方式，脚本会自动生成带签名的 URL。返回结果含链接时，用 Markdown 格式返回给用户。
【异步任务】 所有脚本默认自动轮询等待完成；加 --no-wait 则只提交并返回 TaskId。手动查询时，音视频任务用 mps_get_video_task.py，图片任务用 mps_get_image_task.py。
【功能与脚本映射】 转码、压缩、格式转换用 mps_transcode.py；视频画质增强、老片修复、超分用 mps_enhance.py；字幕提取、翻译、字幕类语音识别用 mps_subtitle.py；去字幕、擦除水印、人脸或车牌模糊用 mps_erase.py；图片超分、美颜、降噪用 mps_imageprocess.py；AI 生图（文生图、图生图）用 mps_aigc_image.py；AI 生视频（文生视频、图生视频、分镜生成）用 mps_aigc_video.py；音视频内容理解（场景、摘要、分析、语音识别）用 mps_av_understand.py；视频去重用 mps_vremake.py；AI 解说二创、短剧解说用 mps_narrate.py；精彩集锦、高光提取用 mps_highlight.py；媒体质检用 mps_qualitycontrol.py；用量统计用 mps_usage.py；COS 文件列表用 mps_cos_list.py。文档强调画质检测、模糊花屏、播放兼容性、音频质检必须用 mps_qualitycontrol.py，mps_erase.py 仅负责画面内容擦除或遮挡。
【关键脚本参数要点】 mps_qualitycontrol.py 必须含 --definition：音频质检 50、画面质检默认 60、播放兼容性 70。mps_av_understand.py 必须含 --mode（video 或 audio）和 --prompt，否则结果可能为空，支持 --extend-url 对比分析。mps_enhance.py 使用大模型增强模板 --template，按真人、漫剧、抖动优化、细节最强、人脸保真等场景及 720P 至 4K 分辨率选择模板编号。mps_erase.py 预设模板：101 去字幕、102 去字幕+OCR、201 去水印高级版、301 人脸模糊、302 人脸+车牌模糊。
mps_vremake.py 的 --mode 必填，支持 PicInPic（画中画）、BackgroundExtend（视频扩展）、VerticalExtend（垂直填充）、HorizontalExtend（水平填充）、AB（视频交错）、SwapFace（换脸）、SwapCharacter（换人）；换脸需 --src-faces 与 --dst-faces，换人需 --src-character 与 --dst-character，另支持 --llm-prompt、--llm-video-prompt。
mps_narrate.py 必须从预设 --scene 中选择：short-drama（含擦除）或 short-drama-no-erase；有硬字幕时默认选 short-drama，无字幕选 no-erase；多集视频第一集用 --url/--cos-object，后续集用 --extra-urls 按顺序追加；--output-count 默认 1、最大 5；不支持自定义脚本，禁止传 scriptUrls 相关参数。
mps_highlight.py 固定使用 26 号预设模板，--scene 必须是 vlog、vlog-panorama、short-drama、football、basketball、custom 之一；--prompt 和 --scenario 仅在 custom 场景生效且非必填；--top-clip 仅在 vlog/vlog-panorama/custom 场景可用；不支持直播流，禁止自行拼装 ExtendedParameter。
mps_usage.py 支持 --days 30 --all-types、--start/--end 日期区间以及 --type 指定类型；类型包括 Transcode、Enhance、AIAnalysis、AIRecognition、AIReview、Snapshot、AnimatedGraphics、AiQualityControl、Evaluation、ImageProcess、AddBlindWatermark、AddNagraWatermark、ExtractBlindWatermark、AIGC 等。
【命令生成规则】 生成的 python 命令必须带 scripts/ 路径前缀，格式为 python scripts/mps_xxx.py ...；所有参数值必须是真实值，用户未提供必需值时先询问，不得使用占位符。详细参数见 references/params.md，完整示例集见 references/scripts-detail.md。
【适用场景与限制】 适用于音视频转码压缩、画质增强修复、字幕处理、画面擦除与隐私遮挡、图片增强、AIGC 生图生视频、内容理解与语音识别、视频去重、短剧解说二创、赛事或 VLOG 高光集锦、媒体质检和用量查询。限制包括：MPS 仅接受 URL 或 COS 对象输入，本地文件需先上传；精彩集锦不支持直播流，需改用 MPS API 直接调用；解说二创不支持自定义脚本；质检脚本需按模板编号指定检测类型；部分模板与场景参数必须从预设中选择，不得自行拼装。