비디오 생성

listenhub video CLI로 텍스트 프롬프트나 참조 소재에서 AI 영상을 생성합니다. 정지 이미지에 움직임을 넣고, 기존 클립을 편집하고, 오디오나 음성 합성으로 캐릭터의 입 모양을 맞출 수 있습니다. 서로 다른 작업을 담당하는 세 가지 모델 계열이 있습니다: HappyHorse, SeeDance, PixVerse.

트리거

/video-gen으로 이 skill을 호출하거나, 다음 문구 중 아무거나 사용하세요:

ListenHub Skills가 설치되어 있어야 합니다 — 시작하기를 참고하세요.

AI 비주얼이 들어간 내레이션 해설 영상을 만들려면 /explainer를 대신 사용하세요.

빠른 예시

Generate a video: cyberpunk city at night, 16:9, 5 seconds

AI가 모드와 파라미터를 한 번에 하나씩 물어보고, 비용 견적을 보여 준 뒤, 생성 전에 확인을 받습니다. 생성에는 몇 분이 걸립니다 — 작업은 백그라운드로 돌아가고, 영상이 준비되면 AI가 URL, 길이, 해상도, 크레딧 비용과 함께 알려 줍니다.

모델

작업에 맞는 모델을 고르세요. HappyHorse가 기본값이며 기존 영상을 편집할 수 있는 유일한 계열입니다. SeeDance는 마지막 프레임과 참조 오디오를 추가로 지원하고, PixVerse는 립싱크를 지원하는 유일한 계열이자 여러 단위 기능(mimic, restyle, fusion, transition, 마케팅 agent)을 함께 제공합니다.

립싱크, mimic, restyle, fusion, transition, 마케팅 agent는 PixVerse 전용입니다. HappyHorse와 SeeDance는 지원하지 않습니다.

SeeDance 모델 변형

SeeDance를 고르면 두 가지 변형 중에서 선택합니다:

모드

AI는 어떤 참조 소재를 가지고 있는지에 따라 모드를 정합니다. HappyHorse와 SeeDance는 listenhub video create 명령을 함께 쓰고, PixVerse는 --capability를 명시한 listenhub openapi video pixverse generate를 씁니다.

listenhub video create \
  --prompt "cyberpunk city at night, neon reflections on wet streets" \
  --model "happyhorse" \
  --resolution "1080p" \
  --ratio "16:9" \
  --duration 5 \
  --no-wait --json

listenhub video create \
  --prompt "bring the scene to life with smooth motion" \
  --model "happyhorse" \
  --resolution "1080p" \
  --duration 5 \
  --first-frame "/path/to/scene.png" \
  --no-wait --json

listenhub video create \
  --prompt "[Image 1]'s character walking through [Image 2]'s street" \
  --model "happyhorse" \
  --resolution "1080p" \
  --ratio "16:9" \
  --duration 5 \
  --reference-image "/path/to/character.png" \
  --reference-image "/path/to/scene.png" \
  --no-wait --json

listenhub openapi video pixverse generate \
  --capability lip_sync \
  --source-video-id "abc123" \
  --audio "https://example.com/voice.mp3" \
  --quality 720p \
  --no-wait --json

listenhub openapi video pixverse generate \
  --capability lip_sync \
  --source-task-id "task_xyz" \
  --pixverse-json '{"tts":{"speakerId":"speaker_01","content":"Welcome to this episode"}}' \
  --quality 720p \
  --no-wait --json

비디오 편집(HappyHorse)

기존 클립을 편집합니다 — 스타일 변경, 배경 교체, 모션 리스타일. HappyHorse 전용이며, SeeDance에서 요청하면 AI가 HappyHorse로 바꿔 줍니다.

비디오 요건: mp4/mov(H.264 권장), 입력 360초(출력은 15초로 제한), ≤ 100 MB, 짧은 변 ≥ 360px, 긴 변 ≤ 4096px. 참조 이미지는 05장까지 선택적으로 넘길 수 있습니다.

listenhub video create \
  --prompt "replace the background with a deep starry sky, keep the subject's motion" \
  --model "happyhorse" \
  --resolution "1080p" \
  --reference-video "/path/to/input.mp4" \
  --audio-setting "origin" \
  --no-wait --json

--audio-setting은 오디오를 제어합니다: auto는 모델이 판단하게 하고, origin은 원본 오디오를 유지합니다. 비디오 편집에는 --ratio나 --duration이 없습니다 — 출력이 입력 영상을 따릅니다.

그 밖의 PixVerse 기능

PixVerse는 --capability로 추가 단위 기능을 제공하며, 모두 OpenAPI 전용이고 입력은 URL로 받습니다:

파라미터

AI가 이 값들을 한 번에 하나씩 물어보고, 적절한 세션 기본값을 적용합니다. HappyHorse와 SeeDance는 비율과 길이에 --ratio / --duration을 쓰고, PixVerse는 --resolution / --ratio 대신 --quality와 --aspect-ratio를 씁니다.

PixVerse 전용 플래그: --capability, --quality(360p/540p/720p/1080p), --aspect-ratio(9:16/16:9/1:1/4:3/3:4), --source-video-id / --source-task-id, --audio, --agent-type, --restyle-id, 그리고 중첩 페이로드(tts, imageReferences, multiTransition)를 넘기는 --pixverse-json.

크레딧 견적

생성 전에 AI가 견적을 냅니다. 직접 비용을 확인하려면 create에 넘길 파라미터를 그대로 견적 명령에 맞춰 넣으세요:

# HappyHorse / SeeDance
listenhub video estimate --model "happyhorse" --resolution "1080p" --ratio "16:9" --duration 5 --json

# PixVerse — mirror the capability + quality + duration
listenhub openapi video pixverse estimate --capability text_to_video --model pixverse --quality 720p --duration 5 --json

비디오 편집에는 --has-video-input과 --input-video-duration <seconds>를 추가하세요.

출력

상태는 pending → generating → uploading → success 순으로 흐릅니다. 성공하면 AI가 영상 URL, 길이, 해상도, 비율, 시드, 청구된 크레딧을 알려 줍니다.

출력 동작은 설정할 때 지정한 outputMode를 따릅니다:

• inline(기본값) 또는 both — 영상 URL과 메타데이터가 대화 안에 바로 표시됩니다.
• download 또는 both — 파일이 현재 작업 디렉터리에도 주제를 딴 이름으로 저장됩니다(예: cyberpunk-city.mp4). 이름 중복은 자동으로 처리됩니다.

지난 작업을 확인하려면 listenhub video get <taskId> --json으로 작업 하나를 조회하고, listenhub video list --json으로 최근 작업 목록을 봅니다. 전역 플래그도 그대로 적용됩니다: --json / -j, --no-wait, --timeout <s>.

API 레퍼런스

엔드포인트 경로, 요청 파라미터, 응답 필드는 AI 비디오 API 레퍼런스를 참고하세요.