Gemini 비디오 분석기은(는) 무엇을 하나요?
Google Gemini의 멀티모달 API를 사용하여 비디오를 기본적으로 분석합니다. 프레임 추출이 필요 없습니다. Gemini가 1FPS로 비디오를 처리하여 움직임, 오디오, 시각적 맥락을 완전히 이해합니다.
빠른 시작
# 기본 프롬프트(전체 설명)로 비디오 분석
GOOGLE_AI_API_KEY=$GOOGLE_AI_API_KEY python3 {baseDir}/scripts/analyze.py /path/to/video.mp4
# 특정 질문
GOOGLE_AI_API_KEY=$GOOGLE_AI_API_KEY python3 {baseDir}/scripts/analyze.py /path/to/video.mp4 "화면에 보이는 텍스트는 무엇인가요?"
# 업로드된 파일 관리
GOOGLE_AI_API_KEY=$GOOGLE_AI_API_KEY python3 {baseDir}/scripts/manage_files.py list
GOOGLE_AI_API_KEY=$GOOGLE_AI_API_KEY python3 {baseDir}/scripts/manage_files.py cleanup
지원 형식
MP4, AVI, MOV, MKV, WebM, FLV, MPEG, MPG, WMV, 3GP — 파일당 최대 2GB.
작동 방식
- 비디오가 Google Files API에 업로드됩니다(임시 저장, 48시간 후 자동 삭제)
- Gemini가 1프레임/초로 처리 — 움직임, 전환, 오디오 맥락을 이해합니다
- 모델이 사용자의 프롬프트에 따라 응답을 생성합니다
- 시간적 콘텐츠 이해에 있어 프레임 추출보다 훨씬 뛰어납니다
사용 사례
| 작업 | 예시 프롬프트 |
|---|---|
| 일반 설명 | (기본값 — 프롬프트 불필요) |
| UI/텍스트 추출 | "어떤 텍스트와 UI 요소가 보이나요?" |
| 튜토리얼 요약 | "이 튜토리얼에 나온 단계를 요약해 주세요" |
| 비디오 버그 리포트 | "이 화면 녹화에서 무엇이 잘못되었는지 설명해 주세요" |
| 회의록 | "논의된 주요 사항을 요약해 주세요" |
| 콘텐츠 비교 | 비디오 2개 업로드 후 차이점 질문 |
설정
환경 변수나 .env 파일에 GOOGLE_AI_API_KEY를 설정하세요. aistudio.google.com에서 무료 키를 받을 수 있습니다.
기본 모델: gemini-2.5-flash (빠르고 저렴하며 뛰어난 시각 인식). 복잡한 분석에는 --model gemini-2.5-pro로 재정의할 수 있습니다.
API 참조
파일 업로드 제한, 처리 세부 사항 및 고급 옵션은 references/gemini-files-api.md를 참조하세요.