dsh-audio-dub

English

DSH 视频/音频配音插件 —— 把一段视频或音频配音成另一种语言，并保留原说话人的音色（AI 声音克隆）。中文视频一句话变成英文版本，反之亦然。

你：把 ./demo.mp4 配音成英文
Agent：[dub_media] Job 8f3a… — completed
       zh → en · duration 154s · cost $1.28
       Download: https://…/dubbed.mp4

动机

Agent 已经能处理文本翻译，但"把这个视频做成英文版"一直落在工具链之外：要么手动上传到某个网页，要么自己拼 ffmpeg + ASR + 翻译 + TTS + 对齐。

本插件把整条链路收成一个工具调用：输入本地文件路径或媒体直链，输出配好音的成片下载地址。转写、翻译、声音克隆、时间轴对齐都在服务端完成，Agent 只需要等结果。

安装

装到你的 profile（以 headless 为例，web / tui 同理）：

dsh plugin --profile headless add github:pinch-eng/dsh-audio-dub

安装后插件会自动注册，无需手动编辑 cordis.yml。然后设置 API key（在 portal.startpinch.com 创建，形如 pk_…）：

export PINCH_API_KEY=pk_xxx

试一下：

dsh --profile headless "把 ./demo.mp4 配音成英文"

配置

字段	类型	默认值	说明
apiKey	string	process.env.PINCH_API_KEY	API key。建议走环境变量，不要写进 cordis.yml
baseUrl	string	https://portal.startpinch.com	自建/测试环境时覆盖
pollIntervalMs	integer	15000	等待期间的轮询间隔，最小 5000

工具声明

dub_media —— 配音

参数	类型	必填	说明
source	string	✅	本地文件路径（./talk.mp4）或媒体文件直链。不支持 YouTube / B 站等网页链接，那是页面不是媒体文件