⚙️ API 키 설정

키는 config/settings.yaml에 저장됩니다

🤖 Anthropic API Key *

대본·재료·블로그 생성에 사용

✨ Gemini API Key

Step 0 경쟁 영상 리서치에 사용

🎙️ ElevenLabs API Key (선택)

음성 자동 생성에 사용 (없으면 건너뜀)

🤖 Claude 모델

🎨 콘텐츠 톤

👥 타겟 시청자

Step 0 — 경쟁 영상 리서치

Gemini AI · 선택

소재 파일

Step 1 — 제목 + 썸네일 + 대본

Claude AI

소재 파일

Step 2 — 영상 재료 일괄 생성

Claude AI

출력 폴더 (대본)

소재 파일

숏폼 (60초)

Step 3-A — Imagen 3 자동 생성

Google AI · 완전 자동

출력 폴더

💡 Step 2에서 생성된 이미지 프롬프트를 Google Imagen 3로 자동 생성합니다.
비용: 약 $0.04/장 × 프롬프트 수 (Gemini API 키 필요)

Step 3-B — 수동 이미지 생성

수동

출력 폴더

🎨 Whisk 열기 🍌 나노바나나 열기

출력 폴더를 선택하면 프롬프트가 표시됩니다

Step 4 — Vrew 편집 가이드

수동

출력 폴더

🎬 Vrew 열기

출력 폴더를 선택하세요

Step 5 — 블로그 글 생성

Claude AI · 선택

YouTube URL

출력 폴더

Step 6 — 영상 자동 빌드

MoviePy + Whisper · 완전 자동

출력 폴더 (이미지 + 음성 필요)

출력 폴더를 선택하세요

💡 02_images/ 이미지 + 01_voice/ 음성 → MP4 영상 자동 합성
Whisper(자막) · FFmpeg(자막 삽입) 설치 시 자막 자동 추가
필수: pip install moviepy 선택: pip install faster-whisper

Step 7 — YouTube 자동 업로드

YouTube Data API v3

출력 폴더 (영상 파일 필요)

공개 설정

💡 OAuth 최초 실행 시 브라우저 인증 팝업이 뜹니다 (서버 터미널에서 진행).
사전 준비: Google Cloud Console → YouTube Data API v3 활성화 →
OAuth 클라이언트 ID(데스크톱) 생성 → config/youtube_client_secrets.json 저장

📖 사용 매뉴얼

YouTube 자동화 플랫폼

🎬 YouTube 자동화 플랫폼

소재 하나로 리서치 → 대본 → 이미지 → 음성 → 편집 → 업로드까지
전 과정을 AI가 자동으로 처리합니다. 아래 순서대로 진행하세요.

전체 워크플로우

⚙

API 설정

Gemini 키 입력

→

리서치

경쟁 영상 분석

→

대본 생성

제목·썸네일·스크립트

→

재료 생성

프롬프트·가이드·메타

→

이미지

Whisk / 자동생성

→

Vrew 편집

영상 편집 가이드

→

영상 빌드

MP4 자동 합성

→

업로드

YouTube 자동 게시

💡 선택 단계: Step 0 리서치, Step 5 블로그, Step 6 영상 빌드, Step 7 업로드는 필요할 때만 사용합니다. 최소 필수 경로는 API 설정 → Step 1 → Step 2 → Step 3(수동) → Vrew 편집 → 업로드입니다.

⚙️ API 설정

시작 전 필수

Gemini

Gemini API Key

모든 AI 생성(리서치·대본·재료·블로그) 필수 · aistudio.google.com에서 무료 발급

필수

ElevenLabs

ElevenLabs API Key

AI 음성 더빙 자동 생성 · 없으면 건너뜀 (Vrew TTS로 대체 가능)

선택

YouTube

YouTube Data API v3

Step 7 자동 업로드용 · Google Cloud Console에서 OAuth 설정 필요

선택

🔑 Gemini 키 발급: aistudio.google.com → 로그인 → 왼쪽 메뉴 "Get API key" → "Create API key" → 복사 후 붙여넣기

🔍

Step 0 — 경쟁 영상 리서치

선택

소재 파일 선택 후 리서치 시작 클릭

Gemini가 키워드 10개, 경쟁 영상 유형 5가지, 차별화 전략, SEO 전략 자동 분석

결과를 참고해 소재를 보완하거나 그대로 Step 1로 진행

건너뛰어도 Step 1에서 충분히 좋은 결과가 나옵니다

✍️

Step 1 — 대본 생성

핵심

소재 파일 선택 후 대본 생성 클릭 (1~3분 소요)

제목 탭: 클릭률 높은 제목 3가지 후보 생성

썸네일 탭: 3~5단어 임팩트 문구

대본 편집 탭: 직접 수정 가능, 💾 저장 필수

🎙️ 더빙용 변환: 마크다운 기호 제거 → Vrew·ElevenLabs 붙여넣기용

⚡

Step 2 — 재료 일괄 생성

핵심

출력 폴더 (Step 1 결과)와 소재 파일 선택

롱폼(15장) / 숏폼 체크 시 8장으로 생성

[1/3] 이미지 프롬프트 · [2/3] Vrew 가이드+타임라인 · [3/3] 메타데이터 자동 생성

이미지 프롬프트 탭에서 각 장면별 📋 복사 → Whisk/나노바나나 붙여넣기

🎨

Step 3 — 이미지 생성

수동/자동

3-A 자동: Gemini API로 Imagen 3 이미지 자동 생성 (약 $0.04/장)

3-B 수동: 프롬프트 복사 → Whisk 또는 나노바나나에 붙여넣기

생성한 이미지를 output/[타임스탬프]/02_images/에 저장

파일명 규칙: 01_intro.png, 02_scene.png 순서대로

🎬

Step 4 — Vrew 편집

수동

Vrew 실행 → 새 프로젝트 → 음성 파일 (01_voice/narration.mp3) 불러오기

음성이 없으면 Vrew 내장 TTS에 더빙용 텍스트 붙여넣기 (Step 1 더빙용 변환 활용)

편집 가이드 탭: 자막 스타일, BGM, 전환 효과 설정 참고

타임라인 탭: 이미지 배치 시간 순서 참고

완성 후 MP4 내보내기 (1080p, H.264)

📝

Step 5 — 블로그 글 생성

선택

YouTube 업로드 후 영상 URL 입력

대본 기반으로 SEO 최적화 블로그 포스팅 자동 생성 (1200~1800자)

H1/H2 구조, YouTube 임베드 섹션, 해시태그 10개 포함

📋 복사 후 네이버 블로그 / 티스토리에 붙여넣기

🎞️

Step 6 — 영상 자동 빌드

선택

이미지(02_images/) + 음성(01_voice/) 준비 필수

MoviePy로 MP4 자동 합성, Whisper 설치 시 자막 자동 추가

사전 설치: pip install moviepy

자막 추가: pip install faster-whisper (선택)

Vrew 편집을 선호하면 이 단계를 건너뜁니다

🚀

Step 7 — YouTube 업로드

선택

Google Cloud Console → YouTube Data API v3 활성화 필요

OAuth 클라이언트 ID(데스크톱) 생성 → config/youtube_client_secrets.json 저장

최초 실행 시 브라우저 인증 팝업 → 서버 터미널에서 승인

공개 설정: 비공개로 업로드 후 직접 확인하고 공개 변경 권장

❓ 자주 묻는 질문

FAQ

Gemini API 키는 어디서 받나요?

aistudio.google.com에 접속 → 구글 계정 로그인 → 왼쪽 메뉴 "Get API key" → "Create API key" 클릭 → AIzaSy... 형식의 키 복사 → API 설정에 붙여넣기. 무료로 사용 가능합니다.

음성 파일은 어떻게 만드나요?

3가지 방법이 있습니다. ① Vrew 내장 TTS — 대본 붙여넣기 후 AI 목소리 선택 (가장 간단). ② ElevenLabs API 키를 설정에 입력하면 자동 생성. ③ elevenlabs.io에서 수동으로 mp3 다운로드 후 01_voice/narration.mp3로 저장.

대본에 특수기호(**,---, [섹션] 등)가 많아요.

Step 1 → 대본 편집 탭 → 🎙️ 더빙용 변환 버튼을 누르면 마크다운 기호, 섹션 라벨, 수평선 등이 모두 제거된 더빙용 텍스트가 아래에 생성됩니다. 📋 복사 후 Vrew에 붙여넣으세요.

이미지는 몇 장 만들어야 하나요?

롱폼(5~10분)은 15장, 숏폼(60초)은 8장이 기본입니다. Step 2에서 숏폼 체크박스로 선택합니다. 각 이미지는 보통 3~6초씩 화면에 표시됩니다.

서버 없이 실행하려면 어떻게 하나요?

index.html을 브라우저에서 직접 열면 됩니다. AI 생성 기능은 Gemini API를 브라우저에서 직접 호출합니다. 단, Step 6(영상 빌드)·Step 7(업로드)은 Python 서버(플랫폼실행.bat) 가 필요합니다.

생성한 결과물은 어디에 저장되나요?

브라우저 모드: localStorage에 자동 저장 (브라우저 닫아도 유지). 서버 모드: C:\YouTube\output\[YYYYMMDD_HHMMSS]\ 폴더에 저장. 왼쪽 사이드바 "생성 목록"에서 이전 작업을 불러올 수 있습니다.

📁 출력 폴더 구조

output/[타임스탬프]/

output/

└── 20260317_143000/

    ├── 00_script/      ← 대본, 제목, 썸네일

    │   ├── script.txt    ← 편집 가능한 최종 대본

    │   ├── title.txt

    │   └── thumbnail.txt

    ├── 01_voice/       ← 음성 파일

    │   └── narration.mp3 ← ElevenLabs 생성

    ├── 02_images/      ← 이미지 저장 위치 (수동)

    │   ├── 01_intro.png

    │   └── 02_scene.png ...

    ├── 03_prompts/     ← 이미지 생성 프롬프트

    ├── 04_guide/       ← Vrew 편집 가이드 + 타임라인

    ├── 05_metadata/    ← 업로드 제목·설명·태그

    ├── 06_blog/        ← 블로그 포스팅

    └── 07_video/       ← 완성 MP4 영상