뷰닷 메이커 사용법

1. 앱 접속하기 (회사 전용 비밀번호)

• 관리자가 회사 전용 접근 비밀번호(APP_ACCESS_PASSWORD)를 설정해두었다면, 접속 시 비밀번호 입력 화면이 먼저 나타납니다. 회원가입이나 이메일 로그인이 아니라, 정해진 공통 비밀번호 하나만 입력하면 되는 간단한 화면입니다.
• 관리자에게 받은 비밀번호를 입력하고 "입장하기"를 누르면 원래 가려던 화면으로 이동합니다.
• 한 번 입력하면 최대 24시간 동안 다시 입력하지 않아도 됩니다.
• 비밀번호가 설정되어 있지 않다면(로컬 개발 환경 등) 이 화면 없이 바로 접속됩니다.
• 인증된 상태에서는 화면 상단 메뉴 오른쪽에 "로그아웃"이 나타납니다. 다른 사람과 같이 쓰는 컴퓨터라면 사용 후 눌러주세요.

2. 작업 전 준비

• 업로드 파일은 최대 20개까지 가능하며, 파일 1개당 최대 300MB, 전체 업로드 용량 합계 최대 1024MB까지 업로드할 수 있습니다(관리자가 .env에서 조정 가능). 한 작업의 전체 영상 길이는 최대 20분이며, 한도를 넘으면 화면에 안내 문구가 표시됩니다.
• 틱톡 URL은 최대 5개까지 입력할 수 있습니다.
• 업로드된 영상은 화면에서 별도로 조작하지 않아도 서버에서 자동으로 1080p/30fps 이하의 "작업용 영상"으로 변환되어 분석·편집에 사용됩니다 (자세한 내용은 아래 "7. 업로드 제한과 작업용 영상 변환" 참고).

3. 업로드 콘텐츠 권리 확인 책임

직접 업로드한 mp4든, 틱톡 URL로 가져온 영상이든 동일하게 적용됩니다. 업로드 전에 본인 또는 소속 회사가 사용 권한을 가진 영상인지 반드시 확인해 주세요.

(참고: 지금은 회사 내부용으로만 사용하며, 판매용 전환 시 회원가입/로그인, 요금제, 관리자 권한을 추가하고 틱톡 URL 가져오기 기능은 관리자 계정에만 노출할 예정입니다.)

4. 숏폼 생성 순서

"숏폼 생성" 화면은 왼쪽(기본설정 + 설정탭)과 오른쪽(생성/결과) 2단 구성입니다. 설정탭은 편집설정 / 자막설정 / 음성설정 3개이며, 자막설정·음성설정은 플랜에 따라 잠겨 있을 수 있습니다 (아래 "5. 설정탭과 플랜" 참고).

1. [기본설정] 업종 템플릿을 선택합니다.
2. [기본설정] mp4 파일을 업로드하거나 틱톡 URL을 입력합니다.
3. [편집설정 탭] 목표 영상 길이, 화면 맞춤 방식, 원본 영상 소리 사용 여부(체크박스, 기본값 체크 해제)를 설정합니다. 영상 비율/장면 전환/좌우반전/확대/밝기 보정/대본 문장 스타일 등 나머지 편집 옵션도 이 탭에 있습니다.
4. [자막설정 탭] (잠겨 있지 않다면) 자막 추가 여부, 위치, 스타일, 크기를 선택합니다. 미리보기 카드에 바로 반영됩니다.
5. [음성설정 탭] (잠겨 있지 않다면) Typecast 성우를 선택합니다. (등록된 음성이 있을 때만 나타나며, 이름만 보입니다. 자주 쓰는 음성은 이름 옆 별표(☆)를 눌러 즐겨찾기로 등록하면 목록 맨 위에 표시됩니다)
6. [오른쪽 패널] 다운로드 파일명을 입력합니다. (선택 사항, 입력하지 않으면 자동으로 이름이 붙습니다)
7. [오른쪽 패널] "생성 시작" 버튼을 누릅니다. 진행 상태와 생성 결과, 다운로드 버튼이 모두 오른쪽 패널에 표시됩니다.

숏폼 생성 화면으로 이동

5. 설정탭과 플랜

"숏폼 생성" 화면의 기본설정 아래에는 편집설정/자막설정/음성설정 3개 탭이 있으며, 관리자가 설정한 플랜(VIEWDOT_PLAN)에 따라 일부 탭이 잠겨 있을 수 있습니다.

• 편집설정: 항상 사용 가능합니다.
• 자막설정: 프로 플랜 이상에서 사용 가능합니다. 잠겨 있으면 탭에 "🔒 잠김" 표시가 붙고, 탭 안에는 "자막설정은 프로 플랜 이상에서 사용할 수 있습니다."라는 안내가 나옵니다. 켜두면 최종 영상에 선택한 위치/스타일/크기로 자막이 실제로 입혀집니다 (자막 문구는 각 장면의 나레이션 대사를 그대로 사용합니다).
• 음성설정: 울트라 플랜에서만 사용 가능합니다. 잠겨 있으면 "음성설정은 울트라 플랜에서 사용할 수 있습니다."라는 안내가 나오고, Typecast 음성 생성 자체가 시도되지 않습니다.
• 잠긴 탭도 클릭해서 내용은 볼 수 있지만, 안의 설정 항목은 흐리게 표시되며 선택할 수 없습니다.
• 회사 내부 사용 환경에서는 보통 플랜이 "울트라"로 설정되어 있어 모든 탭을 사용할 수 있습니다. 탭이 잠겨 있다면 관리자에게 문의하세요.

6. 화면 맞춤 방식

원본 영상 비율과 출력 비율(9:16/1:1/16:9)이 다를 때 화면을 채우는 방식을 선택할 수 있습니다.

• 중앙 크롭(기본값): 화면을 꽉 채우지만 가장자리가 잘릴 수 있습니다. 지금까지의 기본 동작과 동일합니다.
• 블러 배경 채우기: 원본 화면을 최대한 보존하고, 남는 영역은 흐린 배경으로 채웁니다. 가로 영상을 세로 숏폼으로 만들 때 특히 유용합니다.

"숏폼 생성" 화면의 편집설정 탭에서 선택할 수 있으며, 결과 화면과 작업 이력에 "화면 맞춤 방식: 중앙 크롭" 또는 "화면 맞춤 방식: 블러 배경 채우기"로 표시됩니다.

7. 업로드 제한과 작업용 영상 변환

• 업로드 파일은 최대 20개까지 가능하며, 파일 1개당 최대 300MB, 전체 업로드 용량 합계 최대 1024MB까지 업로드할 수 있습니다 (관리자가 .env에서 값을 조정할 수 있습니다). 한 작업의 전체 영상 길이는 최대 20분이며, 한도를 넘으면 화면에 어떤 한도를 넘었는지 안내가 표시됩니다.
• 업로드된 영상은 화질/프레임이 아무리 높아도(예: 4K, 60fps) 서버에서 자동으로 1080p(가로세로 최대 1080x1920), 30fps 이하의 "작업용 영상"으로 변환됩니다. 이미 그 이하인 영상은 화질을 더 낮추거나 늘리지 않고 그대로 사용됩니다.
• AI 편집 계획(Gemini 분석)과 실제 영상 자르기(FFmpeg 편집) 모두 원본이 아니라 이 작업용 영상 기준으로 진행됩니다. 최종 결과물은 숏폼용으로 1080p면 충분하므로 화질 저하를 걱정하지 않아도 됩니다.
• 변환에 실패한 파일이 있으면 화면에 안내가 표시되고, 그 파일은 편집 대상에서 자동으로 제외됩니다 (나머지 파일로는 정상적으로 생성이 진행됩니다).
• 결과 화면과 작업 이력(/jobs)에서 "원본 파일 수 / 원본 총 길이 / 총 업로드 용량 / 작업용 영상 변환 완료 여부"를 확인할 수 있습니다.
• 이번 단계에서는 영상을 자동으로 여러 개로 쪼개는 기능은 없습니다 — 총 길이 한도를 넘으면 분할이 아니라 오류로 안내합니다.

8. 원본 영상 소리 사용

기본적으로 최종 영상에는 업로드한 원본 영상의 소리가 들어가지 않습니다. 매장 소음, 현장음 등 원본 소리를 살리고 싶다면 "숏폼 생성" 화면의 편집설정 탭에 있는 "원본 영상 소리 사용" 체크박스를 켜면 됩니다.

• 체크 해제(기본값): 지금까지와 동일하게 원본 소리 없이 생성됩니다.
• 체크: 원본 소리를 원래 크기 그대로 최종 영상에 포함합니다.
• 자동음성(Typecast)과 함께 사용해도 문제없습니다. 이때는 원본 소리에 자동음성이 묻히지 않도록, 음성이 항상 더 크게 들리게 자동으로 섞습니다.
• 결과 화면과 작업 이력에 선택한 옵션이 표시됩니다.

9. 결과물 확인

• 생성이 완료되면 최종 무음 영상 미리보기를 확인합니다.
• final_video_no_voice.mp4를 다운로드합니다.
• script.txt를 다운로드합니다.
• Typecast API가 설정되어 있다면 voice.mp3(자동 생성된 음성)도 바로 다운로드할 수 있습니다.
• 음성 생성까지 성공하면 final_video_with_voice.mp4(음성 포함 최종 영상)도 자동으로 만들어져 미리보기와 다운로드가 가능합니다.
• edit_plan.json은 편집 계획 확인용입니다.
• 작업 이력 페이지에서 이전 결과물을 다시 확인할 수 있습니다.
• 관리자가 Google Cloud Storage 연동을 설정해두었다면, 서버(Cloud Run)가 재시작되어도 생성된 결과물을 계속 다운로드할 수 있고, "작업 이력"(/jobs) 목록도 자동으로 복구됩니다. 클라우드에 저장된 작업은 목록에 "☁ 클라우드 저장됨"으로 표시되며, 버킷 이름이나 내부 저장 경로는 화면에 노출되지 않습니다. 설정되어 있지 않거나 클라우드 저장소를 일시적으로 읽지 못하면 로컬에 남아있는 작업 이력만 표시됩니다(화면 전체가 오류로 이어지지 않습니다).
• 결과물이 마음에 들지 않으면 설정을 확인한 뒤 "생성 시작"을 다시 눌러 새로 만들 수 있습니다. 여러 번 생성한 결과는 모두 "작업 이력"(/jobs)에서 확인하고 다운로드할 수 있습니다.

다운로드되는 파일명에는 작업명이 반영됩니다. 예: 작업명이 "고반식당 7월 숏폼"이면 고반식당_7월_숏폼_final_with_voice.mp4, 고반식당_7월_숏폼_script.txt처럼 저장되어 여러 작업을 받아도 헷갈리지 않습니다. (서버에 실제로 저장되는 파일명·폴더 구조는 그대로입니다.)

작업 이력 페이지로 이동

10. Typecast / CapCut 마무리

Typecast API가 설정되어 있으면 voice.mp3와 final_video_with_voice.mp4(음성 포함 최종 영상)까지 자동으로 생성됩니다. "숏폼 생성" 화면에서 고른 음성 이름이 결과 화면과 작업 이력에 함께 표시됩니다 (음성 ID는 보이지 않습니다). final_video_with_voice.mp4는 업로드 전 바로 확인용으로 사용할 수 있습니다. 자막/BGM/로고를 추가하려면 여전히 CapCut 등에서 편집해야 합니다.

자주 쓰는 음성은 이름 옆 별표를 눌러 즐겨찾기로 등록할 수 있습니다. 즐겨찾기한 음성은 목록 맨 위에 노란 별(★)로 표시되어 다음에 더 빠르게 찾을 수 있습니다. 이 즐겨찾기는 지금 사용 중인 브라우저에만 저장되며(다른 컴퓨터나 브라우저에서는 보이지 않음), 실제 음성 생성 결과에는 전혀 영향을 주지 않습니다.

음성의 속도/피치/감정은 관리자가 .env에서 미리 설정해두며, 결과 화면과 작업 이력에 "음성 설정: 속도 1.05 / 피치 0 / 감정 smart"처럼 함께 표시됩니다 (직원이 매번 고르지 않습니다). 자세한 설정 방법은 README.md의 "Typecast API 설정" 참고.

Typecast API가 설정되어 있지 않거나, 음성 생성 또는 음성 포함 최종 영상 합성에 실패했다면 아래대로 직접 진행하세요.

1. script.txt를 열어 대본을 복사합니다.
2. Typecast에 붙여넣어 음성을 생성합니다.
3. 생성된 음성 파일을 다운로드합니다.
4. CapCut에서 final_video_no_voice.mp4를 불러옵니다.
5. (자동 생성된 또는 직접 만든) Typecast 음성을 넣고 최종 편집합니다.
6. 필요하면 자막, BGM, 로고 등을 CapCut에서 추가합니다.

11. 주의사항

• 직접 업로드한 영상이든 틱톡 URL로 가져온 영상이든, 원본 소리 사용 여부는 "원본 영상 소리 사용" 옵션(사용 안 함/작게 사용/그대로 사용) 설정에 따라 동일하게 처리됩니다.
• 영상이 부족하면 최종 영상이 목표 길이보다 짧게 생성될 수 있습니다.
• 비슷한 장면이 많으면 결과물이 반복되어 보일 수 있으므로 다양한 구도의 영상을 준비하는 것이 좋습니다.

12. 권장 영상 구성

13. 자주 발생하는 문제

14. 요금제와 dot

뷰닷의 사용량 단위는 "dot"이며, 플랜별 가격/제공 dot/기능 범위가 정해졌습니다. 자세한 내용은 요금제 페이지에서 확인하세요.

• 유료 플랜은 라이트/프로/비즈니스이며(무료 플랜은 테스트용), 프로 이상은 자동자막, 비즈니스는 자동음성 생성(Typecast 기반)까지 사용할 수 있습니다.
• 구독 플랜의 월 제공 dot을 모두 사용하면, 10,000 dot 단위로 추가 dot을 구매할 수 있는 옵션이 준비되어 있습니다 (추가 dot 구매 페이지 참고).
• 여러 명이 동시에 자동음성을 요청해도 Typecast 동시 호출 한도 때문에 실패하지 않도록 내부적으로 순서를 조절하고, 일시적인 오류는 자동으로 몇 차례 재시도합니다. dot은 성공한 작업 기준으로만 확정 차감할 예정이며, 한도 초과나 일시 오류로 실패한 경우는 차감하지 않습니다.
• 아직 회원가입/결제/실제 dot 잔액 차감 기능은 없습니다 — 이번 단계는 정책·안전장치·화면 표시까지만 준비된 상태입니다.