通过 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_id、style_id 和 output_quality。
创建后用 kp_get_job_status 轮询,再用 kp_get_creation 读取结果。对支持的场景,可调用 kp_edit_creation 执行 update_scene_narration 或 regenerate_scene。
什么时候选择解说视频
当观众需要顺着一条完整叙事理解产品、培训概念、技术机制或决策时,选择解说视频。提示词应明确受众、必须保持准确的源事实,以及观众最终需要理解什么。“解释登录政策”不如“面向新员工,按登录、二次验证、异常处理的顺序解释政策,并保留原有术语”可执行。
从创建到可交付结果
创建是异步的。保存 kp_create_creation 返回的 job_id,用 kp_get_job_status 轮询,只有成功后才展示结果。再通过 kp_get_creation 读取 main_url、artifacts、scenes 和 editable_actions;不要自行推测下载地址,也不要把排队中的任务当成可播放成片。
任务失败时先读取结构化状态。修改不支持的 Catalog 参数或补全提示词后再重试,避免盲目提交重复任务。
