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に公開されており、貢献者がいます。

---

---

説明終了。