概覽/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 來代替同一次編輯。