MaKTaiL/gemini-srt-translator

---

Gemini SRT Translator – 一个 Python 包，允许您使用 Google 的 Gemini 模型翻译、转录和提取字幕（SRT/ASS）。

功能

• 翻译：将 .srt 或 .ass 字幕文件翻译成 Gemini 支持的任何语言，并保持时间戳不变。
• 转录：将音频/视频文件直接转录为字幕格式。
• 提取：从视频中提取字幕或音频（需要 FFmpeg），并可选择将音频反馈给 Gemini 以获得更好的上下文。
• CLI：gst … 命令用于一行命令和脚本编写，同时提供 Python API 用于编程使用。
• 支持 Google 标准 Gemini API 或 企业版 Agent Platform（Vertex AI），支持 ADC 或 API 密钥认证。
• 提供批处理、可恢复运行、自定义模型参数（温度、服务层级等）、日志记录和令牌使用报告等功能。

使用方法

1. 安装：pip install -U gemini-srt-translator（建议使用虚拟环境）。
2. 设置 GEMINI_API_KEY（或配置企业变量）——如果缺失，工具会提示。
3. 运行简单翻译：

   export GEMINI_API_KEY=YOUR_KEY
   gst translate -i movie.srt -l French
   

   添加 -v movie.mp4 --extract-audio 可从视频中提取字幕并将音频提供给 Gemini 以提高上下文。
4. 转录：

   gst transcribe -v lecture.mp4 -o lecture.srt
   

5. 在 Python 中，可以执行：

   import gemini_srt_translator as gst
   gst.gemini_api_key = "YOUR_KEY"
   gst.input_file = "movie.srt"
   gst.target_language = "French"
   gst.translate()
   

   或使用更丰富的 SubtitleSession / TranscriptionSession 类进行自定义管道。

适用对象

• 需要快速、高质量字幕翻译的内容创作者。
• 构建需要字幕处理的自动化视频管道或 AI 代理的开发者。
• 尝试 Gemini 的“思考”模式以获得更上下文相关翻译的研究人员。

限制与要求

• 需要有效的 Gemini API 密钥（或 Google Cloud 企业凭据）。
• 基于视频的提取需要安装 FFmpeg。
• 大文件可能需要调整批处理大小；工具可以在出错时自动减少批处理大小。

---

以上详细信息直接取自项目 README，没有添加额外声明。 ***

关键字段

• 类别：基于 Gemini LLM 的字幕翻译/转录工具。
• 安装：pip install -U gemini-srt-translator（建议虚拟环境）。
• 主要接口：gst CLI（translate、transcribe、extract、list-models、agent、skill），Python API（gst.translate()、SubtitleSession、TranscriptionSession）。
• 认证：GEMINI_API_KEY 环境变量或企业变量（GOOGLE_GENAI_USE_ENTERPRISE、GOOGLE_CLOUD_PROJECT 等）。
• 依赖项：ffmpeg（系统），Gemini 客户端库，标准 Python 包。
• 许可证/状态：摘录中未指定，但该包已发布在 PyPI 上，并有贡献者。

---

---

说明结束。