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,然后按需渲染视频——见
工作流。