API 参考解说视频与幻灯片
解说视频与故事
info 与 story 两种模式——各自画什么、什么时候选哪个,以及区分它们的那一个字段。
info 和 story 是共用的 storybook 接口上三种模式中的两种。接口、请求参数、轮询、状态以及视频渲染步骤,见
解说视频与幻灯片总览。本页只讲这两种模式各自特有的部分。
mode 可选,不传即为 info。请求的其余部分两者完全相同——同一个接口、同样的参数、同样的响应结构。总览页的模式表列出了各自画什么。
什么时候选哪个
当来源本身有值得展示的结构时选 info:一组对比、一段流程、一批数字。画面偏向图表和示意图,封面读起来像杂志专题。
当来源是一段叙事时选 story:一次客户旅程、一个创业故事、一则案例研究。画面是场景插画而不是示意图,所以一页统计数据返回时会是「统计数据的插画」,而不是把它们画成图表。
示例
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"}
],
"speakers": [{"speakerId": "<SPEAKER_ID>"}],
"language": "en",
"mode": "info"
}'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": "How a two-person team shipped their first product in ninety days..."}
],
"speakers": [{"speakerId": "<SPEAKER_ID>"}],
"language": "en",
"mode": "story"
}'两者都返回 episodeId。轮询它,然后按需渲染视频——见
工作流。