面向开发者的 Vocnu
Vocnu 的底层引擎已开源。凭借个人 API 令牌,您可通过命令行和 MCP 服务器,在终端和 AI 助手中使用托管服务。
开源引擎
与托管服务使用相同的处理流程,采用 AGPL-3.0 许可证:语音识别、翻译、配音时间对齐和混音。使用您自己的 OpenAI 和 ElevenLabs 密钥,即可在自己的电脑上运行。
功能
- 通过 faster-whisper 在您的 GPU 或 CPU 上识别语音,并借助文件已有的字幕轨道辅助识别。
- 使用 OpenAI 翻译:先分析完整转录文本,再结合上下文分段翻译,进行独立审校,并为每行设置字符数限制,使其适合对应的时长。
- 使用 ElevenLabs 音色配音。超时的台词会先重新录制,再缩短措辞,最后才加速,最高为 1.08 倍速。
- 混合画外音配音:每句配音播放时降低原声音量,并在视频中将原始音频保留为第二条音轨。
- 输出带可切换字幕的 MP4、MKV、MOV、WebM 或 AVI 视频,M4A、MP3、WAV、FLAC 或 OGG 音频,以及 SRT、VTT 和 ASS 字幕。
- 已知电影和剧集中的名称采用公开名称库中的写法。
所需条件
- uv 和 ffmpeg。处理图像字幕时可选用 Tesseract。
- NVIDIA GPU 可将语音识别速度提高数倍;也可使用 CPU,但速度较慢。
- 您自己的 OpenAI 和 ElevenLabs 密钥。费用直接支付给服务提供商:在我们的运行中,每分钟语音约需 0.05 至 0.10 美元,收据会列出确切金额。
uvx --from git+https://github.com/vocnu/engine \
vocnu-engine translate film.mkv --to zhAGPL-3.0:您可以使用、修改和分享引擎;如果将其作为网络服务提供,则需以相同许可证公开您的修改。母语使用者对语言的反馈是最有价值的贡献之一。
命令行
npm 软件包 vocnu,适用于 Node.js 20 或更新版本。可上传最大 10 GB 的文件,以积分显示价格并在开始前请求确认,跟踪任务进度,并将结果保存在原文件所在目录。
npx vocnu login
npx vocnu translate film.mkv --to zh选项
| 选项 | 作用 |
|---|---|
--output video|audio|subtitles | 含画外音配音的视频(视频文件的默认选项)、画外音配音音频或仅字幕 |
--from <lang> | 语音语言,默认自动检测 |
--voice female|male | 女声或男声 |
--format mp4|mkv|mov|webm|avi | 视频文件格式;默认沿用上传文件的格式,否则使用 MP4 |
--audio-format m4a|mp3|wav|flac|ogg | 画外音配音音频格式 |
--burn-subtitles | 将字幕烧录到画面中 |
--out <dir> | 结果保存位置 |
--yes | 无需确认价格即开始 |
--no-wait | 启动任务并返回其 ID |
其他命令
vocnu creditsvocnu languagesvocnu jobsvocnu status <job>vocnu download <job>vocnu cancel <job>vocnu logout
MCP 服务器
将 Vocnu 添加到 Claude 或其他支持 MCP 的助手中,然后让它翻译视频。它会上传文件、告知价格,经您同意后才开始,并跟踪任务进度、保存文件。
Claude Code
claude mcp add vocnu -e VOCNU_TOKEN=vocnu_... -- npx -y vocnu mcpClaude Desktop 和其他 MCP 客户端
{
"mcpServers": {
"vocnu": {
"command": "npx",
"args": ["-y", "vocnu", "mcp"],
"env": { "VOCNU_TOKEN": "vocnu_..." }
}
}
}然后可以这样提问:“使用 Vocnu 将 ~/Videos/film.mkv 翻译成立陶宛语。”
工具
vocnu_upload_media- 从您的电脑上传文件
vocnu_start_job- 您同意价格后启动任务
vocnu_job_status- 显示任务进度
vocnu_download_results- 保存已完成的文件
vocnu_languages- 列出目标语言
vocnu_credits- 显示您的积分余额
vocnu_list_jobs- 列出您的任务
vocnu_cancel_job- 取消任务
API 令牌
在应用的“设置”中进入“API 和 MCP”创建令牌。令牌仅显示一次:运行 vocnu login 时,命令行会保存令牌,您也可以将其设为 VOCNU_TOKEN。
令牌可上传文件、查看价格、启动和跟踪任务、下载任务结果,以及读取您的积分余额。它不能付款、修改个人资料或管理令牌。您可随时撤销令牌;应用会显示各令牌的上次使用时间。
开放数据
问答
引擎免费吗?
是的。引擎以 AGPL-3.0 许可证开源,您只需按自己密钥的实际用量向 OpenAI 和 ElevenLabs 付费。托管服务无需密钥或配置,使用积分计费。
命令行和 MCP 服务器需要账号吗?
需要。它们通过个人 API 令牌使用托管服务,积分、价格和退款规则与应用相同,扣费前即可查看价格。
可以在闭源产品中使用引擎吗?
根据 AGPL-3.0,如果您将引擎作为网络服务提供,则需公开您的修改。如需其他授权条款,请联系 support@vocnu.com。