解说视频

用 AI 生成带配图的解说视频，支持主题、URL 或文本输入，提供 info 与 story 两种模式。

生成将单个主播配音与 AI 配图结合的解说视频。适合产品介绍、概念讲解和教程制作。你既可以产出完整的配音视频，也可以先只生成脚本文本，审阅后再决定是否制作视频。

触发方式

输入 /explainer 命令，或使用以下任意短语触发：

短语	语言
`explainer video`	英文
`explain this as a video`	英文
`tutorial video`	英文
`解说视频`	中文
`解释一下 XXX（视频形式）`	中文

使用前请先安装 ListenHub Skills — 参见快速开始。

快速示例

做个解说视频，介绍一下 Claude Code

AI 会通过简短的问答确认语言、风格和输出类型，然后编写脚本、选择音色、为每个章节生成配图，最终产出视频。

解说视频和幻灯片都能把主题转化为视觉内容。解说视频产出的是连续的配音视频；幻灯片产出的是一张张独立的幻灯片，配音可选且默认关闭。解说视频固定使用一个主播。如果只需要音频而不需要画面，请使用语音或播客。

模式

解说视频支持两种模式。用 --mode 设置，默认为 info。

事实性、结构化的呈现方式。清晰的逻辑推进：引言、要点、总结。

适合产品介绍、功能演示和教育内容。

叙事故事手法。引人入胜的结构：悬念、铺垫、高潮、结局。

适合品牌故事、案例分析和情感话题。

用户意图	推荐模式
"介绍这个产品"	`info`
"解释 X 是怎么工作的"	`info`
"讲讲 X 的故事"	`story`
"做个有趣的视频"	`story`
未指定偏好	`info`（默认）

解说视频只接受 info 或 story。slides 模式属于幻灯片技能 — 要做幻灯片请改用该技能。

选项

AI 会在生成前通过简短问答收集这些选项。你也可以在自己驱动 listenhub explainer create 命令时直接传入。

选项	CLI 参数	取值	默认值
主题 / 内容	`--query`	自由文本，或搭配 source	必填
来源 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 会预填并跳过该问题。

主播

解说视频固定使用一个主播。如果你没有指定主播，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 命令返回单集详情。具体形态取决于输出类型：

输出类型	返回链接
文本 + 视频	`videoUrl`（渲染好的视频）、`audioUrl`（配音音轨）、`credits`
仅文本（`--skip-audio`）	仅脚本 — 无 `audioUrl` 或 `videoUrl`，请在在线单集链接处查看脚本

加上 --json 时，命令会打印完整的单集详情（包含 id / episodeId、title 和 processStatus）。不加 --json 时打印精简摘要。

下载

如果输出模式为 download 或 both，AI 还会把文件保存到当前工作目录：

仅文本 — 一个脚本文件，例如 claude-code-explainer.md
文本 + 视频 — 一个 claude-code-explainer/ 文件夹，内含 script.md 和 audio.mp3

无论输出模式如何，在线单集链接总会显示。

积分消耗随脚本长度、图片尺寸以及是否渲染视频而变化，并在生成后的结果中显示。解说视频没有单独的预估命令 — 如果想在渲染视频前先评估范围，可先生成仅文本版本。

技巧

提示词中的详细描述能生成更丰富的配图。
每个章节聚焦一个概念效果最好。
先请求仅文本审阅脚本，再生成视频。
用 --aspect-ratio 9:16 适配竖屏社交格式，用 4K 获得更高分辨率的配图。

API 参考

OpenAPI 中的等价接口是 storybook（同一套后端，命名不同）。接口细节和代码示例请查看解说视频 API 参考。