腾讯云媒体处理服务 MPS。当用户需要对音视频或图片进行处理时触发，包括：视频转码/压缩/格式转换、视频画质增强/老片修复、提取或翻译视频字幕、去除视频字幕或水印、图片超分/美颜/水印处理、AI生成图片（文生图/图生图）、AI生成视频（文生视频/图生视频）。支持极速高清转码、视频增强（大模型/综合/去毛刺）、智能...
通过腾讯云官方 Python SDK（tencentcloud-sdk-python）调用 MPS API，实现音视频转码、视频增强、智能字幕、智能去字幕与擦除、图片处理、AIGC 智能生图、AIGC 智能生视频等全面的媒体处理能力。
如果环境变量没有配置，请用户自行在以下任一文件中配置环境变量（选择其中一个文件即可）：
/etc/environment/etc/profile~/.bashrc~/.profile~/.bash_profile~/.env配置示例（添加到 ~/.profile）：
export TENCENTCLOUD_SECRET_ID="您的 SecretId"
export TENCENTCLOUD_SECRET_KEY="您的 SecretKey"
export TENCENTCLOUD_COS_BUCKET="您的 Bucket 名称"
export TENCENTCLOUD_COS_REGION="您的COS Bucket 区域，默认ap-guangzhou"
配置完成后，重新发起对话即可自动加载。
安装依赖：
pip install tencentcloud-sdk-python
所有脚本位于 scripts/ 目录下，均支持 --help 查看完整参数、--dry-run 模式仅打印请求参数不实际调用。
⏳ 异步任务说明：音视频处理类脚本（转码、增强、字幕、擦除）和图片处理脚本均为异步接口，提交后在后台执行。 脚本默认会自动轮询等待，直到任务完成后打印结果，无需 Agent 手动启动查询。
- 如果只想提交不等待，加
--no-wait参数，脚本会打印 TaskId 后立即退出- 需要手动查询时：音视频任务用
mps_get_video_task.py，图片任务用mps_get_image_task.py- 默认轮询间隔：音视频 10 秒，图片 5 秒；可通过
--poll-interval和--max-wait调整
scripts/mps_transcode.py在保证画质的基础上最大限度压缩码率和文件大小，节约带宽与存储成本。默认使用 100305 预设模板（极速高清-H265-MP4-1080P）。
适用场景：视频转码压缩、格式转换、分辨率/码率调整、HLS 切片。
# 最简用法：URL 输入 + 默认模板
python scripts/mps_transcode.py --url https://example.com/video.mp4
# 自定义：H265 + 1080P + 3000kbps
python scripts/mps_transcode.py --url https://example.com/video.mp4 \
--codec h265 --width 1920 --height 1080 --bitrate 3000
scripts/mps_enhance.py支持大模型增强、综合增强、去毛刺三种预设模式，以及超分、降噪、色彩增强、HDR、插帧、音频增强等丰富能力。音频分离支持提取人声、背景声、伴奏三种模式。
适用场景：老片修复、画质提升、低光照增强、游戏视频优化、人声/伴奏提取。
# 默认增强
python scripts/mps_enhance.py --url https://example.com/video.mp4
# 大模型增强（效果最强）
python scripts/mps_enhance.py --url https://example.com/video.mp4 --preset diffusion --diffusion-type strong
# 超分 + 降噪 + 色彩增强（注意：--super-resolution 和 --denoise 不可与 --preset diffusion 同时使用）
python scripts/mps_enhance.py --url https://example.com/video.mp4 --super-resolution --denoise --color-enhance
# 音频分离：提取人声
python scripts/mps_enhance.py --url https://example.com/video.mp4 --audio-separate vocal
# 音频分离：提取伴奏
python scripts/mps_enhance.py --url https://example.com/video.mp4 --audio-separate accompaniment
scripts/mps_subtitle.py基于 ASR 语音识别、OCR 文字识别提取字幕，支持大模型翻译为 30+ 种语言。
适用场景：视频译制、短剧出海、字幕提取、多语言翻译。
# ASR 识别字幕（默认）
python scripts/mps_subtitle.py --url https://example.com/video.mp4
# ASR + 翻译为英文（双语字幕）
python scripts/mps_subtitle.py --url https://example.com/video.mp4 --src-lang zh --translate en
scripts/mps_erase.py自动识别视频中的文字内容并进行无痕擦除，支持去字幕、去水印、人脸/车牌模糊等多种模板，以及自定义区域、OCR 提取、字幕翻译。
适用场景：视频译制去原字幕、短剧出海、去除水印/LOGO、人脸隐私保护、车牌打码。
预设模板（--template）：
101 去字幕（默认）— 自动擦除 + 标准模型102 去字幕并提取OCR字幕 — 自动擦除 + OCR提取201 去水印-高级版 — 高级水印擦除301 人脸模糊 — 自动识别并模糊人脸302 人脸和车牌模糊 — 自动识别并模糊人脸和车牌区域预设（--position，仅模板 101/102 支持）：
--position 即可）；若字幕位置不在中下部，需通过 --position 或 --area 指定top、bottom、left、right、center、top-left、top-right、bottom-left、bottom-right、top-half、bottom-half、fullscreen# 自动擦除中下部字幕（默认模板 101）
python scripts/mps_erase.py --url https://example.com/video.mp4
# 去字幕并提取OCR字幕（模板 102）
python scripts/mps_erase.py --url https://example.com/video.mp4 --template 102
# 去水印-高级版（模板 201）
python scripts/mps_erase.py --url https://example.com/video.mp4 --template 201
# 人脸模糊（模板 301）
python scripts/mps_erase.py --url https://example.com/video.mp4 --template 301
# 人脸和车牌模糊（模板 302）
python scripts/mps_erase.py --url https://example.com/video.mp4 --template 302
# 去字幕 + OCR 提取 + 翻译为英文
python scripts/mps_erase.py --url https://example.com/video.mp4 --ocr --translate en
# 指定字幕位置（底部/顶部/左右/四角等12种预设）
python scripts/mps_erase.py --url https://example.com/video.mp4 --position bottom
python scripts/mps_erase.py --url https://example.com/video.mp4 --position top-right
scripts/mps_imageprocess.py支持图片增强、超分辨率、降噪、美颜、滤镜、擦除、盲水印、缩放等全面的图片处理能力。
适用场景：图片画质提升、人像美化、水印擦除、盲水印保护、格式转换与缩放。
# 超分辨率 2 倍放大
python scripts/mps_imageprocess.py --url https://example.com/image.jpg --super-resolution
# 综合增强（整体画质提升）
python scripts/mps_imageprocess.py --url https://example.com/image.jpg --quality-enhance normal
# 自动擦除水印/logo/文字
python scripts/mps_imageprocess.py --url https://example.com/image.jpg --erase-detect watermark
# 添加隐形盲水印（版权保护）；水印文字最多 4 字节（约 1 个中文字或 4 个 ASCII 字符）
python scripts/mps_imageprocess.py --url https://example.com/image.jpg --add-watermark "MPS"
# 格式转换为 WebP + 质量 80（网页优化）
python scripts/mps_imageprocess.py --url https://example.com/image.jpg --format WebP --quality 80
# 缩放至指定尺寸（等比缩放至宽 1920）
python scripts/mps_imageprocess.py --url https://example.com/image.jpg --resize-long-side 1920
# 美颜（美白 + 瘦脸 + 大眼）
python scripts/mps_imageprocess.py --url https://example.com/image.jpg \
--beauty Whiten:50 --beauty BeautyThinFace:30 --beauty EnlargeEye:40
scripts/mps_get_video_task.py查询由 ProcessMedia 接口（转码、增强、字幕、擦除等脚本）提交的异步任务的执行状态和结果详情。最多可查询 7 天内的任务。
⚠️ 任务 ID 格式说明：此脚本仅适用于
WorkflowTask-xxx格式的任务 ID（音视频处理任务）。
- AIGC 生视频任务的 ID 格式为
AigcVideoTask-xxx，应使用mps_aigc_video.py --task-id查询- 图片处理任务的 ID 格式为
ImageTask-xxx，应使用mps_get_image_task.py查询
适用场景：手动查询任务进度（各处理脚本已内置自动轮询，通常无需手动调用）。
# 查询任务状态
python scripts/mps_get_video_task.py --task-id 2600011633-WorkflowTask-80108cc3380155d98b2e3573a48a
# 输出完整 JSON 响应（含所有子任务详情）
python scripts/mps_get_video_task.py --task-id <TaskId> --verbose
# 仅输出原始 JSON（方便程序解析，不打印格式化摘要）
python scripts/mps_get_video_task.py --task-id <TaskId> --json
scripts/mps_get_image_task.py查询由 ProcessImage 接口（图片处理脚本）提交的异步任务的执行状态和结果详情。最多可查询 7 天内的任务。
⚠️ 任务 ID 格式说明：此脚本仅适用于
ImageTask-xxx格式的任务 ID（图片处理任务）。
- AIGC 生图任务的 ID 格式为
AigcImageTask-xxx，应使用mps_aigc_image.py --task-id查询- 音视频处理任务的 ID 格式为
WorkflowTask-xxx，应使用mps_get_video_task.py查询
适用场景：手动查询任务进度（图片处理脚本已内置自动轮询，通常无需手动调用）。
# 查询任务状态
python scripts/mps_get_image_task.py --task-id 2600011633-ImageTask-80108cc3380155d98b2e3573a48a
# 输出完整 JSON 响应（含所有子任务详情）
python scripts/mps_get_image_task.py --task-id <TaskId> --verbose
# 仅输出原始 JSON（方便程序解析，不打印格式化摘要）
python scripts/mps_get_image_task.py --task-id <TaskId> --json
scripts/mps_aigc_image.py通过文本描述和/或参考图片生成图片，汇聚 Hunyuan、GEM、Qwen 三大模型能力。
适用场景：文生图、图生图、多图风格融合、创意设计、营销海报。
⏳ 异步任务：脚本默认自动轮询等待生成完成（约 10~60 秒），结果直接打印。加
--no-wait可仅提交不等待，之后用--task-id <TaskId>查询结果。
# 文生图（Hunyuan 默认）
python scripts/mps_aigc_image.py --prompt "一只可爱的橘猫在阳光下打盹"
# 图生图（参考图片 + 描述）
python scripts/mps_aigc_image.py --prompt "将这张照片变成油画风格" \
--image-url https://example.com/photo.jpg
scripts/mps_aigc_video.py通过文本、图片、视频等输入生成视频，汇聚 Hunyuan、Hailuo、Kling、Vidu、OS、GV 六大模型能力。
适用场景：文生视频、图生视频、首尾帧动画、视频风格化、产品展示、短视频创作。
⏳ 异步任务：脚本默认自动轮询等待生成完成（约 1~5 分钟），结果直接打印。加
--no-wait可仅提交不等待，之后用--task-id <TaskId>查询结果。
# 文生视频（Hunyuan 默认）
python scripts/mps_aigc_video.py --prompt "一只猫在阳光下伸懒腰"
# 图生视频（首帧图片 + 描述）
python scripts/mps_aigc_video.py --prompt "让画面动起来" \
--image-url https://example.com/photo.jpg
| 脚本 | 腾讯云文档 |
|---|---|
mps_transcode.py | ProcessMedia |
mps_enhance.py | ProcessMedia |
mps_subtitle.py | ProcessMedia |
mps_erase.py | ProcessMedia |
mps_imageprocess.py | ProcessImage |
mps_get_video_task.py | DescribeTaskDetail |
mps_get_image_task.py | DescribeImageTaskDetail |
mps_aigc_image.py | CreateAigcImageTask |
mps_aigc_video.py | CreateAigcVideoTask |
需要查看详细参数时，请读取以下 references 文档：
references/params.md — 完整参数表| 章节 | 内容 |
|---|---|
| 通用参数 | --help、--dry-run、--region |
| 音视频/图片处理通用 | --url、--cos-object、--output-bucket、--output-dir、--no-wait、--poll-interval、--max-wait 等 |
| AIGC 通用 | --no-wait、--task-id、--poll-interval、--max-wait、COS 存储参数 |
| 转码参数 | --codec、--width/height、--bitrate、--fps、--audio-codec、--compress-type（4种策略）、--scene-type（6种场景）等 |
| 视频增强参数 | --preset、--diffusion-type、--scene-type、--super-resolution、--sr-type、--denoise、--hdr、--audio-separate（人声/背景声/伴奏）、音频增强、--codec/--width/--height/--bitrate/--fps/--container/--audio-codec/--audio-bitrate（输出编码控制）等 |
| 智能字幕参数 | --process-type（含 translate 模式）、--src-lang（支持粤语/方言等 18+ 种）、--translate（30+ 种目标语言）、--hotwords-id、--ocr-area、--sample-width/--sample-height（OCR 区域辅助）、--template（预设模板 ID） |
| 去字幕擦除参数 | --template、--method、--model、--position（12种区域预设）、--area、--custom-area、--ocr、--translate |
| 图片处理参数 | --super-resolution、--sr-type、--advanced-sr、--adv-sr-type（3种超分类型）、--sr-mode（3种输出模式）、--sr-percent/--sr-width/--sr-height/--sr-long-side/--sr-short-side（尺寸控制）、--denoise、--quality-enhance（综合增强3级）、--beauty（20种类型，支持口红颜色值）、--filter（东京/轻胶片/美味）、--erase-detect、--erase-area-type、--resize-*（含长短边）、--definition、--schedule-id、--format 等 |
| AIGC 生图参数 | --model、--negative-prompt、--enhance-prompt、--aspect-ratio、--image-url、--image-ref-type 等 |
| AIGC 生视频参数 | --model、--duration、--resolution、--enhance-prompt、--negative-prompt、--image-url、--last-image-url、--additional-params 等 |
references/scripts-detail.md — 各脚本完整示例集| 章节 | 内容 |
|---|---|
| §1 极速高清转码完整示例 | H264/H265/AV1、HLS 切片、极致压缩等完整命令 |
| §2 视频增强完整示例 | 大模型增强、综合增强、超分、HDR、插帧等 |
| §3 智能字幕完整示例 | ASR/OCR、多语言翻译、双语字幕等 |
| §4 智能去字幕与擦除完整示例 | 自定义区域、OCR 提取、翻译等 |
| §5 图片处理完整示例 | 超分、美颜、盲水印、格式转换等 |
| §6 查询音视频处理任务完整示例 | 任务状态查询、详细输出、JSON 输出等 |
| §7 查询图片处理任务完整示例 | 任务状态查询、详细输出、JSON 输出等 |
| §8 AIGC 智能生图完整示例 | 多模型、多图参考、风格融合等 |
| §9 AIGC 智能生视频完整示例 | 多模型、首尾帧、参考视频等 |
ZIP package — ready to use