비디오에이전트 비디오 스튜디오

🎬 비디오에이전트 비디오 스튜디오

사용 시기: 사용자가 비디오 생성, 텍스트로 비디오 만들기, 이미지 애니메이션, 짧은 클립 제작, AI 비디오 생성을 요청할 때.

7가지 백엔드로 짧은 AI 비디오를 생성합니다. 이 스킬은 적절한 모드(텍스트-투-비디오 또는 이미지-투-비디오)를 선택하고, 최상의 결과를 위해 프롬프트를 향상시킨 후 비디오 URL을 반환합니다.

---

빠른 참조

사용자 의도	모드	일반 소요 시간
"다음에 대한 비디오 만들어줘..." (이미지 없음)	text-to-video	4–10 초
"이 이미지 움직여줘" / "이걸 움직이게 해줘"	image-to-video	4–6 초
"이걸로 비디오 만들어줘..."	image-to-video	4–6 초
시네마틱, 스토리, 광고	상세 프롬프트와 함께 text-to-video 선호	5–10 초

생성 모드

모드	설명	모델
text-to-video	텍스트 프롬프트만으로 비디오 생성	minimax, kling, veo, hunyuan, grok, seedance
image-to-video	단일 이미지 + 프롬프트로 애니메이션 클립 생성	minimax, kling, veo, pixverse, grok, seedance
reference-based	참조 이미지/비디오로 일관된 출력 생성	minimax, kling, veo, hunyuan, grok, seedance

모델 (--model <id> 사용)

모델 ID	T2V	I2V	참조	비고
minimax	✅	✅	✅	주제 참조 이미지, 캐릭터 일관성
kling	✅	✅	✅	다중 요소 / 캐릭터 / 키프레임 (O3)
veo	✅	✅	✅	Google Veo 3.1, 다중 참조 이미지
hunyuan	✅	—	✅	비디오-투-비디오 스타일 전환
pixverse	—	✅	—	스타일화된 이미지-투-비디오
grok	✅	✅	✅	참조 비디오를 통한 비디오 편집
seedance	✅	✅	✅	Seedance 1.5 Pro, 동기화된 오디오, 4–12 초

전체 모델 세부 사항 및 엔드포인트 참조: references/models.md.

---

비디오 생성 방법

1단계 — 모드 선택 및 프롬프트 향상

• 텍스트-투-비디오: 주제, 동작, 카메라 움직임, 조명, 스타일로 확장합니다. 움직임을 구체적으로 명시하세요 (예: "카메라가 천천히 줌 인", "캐릭터가 왼쪽에서 오른쪽으로 걷는다").
• 이미지-투-비디오: 이미지에 적용할 움직임을 설명합니다 (예: "머리카락에 부는 산들바람", "카메라가 장면을 가로지르며 패닝"). 패턴은 references/prompt_guide.md를 참조하세요.

2단계 — 스크립트 실행

텍스트-투-비디오:

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "<향상된 프롬프트>" \
  --duration <초> \
  --aspect-ratio <비율>

이미지-투-비디오:

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --prompt "<움직임 설명>" \
  --image-url "<공개 이미지 URL>" \
  --duration <초> \
  --aspect-ratio <비율>

파라미터:

파라미터	기본값	설명
--mode	text-to-video	text-to-video 또는 image-to-video
--prompt	(필수)	장면 또는 움직임 설명
--image-url	—	image-to-video에 필수; 공개 이미지 URL
--duration	5	초 단위 길이 (일반적으로 4–10)
--aspect-ratio	16:9	16:9, 9:16, 1:1, 4:3, 3:4
--model	auto	모델 ID (예: kling, veo, grok, seedance); auto = 프록시가 선택

기타 명령어:

명령어	설명
node tools/generate.js --list-models	프록시에서 사용 가능한 모델 목록 표시
node tools/generate.js --status --job-id <id>	비동기 작업 상태 확인

3단계 — 결과 반환

스크립트는 JSON을 반환합니다:

{
  "success": true,
  "mode": "text-to-video",
  "videoUrl": "https://...",
  "duration": 5,
  "aspectRatio": "16:9"
}

videoUrl을 사용자에게 보냅니다.

---

예시 대화

사용자: "비 오는 거리에서 걷는 고양이의 시네마틱 짧은 비디오를 생성해줘."

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "A cat walking through rain, wet streets, neon reflections, cinematic lighting, slow motion, 4K" \
  --duration 5 \
  --aspect-ratio 16:9

---

사용자: "이 사진을 움직이게 해줘" (사용자가 풍경 사진을 업로드)

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --prompt "Gentle clouds moving across the sky, subtle grass movement, cinematic atmosphere" \
  --image-url "https://..." \
  --duration 5 \
  --aspect-ratio 16:9

---

사용자: "10초짜리 수직 비디오로 커피 따르는 슬로우 모션 영상을 만들어줘."

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "Close-up of coffee pouring into a white cup, slow motion, steam rising, soft lighting, product shot" \
  --duration 10 \
  --aspect-ratio 9:16

---

사용자: "Google Veo로 시네마틱 샷을 만들어줘."

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --model veo \
  --prompt "A dragon flying through cloudy skies, cinematic lighting, 8s" \
  --duration 8 \
  --aspect-ratio 16:9

---

사용자: "이 초상화를 애니메이션화해줘."

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --model grok \
  --prompt "Gentle smile, subtle head turn" \
  --image-url "https://..." \
  --duration 5

---

설정

기본적으로 API 키가 필요 없습니다. 요청은 호스팅된 프록시를 통해 전송됩니다. 사용자 정의 프록시 또는 토큰을 설정하려면 다음 변수를 사용하세요:

변수	필수	설명
VIDEO_STUDIO_PROXY_URL	아니요	프록시 기본 URL
VIDEO_STUDIO_TOKEN	아니요	프록시가 요구하는 경우 인증 토큰

---

지식 베이스

• references/prompt_guide.md — 텍스트-투-비디오 및 이미지-투-비디오용 프롬프트 패턴.
• references/models.md — 모델 목록, 기능 및 선택 가이드.
• references/calling_guide.md — 모델별 엔드포인트 세부 사항, 입력 파라미터 및 특수 처리.