解説動画

トピック、URL、テキストから、AI 生成のビジュアルを付けたナレーション解説動画を作成します。info と story の 2 つのモードに対応。

1 人のナレーターによる音声と AI 生成のビジュアルを組み合わせた解説動画を生成します。製品紹介、概念の解説、チュートリアルに最適です。ナレーション付きの完成動画をそのまま作ることも、まず台本テキストだけを生成して確認してから動画化を決めることもできます。

トリガー

/explainer でこの Skill を呼び出すか、次のいずれかのフレーズを使用します：

フレーズ	言語
`explainer video`	英語
`explain this as a video`	英語
`tutorial video`	英語
`解说视频`	中国語
`解释一下 XXX（视频形式）`	中国語

利用するには ListenHub Skills のインストールが必要です — はじめにを参照してください。

簡単な例

Make an explainer video introducing Claude Code

AI は短い質疑応答で言語・スタイル・出力タイプを確認し、そのうえで台本を書き、ボイスを選び、各セクションのビジュアルを生成して、動画を仕上げます。

解説動画とスライドは、どちらもトピックをビジュアルコンテンツに変えます。連続したナレーション付き動画がほしいときは解説動画を、ナレーションが任意（デフォルトはオフ）の独立したスライドの束がほしいときはスライドを使ってください。解説動画が使う話者はちょうど1 人です。ビジュアルなしで音声だけがほしい場合は、音声合成（TTS）またはポッドキャストを使ってください。

モード

解説動画は 2 つのモードに対応しています。--mode で設定し、デフォルトは info です。

事実にもとづく構造化された伝え方。明快な流れ：導入、要点、まとめ。

製品紹介、機能の解説、教育コンテンツに最適です。

物語的なストーリーテリングの手法。引き込まれる流れ：フック、盛り上げ、クライマックス、結末。

ブランドストーリー、事例紹介、感情に訴えるトピックに最適です。

意図	推奨モード
「この製品を紹介して」	`info`
「X の仕組みを説明して」	`info`
「X の物語を語って」	`story`
「引き込まれる動画を作って」	`story`
指定なし	`info`（デフォルト）

解説動画が受け付けるのは info か story だけです。slides モードはスライド Skill のものです — スライドを作りたい場合はそちらを使ってください。

オプション

AI は生成前に短い質疑応答でこれらを収集します。listenhub explainer create コマンドを自分で実行する場合は、直接渡すこともできます。

オプション	CLI フラグ	値	デフォルト
トピック / 内容	`--query`	自由テキスト、またはソースと併用	必須
ソース URL	`--source-url`	要約対象の URL（繰り返し指定可）	なし
ソーステキスト	`--source-text`	参照テキスト（繰り返し指定可）	なし
モード	`--mode`	`info`、`story`	`info`
言語	`--lang`	`en`、`zh`、`ja`	トピックから自動判別
話者	`--speaker`	ボイス名	その言語の組み込みデフォルト
話者 ID	`--speaker-id`	話者の内部 ID	`--speaker` から解決
テキストのみ	`--skip-audio`	指定時 = 台本のみ、音声・動画なし	オフ（完全な動画）
画像サイズ	`--image-size`	`2K`、`4K`	`2K`
アスペクト比	`--aspect-ratio`	`16:9`、`9:16`、`1:1`	`16:9`
ビジュアルスタイル	`--style`	ビジュアル向けの自由テキストのスタイル指定	なし

言語

--lang は en、zh、ja を受け付けます。省略した場合、言語はトピックのテキストから自動判別されます。設定でデフォルト言語を指定している場合、AI はそれを事前入力し、この質問をスキップします。

話者

解説動画が使う話者はちょうど1 人です。話者を指定しない場合、AI は選択された言語の組み込みデフォルトボイスを使います。別のボイスを使いたいときは変更を頼んでください。AI が利用可能なボイスを取得します — 話者 ID がハードコードされることはありません。

画像サイズとアスペクト比

--image-size は生成されるビジュアルの解像度を制御します（2K または 4K、デフォルトは 2K）。--aspect-ratio は動画の画面形状を制御します：16:9（デフォルト、横長）、9:16（縦長）、1:1（正方形）。

ソース URL またはテキスト

既存の素材から解説動画を作るには、参照元を渡してください。AI はページのリンクを --source-url、貼り付けた内容を --source-text として --query と一緒に渡し、その内容から台本が生成されます。どちらのフラグも繰り返し指定できます。

出力タイプ

ナレーション付きの完全な動画にするか、台本テキストだけにするかを選べます。

デフォルトです。ナレーション台本を生成し、各セクションに対応する AI 生成ビジュアルを付けた動画を作ります。

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

一般的な生成時間：5–10 分。

--skip-audio を渡すとナレーション台本だけを生成します — 音声も動画も作りません。フルレンダリングに進む前に内容を確認したいときに便利です。

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

一般的な生成時間：2–3 分。

出力

生成が完了すると、AI は設定された出力モードに応じて結果を提示します。

オンラインエピソード

実行するたびに、視聴・共有できるオンラインエピソードが作られます：

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

完全なナレーション台本はエピソード詳細で確認できます。

結果のフィールド

create コマンドはエピソード詳細を返します。その形は出力タイプによって変わります：

出力タイプ	返されるリンク
Text + Video	`videoUrl`（レンダリング済みの動画）、`audioUrl`（ナレーションの音声トラック）、`credits`
Text only（`--skip-audio`）	台本のみ — `audioUrl` も `videoUrl` もありません。台本はオンラインエピソードのリンクから確認してください

--json を付けると、コマンドは完全なエピソード詳細（id / episodeId、title、processStatus を含む）を出力します。--json なしの場合は簡潔な要約を出力します。

ダウンロード

出力モードが download または both の場合、AI はファイルをカレントディレクトリにも保存します：

Text only — 台本ファイル。例：claude-code-explainer.md
Text + Video — script.md と audio.mp3 を含む claude-code-explainer/ フォルダ

オンラインエピソードのリンクは、出力モードにかかわらず常に表示されます。

クレジット消費は台本の長さ、画像サイズ、動画をレンダリングするかどうかで変わり、生成後の結果に表示されます。解説動画には独立した見積もりコマンドはありません — 動画をレンダリングする前に規模を確認したい場合は、まずテキストのみを生成してください。

ヒント

プロンプトに詳しい説明を書くほど、豊かなビジュアルが生成されます。
1 セクションにつき 1 つの概念にすると、いちばん分かりやすくなります。
まずテキストのみをリクエストして台本を確認し、それから動画を生成してください。
縦型のソーシャル向けには --aspect-ratio 9:16 を、より高解像度のビジュアルには 4K を使ってください。

API リファレンス

OpenAPI 上で等価なインターフェースは storybook です（バックエンドは同じで、名前が異なります）。エンドポイントの詳細とコード例は解説動画 API リファレンスを参照してください。