animily_music/docs/PROJECT_PLAN.md

Animily Music 프로젝트 계획

반려동물 음악 유튜브 롱폼 자동 생성 파이프라인

---

개요

항목	값
서버	192.168.0.46 (AI 서버)
프로젝트 경로	/home/javamon/project/animily_music/
음악 생성	ACE-Step 1.5 (localhost:8001)
이미지 생성	FLUX via ComfyUI (localhost:8188)
영상 합성	ffmpeg
업로드	YouTube Data API (롱폼)
크론탭	매주 토요일 02:00 (주석 처리 상태)
기존 코드	절대 수정 금지 (완전 독립 프로젝트)

---

음악 생성 전략

ACE-Step 제한

• 1회 최대 생성: 10분 (600초)
• 세그먼트 방식으로 긴 곡 구성

길이별 구성

영상 길이	음악 생성	방식
2시간 (기본)	10분 × 12세그먼트 = ~119분	크로스페이드 이어붙이기
6시간	2시간 음악 × 3회 반복	ffmpeg loop
12시간	2시간 음악 × 6회 반복	ffmpeg loop

세그먼트 이어붙이기 규칙

• 12개 세그먼트 각각 약 10분 (595초) 생성
• 세그먼트 간 5초 크로스페이드 → 약 119분 완성
• 동일 key/BPM 유지, caption만 미세 변주 (단조로움 방지)
• 마지막 세그먼트는 자연스러운 페이드아웃

---

영상 구성

화면

요소	위치	상세
배경 이미지	전체 화면	FLUX 생성 (1920×1080, 16:9)
Ken Burns 효과	전체	미세한 줌인/패닝 (정지 느낌 방지)
워터마크	우측 상단	영상 처음부터 끝까지 상시 표시

워터마크 상세

항목	값
텍스트	ANIMILY
위치	우측 상단 (x=w-tw-80, y=40)
폰트	ONE Mobile OTF Bold (/usr/share/fonts/truetype/ONE_Mobile_Bold.otf)
폰트 크기	36 (롱폼 16:9 기준)
색상	white @ 40% 투명도
그림자	black @ 30%, offset (1,1)
표시 시간	영상 전체 (처음부터 끝까지 상시)

ffmpeg 워터마크 필터

drawtext=text='ANIMILY':fontfile=/usr/share/fonts/truetype/ONE_Mobile_Bold.otf:fontsize=36:fontcolor=white@0.4:x=w-tw-80:y=40:shadowcolor=black@0.3:shadowx=1:shadowy=1

참고: 기존 쇼츠(1080x1920 세로)는 fontsize=30, x=w-tw-25, y=25 롱폼(1920x1080 가로)은 비율에 맞게 조정

이미지 스타일

• 화풍: 신카이 마코토 스타일
• 주제: 반려동물 + 자연 풍경 (평화로운 분위기)
• 해상도: 1920×1080 (16:9 가로)
• 영상당 1장 생성 (썸네일 겸용)

FLUX 프롬프트 예시

makoto shinkai style, dreamy golden hour sky with layered clouds,
a peaceful meadow with a sleeping puppy curled up in soft grass,
warm sunlight filtering through trees, detailed sky gradients,
soft bokeh, cinematic wide shot composition, 8k quality, no text, no watermark

---

유튜브 업로드 설정

메타데이터

항목	값
카테고리	음악 (10)
공개 설정	즉시 공개 (public)
재생목록	뮤직큐우 (PLr8dPYZT-hCUjL-OgPxJdF81Dvn_g8Vbg)

제목 형식

🐕 강아지가 좋아하는 음악 2시간 | 수면음악, 분리불안 완화 [과학적 검증]
🐱 고양이가 편안해지는 음악 6시간 | 퍼링 주파수 기반 [수면, 휴식]
🐾 반려동물 힐링 음악 12시간 | 솔로 피아노, 스트레스 해소

설명 (description)

{title}

🎵 저작권 프리 음악 (Copyright Free)
본 음악은 AI로 생성된 저작권 프리 음악입니다.
개인/상업적 용도 모두 자유롭게 사용하실 수 있습니다.
출처 표기 없이 자유롭게 사용 가능합니다.

🎵 Copyright Free Music
This music is AI-generated and copyright-free.
Free to use for any personal or commercial purpose.
No attribution required.

━━━━━━━━━━━━━━━━━━━━━━━━

🔬 과학적 근거
• University of Glasgow + Scottish SPCA (2017): 레게/소프트록에서 개 스트레스 최소
• Through a Dog's Ear (2008): 50-60 BPM 솔로 피아노에서 70%+ 진정 반응
• Snowdon & Teie (2015): 고양이는 퍼링 주파수(25-50Hz)에 긍정 반응

━━━━━━━━━━━━━━━━━━━━━━━━

🐾 반려동물 행동교정 플랫폼 애니밀리
📲 앱 다운로드: 앱스토어/구글플레이에서 '애니밀리' 검색
🌐 https://conimals.co.kr/

🤖 AI 생성 음악 (ACE-Step 1.5)

#반려동물음악 #강아지수면음악 #고양이음악 #펫힐링 #저작권프리
#dogmusic #catmusic #petrelaxation #copyrightfree #royaltyfree

고정 댓글

🎵 저작권 프리 음악입니다!
개인/상업적 용도 모두 자유롭게 사용하세요.
출처 표기 불필요, 다운로드 자유 ✅

🎵 This is copyright-free music!
Free for personal and commercial use.
No attribution needed ✅

---

프로젝트 구조

/home/javamon/project/animily_music/
├── config.py                # 설정 (API URL, 경로, 채널 정보)
├── generate_music.py        # ACE-Step API → 12세그먼트 생성 + 크로스페이드
├── generate_image.py        # FLUX (ComfyUI API) → 신카이 마코토 이미지
├── render_video.py          # 이미지 + 음악 + 워터마크 → ffmpeg 영상
├── upload_youtube.py        # YouTube Data API 롱폼 업로드 + 고정댓글
├── scheduler.py             # 메인 오케스트레이터
├── prompts/
│   ├── dog_music.json       # 강아지 음악 프롬프트 (과학 기반)
│   ├── cat_music.json       # 고양이 음악 프롬프트 (퍼링 기반)
│   └── image_prompts.json   # FLUX 이미지 프롬프트 (신카이 스타일)
├── outputs/                 # 임시 생성물 (영상 완성 후 정리)
├── logs/
├── token_animily.pickle     # YouTube OAuth token
├── requirements.txt
└── venv/

---

모듈별 역할

generate_music.py

1. 프롬프트 로드 (dog/cat 랜덤 or 스케줄)
2. ACE-Step API에 10분 세그먼트 12개 순차 요청
3. 각 세그먼트 동일 key/BPM, caption만 변주
4. pydub로 5초 크로스페이드 이어붙이기
5. 최종 ~119분 WAV 출력

generate_image.py

1. FLUX 프롬프트 로드 (신카이 마코토 + 반려동물)
2. ComfyUI API (localhost:8188) 호출
3. 1920×1080 이미지 1장 생성
4. 썸네일용 리사이즈 (1280×720) 별도 저장

render_video.py

1. ffmpeg: 이미지 → Ken Burns 효과 (미세 줌/패닝)
2. 워터마크 "ANIMILY" 우측 상단 오버레이
3. 오디오 합성
4. 6시간/12시간은 2시간 영상을 ffmpeg concat으로 반복
5. 출력: MP4 (H.264 + AAC)

upload_youtube.py

1. YouTube Data API v3 (OAuth2)
2. 영상 업로드 (public, 카테고리: 음악)
3. 재생목록 추가/생성
4. 고정 댓글 작성 (저작권 프리 안내)

scheduler.py

1. 콘텐츠 종류 결정 (강아지/고양이/혼합, 길이)
2. generate_music → generate_image → render_video → upload
3. 완료 후 outputs/ 정리
4. 로그 기록

---

크론탭

# 반려동물 음악 롱폼 (매주 토요일 02:00) - 비활성
# 0 2 * * 6 cd /home/javamon/project/animily_music && /home/javamon/project/animily_music/venv/bin/python scheduler.py >> /home/javamon/project/animily_music/logs/cron.log 2>&1

---

GPU 리소스 충돌 방지

• 기존 auto_shorts 스케줄: 01:01 (프리캐시) → 03:00 (영상 생성)
• animily_music: 토요일 02:00 → auto_shorts와 시간 겹침 없음 (토요일만)
• ACE-Step과 FLUX/ComfyUI는 순차 실행 (동시 사용 시 OOM)
• 순서: ACE-Step 음악 생성 → ACE-Step 종료 → ComfyUI FLUX 이미지 → 종료 → ffmpeg 렌더

---

콘텐츠 스케줄 (주 1회)

주차	대상	길이	비고
1주	강아지 수면음악	2시간	솔로 피아노
2주	고양이 릴렉스	2시간	퍼링 앰비언트
3주	강아지 분리불안	6시간	소프트 레게
4주	반려동물 종합	12시간	하프 + 피아노

→ 4주 사이클 반복, 프롬프트 변주로 매번 다른 곡

---

의존성 (requirements.txt)

pydub
google-auth
google-auth-oauthlib
google-api-python-client
requests
Pillow

---

참고

• 과학적 근거 상세: PET_MUSIC_GENERATION.md
• 기존 쇼츠 파이프라인: /home/javamon/project/auto_shorts/ (수정 금지)
• ACE-Step 문서: /home/javamon/ACE-Step-1.5/README.md

---

작성: 2026-04-21