概览/MCP/解说视频

解说视频

通过 MCP 创建连续动态画面与旁白组成的解说视频。

通过 MCP 创建解说视频

解说视频使用 explainer_video,生成连续动态画面和旁白。

先调用 kp_get_catalog,再把下面这些参数传给 kp_create_creation

{  "type": "explainer_video",  "prompt": "用连续动态画面讲清楚 MCP 是什么",  "language": "zh",  "aspect_ratio": "16:9",  "duration_seconds": 30}

duration_seconds 只属于解说视频,并且必须符合当前 Catalog 的账号限制。需要音色、风格和质量时,也从 Catalog 选择 voice_idstyle_idoutput_quality

创建后用 kp_get_job_status 轮询,再用 kp_get_creation 读取结果。对支持的场景,可调用 kp_edit_creation 执行 update_scene_narrationregenerate_scene

什么时候选择解说视频

当观众需要顺着一条完整叙事理解产品、培训概念、技术机制或决策时,选择解说视频。提示词应明确受众、必须保持准确的源事实,以及观众最终需要理解什么。“解释登录政策”不如“面向新员工,按登录、二次验证、异常处理的顺序解释政策,并保留原有术语”可执行。

从创建到可交付结果

创建是异步的。保存 kp_create_creation 返回的 job_id,用 kp_get_job_status 轮询,只有成功后才展示结果。再通过 kp_get_creation 读取 main_urlartifactssceneseditable_actions;不要自行推测下载地址,也不要把排队中的任务当成可播放成片。

任务失败时先读取结构化状态。修改不支持的 Catalog 参数或补全提示词后再重试,避免盲目提交重复任务。

继续阅读