概览/MCP/解说视频

解说视频

通过自然语言、网页或附件创建和修改视频。

通过 MCP 创建解说视频

调用 kp_create,并把视频参数放入 video 对象:

{  "type": "video",  "prompt": "根据培训手册,面向新员工解释客户问题升级流程",  "instructions": "保留原文术语,按受理、分级、升级和复盘的顺序讲解",  "input_file_ids": ["file_xxx"],  "max_credits": 300,  "video": {    "duration_seconds": 120,    "aspect_ratio": "16:9",    "language": "zh",    "voice_id": "voice_from_capabilities",    "template_id": "template_from_capabilities",    "expression_style_id": "style_from_capabilities"  }}

创建前

  1. 调用 kp_capabilities。
  2. 从 video.duration_presets 选择目标时长。
  3. 从 languages、templates 和 expression_styles 选择设置。
  4. 有附件时先调用 kp_upload_file。
  5. 网页 URL 可以直接写在 prompt 中。

模板代表使用场景,表达风格代表画面表达,两者可以独立选择。

创建后

用 kp_get 查询同一个 creation:

  • planning:正在分析来源和设计内容。
  • producing:正在生成。
  • paused:展示 available_actions,等待用户处理。
  • ready:调用 kp_outputs。
  • failed:展示安全原因,停止轮询。

可靠时可以向用户展示 estimated_remaining_seconds;规划完成后可能出现 estimated_credits。不要自行估算。

修改

使用 kp_message:

{  "creation_id": "creation_xxx",  "content": "保留其他内容,只把第三个场景改得更适合初学者",  "idempotency_key": "video-edit-20260901-001"}

修改后继续调用 kp_get。不要新建另一个 creation 来代替同一次编辑。