Xpersona
T

Tencent MPS Video Dubbing

CLAWHUB · Unverified

Tencent Cloud MPS 一站式端到端视频译制专用 Skill，在单次任务中**不可拆分**地完成「提取原视频语音/字幕 → 翻译为目标语言 → 压制目标语言字幕 → AI 克隆原声配音」整条跨语言本地化流水线。**触发的硬条件（必须同时满足）：(1) 用户的输入是一段视频；(2) 明确要求变更音视频的语言（翻译 + 配音 / 翻译 + 换语言 / 做成另一语言版本）；(3) 是端到端产出一个全新语言版本的视频，而不是只做流水线中的某一步子任务**。满足硬条件的典型表达：把这段视频翻译成英文并配音、中文视频做成韩语版、韩剧中配、短剧出海译制、做一个日语配音版、 跨语言视频制作 Skill: Tencent MPS Video Dubbing Owner: tencent-mpaas-skills Summary: Tencent Cloud MPS 一站式端到端视频译制专用 Skill，在单次任务中**不可拆分**地完成「提取原视频语音/字幕 → 翻译为目标语言 → 压制目标语言字幕 → AI 克隆原声配音」整条跨语言本地化流水线。**触发的硬条件（必须同时满足）：(1) 用户的输入是一段视频；(2) 明确要求变更音视频的语言（翻译 + 配音 / 翻译 + 换语言 / 做成另一语言版本）；(3) 是端到端产出一个全新语言版本的视频，而不是只做流水线中的某一步子任务**。满足硬条件的典型表达：把这段视频翻译成英文并配音、中文视频做成韩语版、韩剧中配、短剧出海译制、做一个日语配音版、 跨语言视频制作 Tags: latest:1.0.6 Version history: v1.0.6 | 2026-07-

62
Rank
84
Safety
989
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 989 downloads reported by the source. Last updated 10/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: medium.

clawhub skill install s172dymwd68zz4gb81ansjp35x83k7pr:tencent-mps-video-dubbing
  1. Python environment detected. Create a strict virtual environment (`python -m venv .venv`) before installing dependencies to prevent system-level package conflicts.
  2. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  3. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-tencent-mpaas-skills-tencent-mps-video-dubbing/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

73,449 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: tencent-mps-video-dubbing
description: Tencent Cloud MPS 一站式端到端视频译制专用 Skill，在单次任务中**不可拆分**地完成「提取原视频语音/字幕 → 翻译为目标语言 → 压制目标语言字幕 → AI 克隆原声配音」整条跨语言本地化流水线。**触发的硬条件（必须同时满足）：(1) 用户的输入是一段视频；(2) 明确要求变更音视频的语言（翻译 + 配音 / 翻译 + 换语言 / 做成另一语言版本）；(3) 是端到端产出一个全新语言版本的视频，而不是只做流水线中的某一步子任务**。满足硬条件的典型表达：把这段视频翻译成英文并配音、中文视频做成韩语版、韩剧中配、短剧出海译制、做一个日语配音版、 跨语言视频制作 / 视频本地化一站式处理。**额外触发场景（查询类豁免）**：用户明确要求查询一个"视频译制任务"的状态/结果/进展，也应触发本 Skill。**仅询问工具推荐或咨询而不进行实际处理时不触发**。
metadata:
  version: "1.0.6"
---

# 腾讯云 MPS · 配音级视频译制（video-dubbing）

## 角色定义

你是腾讯云 MPS 一站式**配音级视频译制**的专业助手，帮助用户生成正确的 Python 脚本命令。本 Skill 端到端产出新语言版本视频，**不可拆分为子任务**。

参数细节、枚举值、JSON 结构、命令模板、运行时陷阱与强制规则以 `references/mps_video_dubbing.md` 为**唯一真相来源**，本 SKILL.md 只做**行为约束与通用规则**，不复述具体参数，避免双向漂移。

## 输出规范

1. **只输出命令**，不要解释，不要废话
2. 命令格式：`python3 scripts/mps_video_dubbing.py [参数]`
3. 脚本支持 `--dry-run`（打印请求不调 API、不计费），**默认自动轮询等待完成**（若指定了 `--download-dir` 则完成后自动下载产物），加 `--no-wait` 才只提交不等待
4. 输入源判断：URL（HTTP/HTTPS 或 `cos://bucket/key`）用 `--input-url` / `-i`，COS 路径用 `--cos-input-key`，未说明来源一律用 `--local-file`（详见强制规则第 4 条）
5. **任务完成后输出的链接（预签名下载链接、COS URL 等）必须用 Markdown 超链接格式呈现**，即 `[描述文字](URL)`，不得以代码块或纯文本形式输出链接
6. **【强制】每次执行处理类任务后，无论是否等待完成、无论成功失败，必须在回复中明确展示 TaskId**：脚本 stdout 会输出 `🆔 TaskId: <id>` 格式的行，从中提取并以 `🆔 任务 ID：<TaskId>` 格式告知用户（方便后续 `--query-task` 手动查询）

> 💰 **费用提示**：本 Skill 调用腾讯云 MPS 服务会产生相应费用；一个任务未拿到结果时不得手动重复发起，否则会重复计费。具体计费标准请参考 [腾讯云 MPS 定价](https://cloud.tencent.com/document/product/862/36180)。配音级译制费用累加：OCR 模式产生**五项**（去字幕 + OCR + 翻译 + 压制字幕 + AI 克隆配音）；ASR 模式产生**四项**（ASR + 翻译 + 压制字幕 + AI 克隆配音）。每次生成提交命令前必须先用自然语言告知用户费用并征得明确确认（"是否执行？"），**CLI 必须带 `--confirm-charges`**，交互向导末步必须键入大写 `YES`；查询类（`--query-task`）、列举类（`--list-languages`）、`--dry-run` 预演无需提示。建议用户在 [腾讯云费用中心](https://console.cloud.tencent.com/expense/budget) 设置预算告警与月度上限。

通过腾讯云官方 Python SDK 调用 MPS API，主脚本位于 `scripts/mps_video_dubbing.py`。**详细参数与示例见 `references/mps_video_dubbing.md`，生成命令前必须先 Read 该文档；未读 references 直接给命令视为违规**。

## 环境配置

检查环境变量：
```bash
python3 scripts/mps_load_env.py --check-only
```
如果变量没有配置，明确提醒用户在 `~/.env`（用户级 dotenv，最高优先级）或 `<SKILL_DIR>/.env`（脚本目录级）或 `~/.bashrc` 或 `~/.profile` 自己配置，禁止向用户索取密钥帮用户配置。
**`<SKILL_DIR>` 为 `tencent-mps-video-dubbing` 所在目录。**

```bash
# 必须（所有命令）
export TENCENTCLOUD_SECRET_ID="<请替换为真实 SecretId>"
export TENCENTCLOUD_SECRET_KEY="<请替换为真实 SecretKey>"
# MPS API 调用地域（必须，影响 MPS API 接入点）
# 未设置时脚本会直接报错退出
export TENCENTCLOUD_API_REGION="<请替换为真实 API 区域，如 ap-guangzhou>"

# COS 桶/地域（必须），用于输入和输出，输入是COS是必需的，输出一定是必须的； 
export TENCENTCLOUD_COS_BUCKET="<请替换为真实存储桶名>"
export TENCENTCLOUD_COS_REGION="<请替换为真实存储桶地域，如 ap-guangzhou>"

# MPS API 接入点（可选），不设置时默认国内站 mps.tencentcloudapi.com
# 使用国际站时才需要设置为 mps.intl.tencentcloudapi.com
export TENCENTCLOUD_MPS_ENDPOINT="mps.intl.tencentcloudapi.com"
```

> ⚠️ 上述带 `<...>` 的值是**占位符示意**，必须替换为真实凭证；若直接照抄会导致认证失败（`AuthFailure.SecretIdNotFound`）。

### MPS API 支持的地域

> ⚠️ 此处指 **MPS 接入区域**（API endpoint 的签名地域），非翻译语种。未设置 `TENCENTCLOUD_API_REGION` 时脚本将直接报错退出。

可选区域：`ap-guangzhou`、`ap-shanghai`、`ap-beijing`、`ap-hongkong

_meta.json

{
  "ownerId": "kn70yhz47k5f2a22dsfdhthzqx83k6t0",
  "slug": "tencent-mps-video-dubbing",
  "version": "1.0.6",
  "publishedAt": 1785316523525
}

references/example.md

# 视频译制 ProcessMedia 请求示例

> 本文件收录 MPS `ProcessMedia` 接口在**视频配音译制**场景下的**请求 JSON 示例**。
> 字段释义、关键规则、ExtendedParameter 完整结构 → 见 [`mps_video_dubbing.md`](./mps_video_dubbing.md)（特别是「参数说明」「强制规则」两节）。

---

## 公共模板

5 个示例共用以下 `InputInfo` / `OutputStorage` / 接口元字段，下方各示例**仅展示 `ExtendedParameter` 差异部分**。

```json
{
  "regionId": 1,
  "serviceType": "mps",
  "cmd": "ProcessMedia",
  "data": {
    "Version": "2019-06-12",
    "InputInfo": {
      "Type": "COS",
      "CosInputInfo": {
        "Bucket": "mps-ollie-test-1308104797",
        "Region": "ap-guangzhou",
        "Object": "input/17_1773808857717.MP4"
      }
    },
    "OutputStorage": {
      "Type": "COS",
      "CosOutputStorage": {
        "Bucket": "mps-ollie-test-1308104797",
        "Region": "ap-guangzhou"
      }
    },
    "AiAnalysisTask": {
      "Definition": 25,
      "ExtendedParameter": "<见下方各示例>"
    }
  }
}
```

---

## 1. ASR + 不压制字幕

无硬字幕视频，ASR 识别 + 翻译，**不**压字幕，仅替换配音。

```text
ExtendedParameter:
  "{\"delogo\":{\"cluster_id\":\"gpu_zhiyan\",\"CustomerAppId\":\"audio_clone_asr\",\"subtitle_param\":{\"translate_src_language\":\"zh\",\"translate_dst_language\":\"en\",\"use_draw\":false,\"font_type\":\"auto\"}}}"
```

差异点：`CustomerAppId=audio_clone_asr`，`use_draw=false`。

---

## 2. ASR + 压制字幕

无硬字幕视频，ASR 识别 + 翻译，并把翻译字幕**压制**到画面，同时替换配音。

```text
ExtendedParameter:
  "{\"delogo\":{\"cluster_id\":\"gpu_zhiyan\",\"CustomerAppId\":\"audio_clone_asr\",\"subtitle_param\":{\"translate_src_language\":\"zh\",\"translate_dst_language\":\"en\",\"use_draw\":true,\"font_type\":\"auto\"}}}"
```

差异点：`use_draw=true`。

---

## 3. OCR + 预设字幕区域（推荐，90% 场景）

画面有硬字幕，OCR 识别 + 擦除 + 翻译 + 压新字幕 + AI 配音。**不传** `als_filter`，由后端使用默认区域（画面中部靠下）。

```text
ExtendedParameter:
  "{\"delogo\":{\"cluster_id\":\"gpu_zhiyan\",\"CustomerAppId\":\"audio_clone_ocr\",\"subtitle_param\":{\"translate_src_language\":\"zh\",\"translate_dst_language\":\"en\",\"use_draw\":true,\"font_type\":\"auto\"}}}"
```

差异点：`CustomerAppId=audio_clone_ocr`，**无 `als_filter`**。

---

## 4. OCR + 自定义字幕区域（底部）

画面有硬字幕但位置非中下部，需自定义识别/擦除像素矩形区域。

```text
ExtendedParameter（转义形式）:
  "{\"delogo\":{\"cluster_id\":\"gpu_zhiyan\",\"CustomerAppId\":\"audio_clone_ocr\",\"subtitle_param\":{\"translate_src_language\":\"zh\",\"translate_dst_language\":\"en\",\"use_draw\":true,\"font_type\":\"auto\"},\"als_filter\":{\"active_areas\":[{\"type\":2,\"lt_x\":53,\"lt_y\":741,\"rb_x\":953,\"rb_y\":922}]}}}"
```

解包形式：

```json
{
  "delogo": {
    "cluster_id": "gpu_zhiyan",
    "CustomerAppId": "audio_clone_ocr",
    "subtitle_param": {
      "translate_src_language": "zh",
      "translate_dst_language": "en",
      "use_draw": true,
      "font_type": "auto"
    },
    "als_filter": {
      "active_areas": [
        { "type": 2, "lt_x": 53, "lt_y": 741, "rb_x": 953, "rb_y": 922 }
      ]
    }
  }
}
```

差异点：新增 `als_filter.active_areas`，矩形像素坐标 `(53,741)→(953,922)`。

---

## 5. OCR + 自定义字幕区域（中上部）

同 #4，换一组坐标（如顶部横幅字幕）。

```text
ExtendedParameter:
  "{\"delogo\":{\"clust

references/mps_video_dubbing.md

# 视频译制参数与示例 — `mps_video_dubbing.py`

**功能**：腾讯云 MPS 一站式视频译制 — 单次任务端到端完成「擦除原字幕 / ASR → 翻译 → 压制目标语言字幕 → AI 克隆原声配音」。底层调用 `ProcessMedia` 接口的 `AiAnalysisTask`（Definition=25），通过 `ExtendedParameter` 传扩展参数。

> 输入 → 去字幕(OCR) / ASR → 翻译 → 压新字幕 → AI 克隆配音 → 输出新视频

## 模式说明

| 维度 | `ocr` | `asr` |
|------|-------|-------|
| 适用视频 | 画面有硬字幕 | 画面无硬字幕 |
| 翻译来源 | OCR 提取的画面字幕文本 | 语音识别结果 |
| 自动擦除原画面字幕 | ✅ | ❌ 不擦除 |
| 字幕区域参数 | `--subtitle-area` 必填 | 忽略 |
| `CustomerAppId`（内部字段，脚本自动设置） | `audio_clone_ocr` | `audio_clone_asr` |
| 典型耗时（1080p / 5min） | 15~25 分钟 | 5~10 分钟 |

**OCR 字幕区域两种模式（`--subtitle-area`）**：

| 取值 | 适用场景 | `als_filter` 写入 | 必带参数 |
|------|---------|------------------|---------|
| `preset`（推荐） | 画面中部靠下的常规硬字幕（覆盖 90% 视频） | ❌ 不写（后端按默认区域） | — |
| `custom` | 顶部 / 竖屏 / 双语对照等非常规位置 | ✅ 写矩形像素坐标 | `--subtitle-bbox LTX,LTY,RBX,RBY` |

## 参数说明

| 参数 | 说明 |
|------|------|
| `-i, --input-url` | 视频公网 URL（支持 `https://` 或 `cos://bucket/key`，后者自动识别为 `CosInputInfo`） |
| `--local-file` | 本地文件路径，自动上传到 COS 后处理（与 `-i` / `--cos-input-key` 互斥） |
| `--cos-input-key` | COS 输入对象 key（如 `input/video.mp4`） |
| `--cos-input-bucket` | COS 输入桶（仅 `--cos-input-key` 路径下生效，未传则沿用 `--cos-bucket`） |
| `--cos-input-region` | COS 输入地域（仅 `--cos-input-key` 路径下生效，未传则沿用 `--cos-region`） |
| `--mode` | **【必填】** 译制模式：`ocr`（画面有硬字幕）/ `asr`（无硬字幕） |
| `--src-lang` | **【必填】** 源语言 code（31 种，见下方「支持语种」表或 `--list-languages`） |
| `--dst-lang` | **【必填】** 目标语言 code，**不得与 src 相同** |
| `--burn-subtitle` / `--no-burn-subtitle` | **【必填，二选一】** 是否压制翻译后字幕到画面 |
| `--subtitle-area` | **【OCR 必填】** 字幕区域模式：`preset` / `custom` |
| `--subtitle-bbox` | 自定义矩形 4 点整数像素坐标，格式 `LTX,LTY,RBX,RBY`（如 `53,741,953,922`），仅 `--subtitle-area=custom` 时必填 |
| `--cos-bucket` | **【必填】** 输出 COS 桶（未传则从 `TENCENTCLOUD_COS_BUCKET` 读取，未设置则报错） |
| `--cos-region` | **【必填】** 输出 COS 地域（未传则从 `TENCENTCLOUD_COS_REGION` 读取，未设置则报错） |
| `--output-dir` | COS 输出目录，默认 `/output/video-dubbing/` |
| `--no-wait` | 仅提交不等待（默认自动轮询） |
| `--poll-interval` | 轮询间隔（秒），默认 `15` |
| `--max-wait` | 最长等待（秒），默认 `3600` |
| `--download-dir` | 任务完成后下载成品到本地目录 |
| `--session-id` | 任务去重识别码（同一 ID 在 3 天内重复提交会报错；适用于幂等重试场景）|
| `--region` | **【必填】** MPS API 区域（未传则从 `TENCENTCLOUD_API_REGION` 读取，未设置则报错） |
| `--interactive` | 强制进入交互向导 |
| `--confirm-charges` | **CLI 模式必需**：确认产生费用；漏传则脚本自动降级 dry-run 不实际提交 |
| `--dry-run` | 不调用 API；打印「配置摘要」+「完整 ProcessMedia 请求 JSON」 |
| `--query-task <TaskId>` | 单次查询已提交任务（输出原始 JSON，不计费、不轮询） |
| `--list-languages` | 列出 31 种支持语种（完整对照表 + 地区分组） |
| `--verbose, -v` | 详细输出（影响环境加载日志和轮询过程日志的详细度） |

## 支持语种（31 种，官方文档声明双向支持翻译）

> 与脚本内的 `SUPPORTED_LANGUAGES` 字典**同源**。运行 `python3 scripts/mps_video_dubbing.py --list-languages` 可在终端实时查看完整对照表 + 地区分组。

| # | 语种 | Code | | # | 语种 | Code | | # | 语种 | Code |
|:-:|---|:-:|---|:-:|---|:-:|---|:-:|---|:-:|
| 1  | 中文           | `zh`  | | 12 | 印度尼西亚语 | `id`  | | 23 | 印地语       | `hi`  |
| 2  | 英语           | `en`  | | 13 | 荷兰语       | `nl`  | | 24 | 保加利亚语   | `bg`  |
| 3  | 日语           | `ja`  | | 14 | 土耳其语     | `tr`  | | 25 | 罗马尼亚语   |

scripts/requirements.txt

# Tencent Cloud MPS 视频译制 Skill — Python dependencies
#
# All packages are official open-source libraries.
# tencentcloud-sdk-python ships frequent updates (often weekly) to support new
# MPS models / parameters. pip will install the latest version satisfying the
# constraint; to force an upgrade later, run:
#     python3 -m pip install -r scripts/requirements.txt --upgrade
#
#   tencentcloud-sdk-python : Tencent Cloud MPS API client (publisher: Tencent Cloud)
#     repo: https://github.com/TencentCloud/tencentcloud-sdk-python
#     used by mps_video_dubbing.py / mps_poll_task.py
#
#   cos-python-sdk-v5       : Tencent Cloud COS SDK (object storage)
#     repo: https://github.com/tencentyun/cos-python-sdk-v5
#     used by mps_cos_upload.py / mps_cos_download.py
#
#   python-dotenv           : Load credentials from .env files (used by mps_load_env.py)
#     repo: https://github.com/theskumar/python-dotenv
#     used by 1 script (mps_load_env.py) for automatic dotenv loading

tencentcloud-sdk-python>=3.1.139
cos-python-sdk-v5>=1.9.30
python-dotenv>=1.0.0

Sponsored

Ads related to Tencent MPS Video Dubbing and adjacent AI workflows.