pyvideotrans API调用指南：构建自动化视频翻译流水线

【免费下载链接】pyvideotrans Translate the video from one language to another and add dubbing. 将视频从一种语言翻译为另一种语言，并添加配音 项目地址: https://gitcode.com/gh_mirrors/py/pyvideotrans

想要快速实现视频翻译自动化？pyvideotrans提供了完整的REST API接口，让你能够轻松构建自动化视频翻译流水线。通过简单的HTTP请求，即可完成语音识别、字幕翻译、语音合成等复杂任务，大幅提升工作效率。🚀

什么是pyvideotrans API？

pyvideotrans API是一个基于Flask框架构建的RESTful接口服务，默认运行在127.0.0.1:9011端口。它提供了四个核心接口，覆盖了视频翻译的完整流程。

核心API接口详解

1. 语音识别接口 - /recogn

这个接口专门用于音视频转字幕，支持多种识别引擎：

• 本地模型：faster-whisper、openai-whisper
• 云端服务：Google识别API、豆包模型识别
• 自定义API：支持第三方语音识别服务

请求示例：

import requests

response = requests.post("http://127.0.0.1:9011/recogn", json={
    "name": "/path/to/video.mp4",
    "recogn_type": 0,
    "model_name": "tiny",
    "detect_language": "zh"
})

2. 字幕翻译接口 - /translate_srt

专门处理SRT字幕文件的翻译任务，支持20+种语言互译：

• 中文、英语、日语、韩语、法语、德语
• 西班牙语、俄语、阿拉伯语等

主要特性：

• 保留原始时间轴格式
• 支持批量翻译
• 多种翻译引擎可选

3. 语音合成接口 - /tts

将字幕文件转换为自然流畅的配音音频：

支持的TTS引擎：

• Edge-TTS、CosyVoice、ChatTTS
• Azure-TTS、GPT-SoVITS、OpenAI TTS
• Elevenlabs、Google TTS等

4. 完整视频翻译接口 - /trans_video

一站式解决方案，从原始视频到翻译配音视频的完整处理：

• 语音识别 → 字幕翻译 → 语音合成 → 视频合成

API调用实战指南

启动API服务

在项目根目录下运行：

python api.py

服务启动后，你将看到：

Starting... API URL is http://127.0.0.1:9011

任务状态监控

所有接口都返回task_id，你可以通过/task_status接口实时监控任务进度：

# 查询任务状态
status_response = requests.post("http://127.0.0.1:9011/task_status", json={
    "task_id": "your_task_id"
})

状态码说明：

• -1：任务进行中
• 0：任务成功完成
• >0：任务出错

构建自动化流水线

方案一：单任务处理

适合处理单个视频文件的场景：

1. 调用/trans_video接口提交任务
2. 轮询/task_status获取进度
3. 完成后下载生成的文件

方案二：批量处理流水线

对于大量视频文件，建议采用以下架构：

视频文件队列 → API调用 → 状态监控 → 结果收集

关键配置文件

• API主文件：api.py
• 语音识别模块：videotrans/recognition/
• 翻译引擎：videotrans/translator/
• TTS合成：videotrans/tts/

最佳实践建议

1. 错误处理机制

def handle_api_error(response):
    if response.status_code != 200:
        raise Exception("API请求失败")
    
    data = response.json()
    if data['code'] != 0:
        raise Exception(f"任务失败: {data['msg']}")

2. 性能优化

• 启用CUDA加速（如果支持）
• 选择合适的模型大小
• 合理设置并发任务数

总结

pyvideotrans API为视频翻译自动化提供了强大而灵活的工具。无论是处理单个视频还是构建大规模翻译系统，都能通过简单的HTTP接口实现。🎯

核心优势：

• 接口设计简洁易用
• 支持多种识别和合成引擎
• 提供完整的任务状态监控
• 易于集成到现有工作流中

开始使用pyvideotrans API，让你的视频翻译工作变得更加高效和智能！

【免费下载链接】pyvideotrans Translate the video from one language to another and add dubbing. 将视频从一种语言翻译为另一种语言，并添加配音 项目地址: https://gitcode.com/gh_mirrors/py/pyvideotrans