liven — 이미지 투 비디오 (클라우드)
fal.ai의 클라우드 인프라에서 실행되는 LTX-2.3 Fast 비디오 확산 모델을 사용하여 정적 이미지를 생생하게 만듭니다. 이미지와 모션 프롬프트를 제공하면, 모델이 설정에 따라 6-20초의 짧은 비디오 클립을 생성합니다.
이 SKILL.md가 있는 스킬 디렉토리는 아래에서 $SKILL_DIR로 참조됩니다.
클라우드 기반. 로컬 GPU가 필요하지 않습니다.
FAL_API_KEY환경 변수가 필요합니다. 가격: 1080p는 초당 $0.04, 1440p는 초당 $0.08, 4K는 초당 $0.16.
사용 시기
사용자가 다음과 같은 경우 이 스킬을 사용하세요:
- 로컬 GPU 없이 사진이나 일러스트레이션을 짧은 비디오로 애니메이션화할 때
- 정지 이미지에서 시네마틱 모션(예: 느린 줌, 팬, 빛 깜빡임)을 만들 때
- 제품 사진이나 초상화에서 소셜 미디어 비디오 콘텐츠를 생성할 때
- 로컬 VRAM 제약 없이 더 높은 해상도(최대 4K)를 사용할 때
설정 (첫 실행 시에만)
cd "$SKILL_DIR" && uv sync
FAL_API_KEY 환경 변수를 설정하세요:
export FAL_API_KEY="your-api-key-here"
에이전트 워크플로우
1. 사용자에게 묻기
이미지를 애니메이션화하기 전에 다음 정보가 필요합니다:
💬 모션 프롬프트 (필수)
원하는 움직임을 설명하세요, 예:
"느린 시네마틱 푸시인, 황금 시간대 조명, 미세한 카메라 드리프트"
🎬 클립 설정
- duration — 비디오 길이(초) (기본값: 6, 옵션: 6, 8, 10, 12, 14, 16, 18, 20)
참고: 10초 초과 지속 시간은 25 FPS 및 1080p만 지원
- resolution — 출력 품질 (기본값: 1080p, 옵션: 1080p, 1440p, 2160p/4K)
- aspect_ratio — 비디오 종횡비 (기본값: auto, 옵션: auto, 16:9, 9:16)
- fps — 초당 프레임 수 (기본값: 25, 옵션: 24, 25, 48, 50)
- generate_audio — 비디오에 맞는 AI 오디오 생성 (기본값: true)
📁 입력/출력 디렉토리 (기본값: ./input 및 ./output)
사용자 응답을 기다린 후 진행하세요.
2. config.json 편집
사용자의 선택에 따라 $SKILL_DIR/config.json을 작성하거나 업데이트합니다.
3. 실행
cd "$SKILL_DIR" && uv run python scripts/img2vid.py --config config.json
4. 결과 보고
사용자에게 다음을 알립니다:
- 출력 파일 경로
- 비디오 지속 시간 및 해상도
- 비용 추정 (지속 시간 및 해상도 기준)
- 직접 다운로드 URL (비디오는 fal.media에 임시로 호스팅됨)
설정 참조
| 키 | 값 | 기본값 | 설명 |
|---|---|---|---|
input_dir | 경로 | ./input | 소스 이미지가 포함된 폴더 |
output_dir | 경로 | ./output | 대상 폴더 |
prompt | 문자열 | (필수) | 모션 설명 |
duration | 정수 | 6 | 비디오 지속 시간(초) (6-20) |
resolution | 문자열 | 1080p | 출력 해상도: 1080p, 1440p, 2160p |
aspect_ratio | 문자열 | auto | 종횡비: auto, 16:9, 9:16 |
fps | 정수 | 25 | 초당 프레임 수: 24, 25, 48, 50 |
generate_audio | 부울 | true | 비디오용 AI 오디오 생성 |
end_image_url | 문자열 | null | 전환 비디오용 선택적 종료 프레임 |
일반적인 호출 방법
# 모션 프롬프트로 애니메이션화 (기본값 사용: 6초, 1080p, 25fps)
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "느린 시네마틱 푸시인, 황금 시간대 조명"
# 더 긴 10초 비디오 생성
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "나무에 부는 부드러운 바람" --duration 10
# 소셜 미디어용 세로 비디오 생성
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "미세한 카메라 움직임" --aspect-ratio 9:16
# 4K 품질 (더 높은 비용: 초당 $0.16)
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "시네마틱 줌 아웃" --resolution 2160p --duration 8
# 더 부드러운 모션을 위한 높은 프레임 속도
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "빠른 액션 시퀀스" --fps 48
# 오디오 생성 비활성화
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "조용한 명상 장면" --no-audio
# 두 이미지 간 전환 생성
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "부드러운 변환 전환" \
--end-image /path/to/end_image.jpg
출력
각 입력 이미지는 output_dir에 <image_stem>.mp4라는 이름의 .mp4 클립 하나를 생성합니다. 비디오는 fal.media CDN에 임시로 업로드되며, 다운로드 URL이 콘솔 출력에 제공됩니다.
생성 후 비디오 메타데이터(해상도, fps, 지속 시간)가 출력됩니다.
오류 처리
- FAL_API_KEY 누락 → 설정 지침이 포함된 명확한 오류
- 잘못된 이미지 형식 → 지원되는 형식(PNG, JPEG, WebP, AVIF, HEIF)과 함께 오류
- API 오류 → fal.ai 오류 메시지 전파
- 네트워크 문제 → 명확한 오류 메시지와 함께 재시도 로직
가격 참조
| 해상도 | 초당 가격 |
|---|---|
| 1080p | $0.04 |
| 1440p | $0.08 |
| 2160p (4K) | $0.16 |
예시:
- 1080p에서 6초 비디오 = $0.24
- 1080p에서 10초 비디오 = $0.40
- 4K에서 10초 비디오 = $1.60