Create an Explainer Video with MCP
Call kp_create and place video settings in the video object:
{ "type": "video", "prompt": "Explain the customer escalation process to new employees from the handbook", "instructions": "Preserve source terminology and cover intake, severity, escalation, and review", "input_file_ids": ["file_xxx"], "max_credits": 300, "video": { "duration_seconds": 120, "aspect_ratio": "16:9", "language": "en", "voice_id": "voice_from_capabilities", "template_id": "template_from_capabilities", "expression_style_id": "style_from_capabilities" }}Before Creating
- Call kp_capabilities.
- Choose a duration target from video.duration_presets.
- Choose language, voice, template, and expression style from the response.
- Upload local sources with kp_upload_file.
- A webpage URL may appear directly in prompt.
A template describes the use case. An expression style describes the visual treatment. They remain independent choices.
After Creating
Poll the same creation with kp_get:
- planning: KPainter is analyzing sources and designing the explanation.
- producing: delivery work is underway.
- paused: present available_actions and wait for the user.
- ready: call kp_outputs.
- failed: show the safe reason and stop polling.
Show estimated_remaining_seconds only when returned. estimated_credits may appear after planning defines the production scope.
Refine
Call kp_message:
{ "creation_id": "creation_xxx", "content": "Keep everything else and make the third scene easier for a beginner", "idempotency_key": "video-edit-20260901-001"}Continue polling with kp_get. Do not create a second creation to represent the same edit.