HunyuanVideo 1.5 720p MCP

RunPod Serverless에서 HunyuanVideo-1.5 720P-I2V를 실행하고 MCP로 비동기 작업을 제출·조회·취소하는 프로젝트입니다.

현재 고정된 배포 구성

• 모델: HunyuanVideo-1.5 720P-I2V

• 출력: 1280×720, 24fps, 무음 H.264 MP4

• 길이: 5~10초

• GPU: A40 48GB 우선, RTX A6000 48GB 대체, A100 PCIe 80GB 최종 fallback

• Network Volume: qs5gpwp1p1, 60GB, CA-MTL-3

• Worker: 최소 0, 최대 1, 유휴 5초 후 정지

• Serverless 48GB Flex 계산 기준: 현재 $1.22/시간(실제 청구는 RunPod 가격 우선)

• 결과: 비공개 Cloudflare R2에 저장 후 최대 7일짜리 다운로드 URL 반환

• 에이전트 입력: MCP에서 로컬 PNG/JPEG 또는 base64/data URI를 R2에 직접 업로드

에이전트에서 이미지 바로 사용

Claude/Cursor에서 이미지를 첨부한 뒤 다음처럼 요청할 수 있습니다.

이 이미지를 업로드하고, 종이 질감은 유지한 채 선이 천천히 움직이는 5초 720p 영상으로 만들어줘.

에이전트는 다음 순서로 MCP 도구를 호출합니다.

1. upload_video_input에 첨부 이미지의 local_path, image_data_base64, image_data_uri 중 하나를 전달

2. 반환된 asset_id를 submit_video_job에 전달

3. get_video_job으로 완료 상태를 확인

4. get_video_result로 새 다운로드 링크를 받음

업로드는 PNG/JPEG, 최대 20MB, 한 변 64~8192px, 최대 40MP로 제한됩니다. 이미지는 실제로 디코딩해 손상 여부를 확인하고 콘텐츠 해시 기반 R2 키로 저장하므로 같은 파일은 같은 asset_id를 사용합니다. 16:9가 아닌 입력은 1280×720 workflow에서 잘리거나 재구성될 수 있다는 경고를 반환합니다.

남은 일회성 승인

1. 첫 5초 GPU 테스트 비용 승인 (GPU-TEST)

2. 테스트 성공 후 장면 8개 전체 생성 비용 승인 (ALL-8)

GitHub 로그인, Worker 빌드, R2 입력 8개 업로드, RunPod Template·Endpoint 생성은 완료되었습니다. 추가 API key 입력은 필요하지 않습니다.

.env는 Git에 포함되지 않습니다. API key와 R2 Secret은 채팅이나 저장소에 올리지 않습니다. 비용 표시는 Serverless Flex의 현재 48GB/A100 시간당 가격을 사용한 추정치이며, 실제 RunPod 청구가 우선합니다.

검증과 배포

전체 절차는 READY_TO_DEPLOY.md에 정리되어 있습니다.

가장 쉬운 방법은 Finder에서 START_HERE.command를 더블클릭하는 것입니다. 완료된 배포 상태를 확인한 뒤 GPU 비용 승인을 안내하며, 승인 문구가 정확히 입력되기 전에는 유료 작업을 실행하지 않습니다.

python3 scripts/preflight.py
scripts/finalize_deployment.sh --approve-public-code-and-r2-upload
.venv/bin/python scripts/smoke_test.py --approve-gpu-cost

deploy_runpod.py는 기본적으로 dry-run이며 --apply를 지정할 때만 템플릿과 Endpoint를 생성합니다.