해설 영상

내레이터 한 명의 보이스오버와 AI가 생성한 비주얼을 결합한 해설 영상을 생성합니다. 제품 소개, 개념 설명, 튜토리얼에 가장 잘 맞습니다. 내레이션이 들어간 완성 영상을 바로 만들 수도 있고, 영상 제작을 결정하기 전에 대본 텍스트만 먼저 뽑아 검토할 수도 있습니다.

트리거

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

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

빠른 예시

Make an explainer video introducing Claude Code

AI가 짧은 문답으로 언어, 스타일, 출력 타입을 확인한 뒤 대본을 쓰고, 보이스를 고르고, 각 섹션의 비주얼을 생성해 영상을 완성합니다.

모드

해설 영상은 두 가지 모드를 지원합니다. --mode로 설정하며 기본값은 info입니다.

옵션

AI가 생성 전에 짧은 문답으로 이 값들을 수집합니다. listenhub explainer create 명령을 직접 실행할 때는 곧바로 전달할 수도 있습니다.

언어

--lang은 en, zh, ja를 받습니다. 생략하면 주제 텍스트에서 언어를 자동으로 감지합니다. 설정에 기본 언어를 지정해 두었다면 AI가 그 값을 미리 채우고 이 질문을 건너뜁니다.

화자

해설 영상이 쓰는 화자는 정확히 한 명입니다. 화자를 지정하지 않으면 AI가 선택된 언어의 내장 기본 보이스를 사용합니다. 다른 보이스를 쓰려면 바꿔 달라고 요청하세요. AI가 사용할 수 있는 보이스를 가져옵니다 — 화자 ID가 하드코딩되는 일은 없습니다.

이미지 크기와 화면 비율

--image-size는 생성되는 비주얼의 해상도를 정합니다(2K 또는 4K, 기본값 2K). --aspect-ratio는 영상의 화면 형태를 정합니다: 16:9(기본값, 가로형), 9:16(세로형), 1:1(정사각형).

소스 URL 또는 텍스트

기존 자료를 바탕으로 해설 영상을 만들려면 참고 자료를 넘기세요. AI가 페이지 링크는 --source-url로, 붙여 넣은 내용은 --source-text로 --query와 함께 전달하고, 그 내용에서 대본이 생성됩니다. 두 플래그 모두 반복 지정할 수 있습니다.

출력 타입

내레이션이 들어간 완성 영상과 대본 텍스트만 중에서 고르세요.

listenhub explainer create \
  --query "Introduce Claude Code: what it is, key features, and how to get started" \
  --mode info \
  --lang en \
  --speaker "Mars" \
  --image-size 2K \
  --aspect-ratio 16:9 \
  --timeout 600 \
  --json

listenhub explainer create \
  --query "Introduce Claude Code" \
  --mode info \
  --lang en \
  --skip-audio \
  --json

출력

생성이 끝나면 AI가 설정된 출력 모드에 따라 결과를 보여 줍니다.

온라인 에피소드

실행할 때마다 보고 공유할 수 있는 온라인 에피소드가 만들어집니다:

https://listenhub.ai/app/explainer/{episodeId}

전체 내레이션 대본은 에피소드 상세에서 확인할 수 있습니다.

결과 필드

create 명령은 에피소드 상세를 반환합니다. 형태는 출력 타입에 따라 달라집니다:

--json을 붙이면 전체 에피소드 상세(id / episodeId, title, processStatus 포함)를 출력합니다. --json 없이 실행하면 간략한 요약을 출력합니다.

다운로드

출력 모드가 download나 both이면 AI가 현재 작업 디렉터리에 파일도 저장합니다:

• 텍스트만 — 대본 파일, 예: claude-code-explainer.md
• 텍스트 + 영상 — script.md와 audio.mp3가 들어 있는 claude-code-explainer/ 폴더

온라인 에피소드 링크는 출력 모드와 관계없이 항상 표시됩니다.

팁

• 프롬프트에 설명을 자세히 적을수록 비주얼이 풍부해집니다.
• 섹션 하나에 개념 하나가 가장 명확합니다.
• 먼저 텍스트만 요청해 대본을 검토한 뒤 영상을 생성하세요.
• 세로형 소셜 포맷에는 --aspect-ratio 9:16을, 더 높은 해상도의 비주얼에는 4K를 사용하세요.

관련 문서

API 레퍼런스

OpenAPI에서 이에 대응하는 인터페이스는 storybook입니다(같은 백엔드, 다른 이름). 엔드포인트 상세와 코드 예시는 해설 영상 API 레퍼런스를 참고하세요.