video-generator — 멀티 모델 클라우드 비디오 (Higgsfield)
Higgsfield를 통해 비디오 클립을 생성합니다. Higgsfield는 6개 이상의 주요 모델을 하나의 API와 결제 계정으로 통합한 플랫폼입니다. 비용 대비 품질 트레이드오프에 맞는 모델을 선택하세요. 나머지 인터페이스는 동일합니다.
이 스킬 디렉토리(SKILL.md가 위치한 곳)는 아래에서 $SKILL_DIR로 표시됩니다.
클라우드 기반. 로컬 GPU가 필요하지 않습니다. Higgsfield 계정과 cloud.higgsfield.ai의 API 키가 필요합니다.
모드
| 모드 | 트리거 | 설명 |
|---|---|---|
text-to-video | input/에 이미지 없음 | 프롬프트만으로 비디오 생성 |
image-to-video | input/에 이미지 있음 | 각 이미지를 클립으로 애니메이션 |
auto (기본값) | — | 위 모드를 자동 선택 |
프리셋
이 스킬은 동일한 비디오 엔진 위에 얇은 오버레이로 프리셋을 사용합니다. 프리셋은 기본 모델, 종횡비, 지속 시간 및 프롬프트 프리픽스를 설정할 수 있습니다. 명시적인 설정 값이 우선 적용됩니다.
| 프리셋 | 용도 | 기본 모델 | 기본 비율 |
|---|---|---|---|
cinematic (기본값) | 범용 시네마틱 비디오 | kling | 16:9 |
social-hook | 시선을 끄는 숏폼 | seedance | 9:16 |
motion-design-ad | SaaS/제품 모션 광고 | kling | 16:9 |
ecommerce-ad | 제품 프로모 클립 | kling | 9:16 |
brand-story | 창업자/브랜드 내러티브 | kling | 16:9 |
product-360 | 단독 제품 쇼케이스 | kling | 1:1 |
워크플로 규칙:
config.json을 편집하기 전에 프리셋을 선택하세요.- 프리셋이 원하는 출력 스타일과 일치하는지 확인하세요.
- 사용자가 선택하지 않으면 기본 프리셋을 유지하고 config에 기록하세요.
- 동일한 스타일을 두 번 적용하지 마세요. 프롬프트가 이미 프리셋과 일치하면 프롬프트를 그대로 유지합니다.
모델
| 키 | 전체 모델 ID | 용도 |
|---|---|---|
kling (기본값) | kling-video/v2.1/pro/image-to-video | 사실적인 움직임, 비용 효율적 |
seedance | bytedance/seedance/v1/pro/image-to-video | 네이티브 오디오 동기화 |
dop | higgsfield-ai/dop/standard | 시네마 스튜디오 광학 물리 |
dop-preview | higgsfield-ai/dop/preview | 시네마 스튜디오 (프리뷰 버전) |
위는 공식 문서에서 확인된 모델 ID입니다. 추가 모델(Sora, Veo, Wan 등)은 cloud.higgsfield.ai/explore에서 찾을 수 있습니다. 추가하려면
generate.py의MODEL_IDS에 삽입하고--model별칭을 추가하세요.크레딧은 성공적인 생성에 대해서만 청구됩니다. 실패 및 NSFW 요청은 환불됩니다.
설정 (첫 실행 시에만)
cd "$SKILL_DIR" && uv sync
cloud.higgsfield.ai에서 자격 증명(API 키 + API 시크릿)을 가져온 후, 다음 형식 중 하나를 사용하여 내보냅니다:
# 옵션 A — 결합 (권장)
export HF_KEY="your-api-key:your-api-secret"
# 옵션 B — 별도 변수
export HF_API_KEY="your-api-key"
export HF_API_SECRET="your-api-secret"
에이전트 워크플로
1. 사용자에게 질문
비디오를 생성하기 전에 다음 정보가 필요합니다:
🎬 모드
- text-to-video (프롬프트만) 또는 image-to-video (input/에 이미지 넣기)
- 기본값: auto-detect
🎛️ 프리셋 (기본값: cinematic)
- cinematic · social-hook · motion-design-ad · ecommerce-ad · brand-story · product-360
- config.json을 작성하기 전에 선택을 확인하세요.
- 생략된 경우 기본 프리셋을 유지하고 해당 선택을 기록하세요.
🤖 모델 (기본값: kling)
kling · seedance · dop · dop-preview
권장 사항: 속도/비용은 kling, 품질은 seedance
💬 프롬프트 (필수)
움직임이나 장면을 설명하세요. 예:
"느린 시네마틱 푸시인, 따뜻한 황금빛 시간, 미세한 카메라 드리프트"
⚙️ 설정
- duration — 비디오 길이(초) (기본값: 6, 범위: 3–16)
- aspect_ratio — 16:9 · 9:16 · 1:1 (기본값: 16:9)
- resolution — 720p · 1080p (기본값: 1080p)
진행하기 전에 사용자 응답을 기다리세요.
2. config.json 편집
사용자의 선택에 따라 $SKILL_DIR/config.json을 작성하거나 업데이트하세요. 기본값을 사용하는 경우에도 preset을 명시적으로 설정하세요.
3. (image-to-video만 해당) 이미지 배치
소스 이미지를 $SKILL_DIR/input/에 복사하세요. 지원 형식: .jpg .jpeg .png .webp
4. 실행
cd "$SKILL_DIR" && uv run python scripts/generate.py --config config.json
5. 결과 보고
사용자에게 다음을 알리세요:
output/의 출력 파일 경로- 사용된 모델 및 대략적인 크레딧 비용
- 비디오 지속 시간 및 해상도
설정 참조
| 키 | 값 | 기본값 | 설명 |
|---|---|---|---|
input_dir | 경로 | ./input | 소스 이미지 (image-to-video만 해당) |
output_dir | 경로 | ./output | MP4가 쓰이는 곳 |
mode | auto · text-to-video · image-to-video | auto | 생성 모드 |
preset | cinematic · social-hook · motion-design-ad · ecommerce-ad · brand-story · product-360 | cinematic | 창의적 프리셋 오버레이 |
model | kling · seedance · dop · dop-preview | kling | 사용할 모델 |
prompt | 문자열 | (필수) | 움직임 또는 장면 설명 |
duration | 정수 3–16 | 5 | 비디오 길이(초) |
aspect_ratio | 16:9 · 9:16 · 1:1 | 16:9 | 출력 종횡비 |
extra_params | 객체 | {} | 모델 API에 전달할 추가 매개변수 |
일반적인 호출 예시
# 기본 모델(kling)로 텍스트-투-비디오
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "일출에 안개 낀 산 위 드론 샷" --duration 8
# Kling으로 이미지-투-비디오 (먼저 input/에 이미지 넣기)
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "느린 시네마틱 푸시인, 황금빛 시간" --model kling
# 더 높은 품질: Seedance
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "새벽 안개 낀 도시 위 항공 후진" --model seedance
# Reels/TikTok용 세로 비디오
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "말하는 머리, 자연스러운 보케 배경" \
--aspect-ratio 9:16 --model kling
# 빠른 드래프트: 낮은 해상도, 짧은 클립
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "어두운 배경에 제품 등장" \
--resolution 720p --duration 4 --model dop-preview
출력
각 작업은 output_dir에 하나의 .mp4 파일을 씁니다:
- text-to-video:
output.mp4 - image-to-video: 입력 이미지당
<image_stem>.mp4
animate-image와의 비교
animate-image | video-generator | |
|---|---|---|
| 제공자 | fal.ai | Higgsfield |
| 모드 | 이미지→비디오만 | 텍스트→비디오 + 이미지→비디오 |
| 모델 | LTX-2.3 Fast (고정) | Kling, Sora, Veo, Wan, Seedance, MiniMax |
| 속도 | 매우 빠름 | 모델에 따라 다름 |
| 최대 해상도 | 4K | 1080p |
| 시네마틱 제어 | 없음 | extra_params를 통해 가능 |
빠르고 저렴하며 고해상도의 이미지 클립에는 animate-image를 사용하세요.
텍스트-투-비디오, 모델 선택 또는 Higgsfield의 시네마 스튜디오 물리 제어가 필요할 때는 video-generator를 사용하세요.
API 참고 사항
이 스킬은 Higgsfield REST API(cloud.higgsfield.ai)와 직접 통신합니다. 모델 엔드포인트 경로는 generate.py 상단의 MODEL_ENDPOINTS에 정의되어 있습니다. Higgsfield가 경로를 업데이트하면 config의 "extra_params"를 통해 재정의하거나 상수를 업데이트하세요. 다른 변경 사항은 필요하지 않습니다.