知识视频

知识视频接口

这页从“知识视频家族”的角度组织同一套 OpenAPI。

公开类型有三种：

• explainer_video
• slides_video
• vector_animation

兼容说明：

• knowledge_video 仍兼容作为历史输入别名
• 现在 catalog 和 API 响应统一返回 explainer_video

先做类型映射

如果你在产品里接自然语言输入，建议先做一层“用户说法 -> OpenAPI type” 映射：

当请求只写 知识视频 / 讲解视频 / 解说视频 时，通常先落到 explainer_video；只有当请求明确强调“图解版 / 分步骤 / PPT 风格 / 课件感”时，再切到 slides_video。

最小创建请求

核心接口仍然是：

POST /creations

最常见的字段：

explainer_video

{  "type": "explainer_video",  "prompt": "做一个 30 秒左右的讲解视频，讲清楚 MCP 是什么",  "language": "zh",  "aspect_ratio": "16:9",  "duration_seconds": 30}

slides_video

{  "type": "slides_video",  "prompt": "做一个 PPT 视频，用 6 页分步骤讲清楚 MCP 是什么",  "language": "zh",  "aspect_ratio": "16:9",  "scene_count": 6}

vector_animation

{  "type": "vector_animation",  "prompt": "用矢量动画讲清楚 MCP 的请求流程",  "language": "zh",  "aspect_ratio": "16:9"}

其中 duration_seconds 不要传给 vector_animation，scene_count 也不要拿来给 explainer_video。真实可用时长、页数、音色、风格、比例和质量，都先以 /catalog 为准。

生成后的标准读取链路

创建后，最常见链路是：

1. GET /creations/jobs/{job_id}
2. GET /creations/{creation_id}
3. GET /creations

重点关注：

• status
• progress_pct
• current_step
• main_url
• artifacts[]
• scenes[]

编辑

视频类通常最常用编辑能力。

接口：

POST /creations/{creation_id}/edit

常见动作：

• update_scene_narration
• regenerate_scene

如果你要做“单页重写 / 单场景重生成 / 修改旁白”这类二次编辑，优先基于已有 creation_id 继续走编辑接口，而不是重新发起一次完整创建。

导出与结果读取

优先使用详情接口里已经返回的结果，不要自己拼导出链接。

explainer_video / vector_animation

先按“视频结果”理解：

• main_url
• 字幕资源
• 场景级素材

slides_video

除了视频本身，还可能额外带：

• PPT
• PDF

如果详情里已经有这些文档资源，直接使用即可；不要额外再造一层“导出任务”，除非接口明确要求。

实践建议

• 先把“用户说法”和 type 映射表写清楚，再写创建逻辑
• explainer_video / vector_animation 先按视频工作流处理，slides_video 再额外补文档导出
• /catalog 不是可选接口，类型限制和参数枚举都应以它为准