概览/OpenAPI/绘本视频

绘本视频

逐页图文画面与旁白的绘本视频请求。

绘本视频

绘本视频使用 read_aloud_video,生成图文画面和旁白组成的逐页视频。

{  "type": "read_aloud_video",  "prompt": "用 6 页逐步讲清楚 MCP 是什么",  "language": "zh",  "aspect_ratio": "16:9",  "scene_count": 6}

scene_count 只使用 Catalog 允许的页数。详情除了视频,还可能返回PPT或PDF产物。

不要传 duration_seconds

最适合的请求

当内容需要按页面逐步展开时,选择绘本视频:旁白课程、第一周指南、故事或公共流程说明。明确谁在观看、每一页应完成什么,以及哪些术语必须保持准确。这样可避免逐页视频变成互不相连的幻灯片集合。

使用类型专属控制项

创建前读取 /catalog,只使用它允许的 scene_count、语言、比例、风格、音色和质量。scene_count 控制页数,duration_seconds 不属于此类型。提交 POST /creations,轮询返回任务,再从详情中读取完成视频以及可能的 PPT、PDF 产物。

需要修改时,先检查完成 creation 的 editable_actionsscenes[]。任务失败时根据结构化状态修正不支持的值或缺失的说明,而不是原样再次提交。

关联文档