도구별 실전 가이드 · 공식 정보 확인 2026-08-20

whisper-website MIT 오픈소스 조건과 시작 절차

작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: Self-hosted, Web · 페이지 갱신: · 운영·편집 기준

Whisper로 오디오 파일을 자막으로 바꾸는 단순한 FastAPI 웹 애플리케이션이다.

Whisper로 오디오 파일을 자막으로 바꾸는 단순한 FastAPI 웹 애플리케이션이다. whisper-website의 첫 실전 과제는 “로컬에서 서버를 띄워 작은 오디오를 SRT로 변환한다”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.

이럴 때 맞습니다

  • “1분 영어 WAV에서 타임코드 자막 생성” 같은 입력으로 whisper-website의 핵심 기능을 시험하려는 사람
  • 업로드 한 건에 출력 파일 하나가 생기고 타임코드가 전체 재생 길이를 넘지 않는지 본다. 기준으로 whisper-website 결과를 직접 검수할 수 있는 경우
  • Self-hosted·Web 환경에서 MIT 코드를 직접 설치·관리하려는 작업

이럴 때는 멈추세요

  • 셀프호스트 웹 앱 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
  • 다음 위험을 사람이 확인할 수 없는 작업: 업로드 엔드포인트를 인증 없이 공개하면 타인이 민감 파일을 올리거나 연산 자원을 고갈시킬 수 있다.

참고 시작점

팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.

FastAPI 서버에서 WAV를 자막으로 변환

자가 호스팅 웹 엔드포인트에 1분 WAV를 올려 타임코드 자막 한 개를 받는다.

참고 시작점: 1분 영어 WAV에서 타임코드 자막을 생성해 줘.

  1. Uvicorn으로 FastAPI 애플리케이션을 로컬 인터페이스에만 실행한다.
  2. WAV 복사본을 업로드해 Whisper 처리가 끝날 때까지 요청 상태를 확인한다.
  3. subtitles 파일이 하나만 생기고 마지막 타임코드가 오디오 길이를 넘지 않는지 본다.

잘못된 파일 업로드 실패 확인

오디오가 아닌 파일과 빈 파일을 서버가 처리하지 않고 명확히 거부하는지 점검한다.

참고 시작점: 빈 WAV와 텍스트 파일을 시험 업로드하고 오류만 기록해 줘.

  1. FastAPI 업로드에 빈 WAV를 보내고 HTTP 오류와 서버 로그를 저장한다.
  2. Uvicorn을 재시작하지 않은 채 텍스트 파일을 보내 Whisper 작업이 생성되지 않는지 확인한다.
  3. 정상 subtitles 파일과 실패 요청의 출력 위치가 섞이지 않았는지 본다.

공개 엔드포인트와 연산 고갈 차단

인증 없는 외부 업로드가 서버 자원과 민감 파일 저장소에 닿지 않게 한다.

참고 시작점: 외부 접속과 동시 대량 업로드를 막고 로컬 한 건만 허용해 줘.

  1. Uvicorn 바인딩을 로컬 주소로 제한하고 FastAPI 업로드 크기와 동시 작업 수를 확인한다.
  2. 큰 시험 파일을 보내 Whisper 작업이 한도 전에 거부되는지 본다.
  3. subtitles 출력과 업로드 임시 파일을 지우고 외부 주소에서 엔드포인트가 열리지 않는지 확인한다.

무료 조건과 주의점

MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도

MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도

MIT 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.

업로드 엔드포인트를 인증 없이 공개하면 타인이 민감 파일을 올리거나 연산 자원을 고갈시킬 수 있다.

직접 대안과 비교

  • Whisper-WebUI — Whisper-WebUI도 브라우저에서 오디오를 올려 Whisper 자막을 생성하므로, 같은 1분 WAV와 언어·타임코드 기준으로 비교할 수 있다.
  • whishper — whishper 역시 셀프호스트 웹 화면에서 오디오를 전사해 자막으로 내보내므로, 동일 파일을 사용한 결과 검수가 가능하다.

공식 근거와 확인일

whisper-website 가이드의 주장별 공식 출처
확인 항목확인한 내용공식 출처·확인일
제품 정보Whisper로 오디오 파일을 자막으로 바꾸는 단순한 FastAPI 웹 애플리케이션이다.whisper-website 공식 사이트
무료 조건MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도공식 무료 정책·요금 안내
공식 코드 라이선스오픈소스 코드의 사용·수정·재배포 조건공식 코드 라이선스
공식 제품 페이지Whisper로 오디오 파일을 자막으로 바꾸는 단순한 FastAPI 웹 애플리케이션이다.공식 제품 페이지