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

本页内容