MaKTaiL/gemini-srt-translator

---

Gemini SRT Translator – Google의 Gemini 모델을 사용하여 자막(SRT/ASS)을 번역, 전사, 추출할 수 있는 Python 패키지입니다.

기능

• 번역: .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에 게시되어 있으며 기여자가 있습니다.

---

---

설명 종료.