ListenHubDocs
API 参考解说视频与幻灯片

演示文稿

slides 模式——演示布局、演讲旁白文稿,以及为什么 API 上没有 PPT 导出。

slides 是共用的 storybook 接口上的第三种模式。它产出演示风格的页面,带 AI 画面和演讲旁白文稿, 适用于会议演示、商业汇报和大会演讲。接口、请求参数、轮询、状态以及视频渲染步骤,见 解说视频与幻灯片总览。本页只讲 slides 特有的部分。

在 POST /v1/storybook/episodes 上设置 mode: "slides"。该字段在接口上是可选的——不传得到的是 info,不是 slides——所以对这种模式来说它实际上是必填的。slides 模式画什么,见 总览的模式表。

获取 PPT 文件

PPT 导出不通过 OpenAPI 提供。接口返回的是每一页的图片及其演讲旁白文稿;要导出可编辑的 .pptx,请在 ListenHub 平台上打开该单集。

不渲染视频直接使用各页

slides 是素材本身最常直接作为交付物的模式。pages[] 中的每一项都带有幻灯片画面(imageUrl)和 对应的演讲旁白文稿(text),可当作演讲者备注使用,所以你可以用自己的工具组装演示文稿,完全跳过 视频渲染。

如果你完全不需要旁白音频,创建时再配合 skipAudio: true——图片和文稿照样返回,speakers 变为 可选。

示例

带旁白的演示文稿:

curl -X POST "https://api.marswave.ai/openapi/v1/storybook/episodes" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sources": [
      {"type": "text", "content": "Q3 results: revenue, retention and the two bets for Q4..."}
    ],
    "speakers": [{"speakerId": "<SPEAKER_ID>"}],
    "language": "en",
    "mode": "slides"
  }'

只要幻灯片图片和文稿——不传 speakers,不渲染音频:

curl -X POST "https://api.marswave.ai/openapi/v1/storybook/episodes" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sources": [
      {"type": "url", "content": "https://example.com/quarterly-report"}
    ],
    "language": "zh",
    "mode": "slides",
    "skipAudio": true
  }'

轮询返回的 episodeId,然后按需渲染视频——见 工作流。

本页内容