---
name: youtube-fantasy
description: 판타지 음원 큐(마법사 도서관, 중세 술집, 마법의 숲 등)에서 다음 1편을 자동으로 게시한다. 매번 호출 시 큐의 다음 항목으로 진행. 사용자가 "판타지 다음 거 올려줘", "/youtube-fantasy" 같이 요청할 때 발동.
---

# 판타지 음원 시리즈 게시

## 무엇을 하는가

[fantasy_upload.py](../../../fantasy_upload.py) 를 실행한다:

1. `fantasy_queue.json` 에서 진행 상황 로드
2. 미게시 항목 중 첫 번째 선택(순서: enchanted_forest → ancient_temple → cozy_cottage → castle_wind → space_station)
3. Pixabay 배경 영상 + AI 이미지 썸네일(`IMAGE_PROVIDER` 설정 따름) 생성
4. 1시간·8시간 영상 두 편 모두 업로드 + `fantasy` 재생목록 추가
5. 큐의 `done` 리스트에 추가

## 실행

```bash
cd /Users/gaebalai/Workspace2/youtube-bgm-auto
[ -f venv/bin/activate ] && source venv/bin/activate
python3 fantasy_upload.py
```

소요 시간: **30~60분**(일반 업로드와 비슷).

## 자동 사전 점검

[preflight.py](../../../preflight.py) 가 라이브러리·ffmpeg·OAuth 파일·`IMAGE_PROVIDER` 별 API 키(예: `gpt-image-1` 이면 `OPENAI_API_KEY`)를 자동 검증한다.

## 큐 상태 확인

```bash
cat fantasy_queue.json
```

빈 큐(모두 게시 완료)면 스크립트는 아무 일도 하지 않고 종료한다. 새 음원을 추가하려면 `fantasy_upload.py` 의 `FANTASY_QUEUE` 리스트를 편집.

## 비용 주의

판타지 썸네일은 AI 이미지 생성을 사용한다. `IMAGE_PROVIDER` 별 1편(2장 생성) 대략 비용:
- `gpt-image-1`: 약 200~500원
- `gemini-2.5-flash-image`: 약 100원