Feature #689
closedFeature #666: [VID] 설교 영상 자동화 시스템 (V2)
Feature #686: [VID-02] 영상 분석·설교 구간 추출
[VID-02-03] STT 연동 및 스크립트 저장
100%
Description
담당: 양성용
목적¶
분할된 구간의 음성을 글로 바꾸고, 시간과 함께 저장한다.
전제·입력¶
VID-02-02 구간과 시작 시간, VID-00-03에서 정한 시간 정보 방식.
작업 순서¶
- 구간별 음성을 STT API에 보내 전사.
- 결과를 원본 시작 시간과 함께 저장(구간 번호·텍스트·시간).
- API 실패 시 재시도, 비용·사용량 기록.
- 전체 스크립트를 시간순으로 합쳐서 보여 줄 수 있게 한다.
사용 기술·도구¶
OpenAI STT API(gpt-transcribe 우선), 구간별 호출
산출물¶
전사 코드, 시간별 스크립트 데이터
완료 기준¶
- 모든 구간이 전사되어 시간순으로 조회된다.
- 실패한 구간은 재시도되거나 실패로 기록된다.
이 일감에서 하지 않는 것¶
설교 구간 판단은 하지 않는다.
주의·미확정 사항¶
API 키는 코드에 넣지 않고 환경변수로만 사용한다. 고유명사 오류는 후속 보정 대상이다.
수정할 파일: VID-01-01(기존 코드 확인) 완료 후 기재
연결 일감¶
선행: VID-02-02 / 후행: VID-02-04
예상 공수: VID-00 검증 결과 후 확정
성양 Updated by 성용 양 26 days ago
- Follows Feature #688: [VID-02-02] 음성 추출·시간 구간 분할·원본 시작 시간 기록 added
성양 Updated by 성용 양 26 days ago
- Precedes Feature #690: [VID-02-04] 1차 분석: 예배 순서·설교 후보 구간 탐색 added
성양 Updated by 성용 양 23 days ago
방향 참고 (VID-00-03 시험 결과 반영)¶
VID-00-03(#670)의 시험에서 무료 로컬 모델(faster-whisper + Whisper Small)로 5분을 약 45초에 전사할 수 있음을 확인했습니다(GitHub PR #63). 팀 문서는 "기본은 무료 로컬 전사, OpenAI(gpt-transcribe) API는 품질이 부족할 때 승인 후에만"을 제안합니다. 이 일감의 STT 연동 방식은 이 제안을 PM이 확정한 뒤 정합니다. 확정 전에는 전사 방식을 바꿀 수 있는 구조(공통 인터페이스)로 설계해 두는 것이 안전합니다.
성양 Updated by 성용 양 15 days ago
- Status changed from New to In Progress
- % Done changed from 0 to 80
2026-11-02 GitHub 반영¶
실제 57분 50초 설교의 전사(구간 1,639개, TXT 106,968바이트, 로컬 전사 421초)·저장·공개 다운로드 종단 검증이 완료되었습니다(PR #85). 전사가 끝난 경우에만 공개 게시물에 스크립트 다운로드 버튼이 표시됩니다. 사람 검수 품질과 운영 검증은 남아 있어 80%로 둡니다. 근거: PR #89(병합)와 PR #85(병합 없이 닫힘, 종단 검증 기록). 코드는 병합되었지만 운영 환경 검증과 GitHub Actions CI 재실행(저장소 Actions 예산 제한으로 보류)은 남아 있어 완료로 하지 않습니다.