Explainer Video OpenAPI

Explainer Video

Explainer Video uses type: video. It creates a complete narrated video from a topic, webpage, or uploaded source.

Create Example

{  "type": "video",  "prompt": "Explain the customer escalation process to new employees",  "instructions": "Follow intake, severity, escalation, and review; preserve source terminology",  "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"  }}

The video object is required for type: video. Choose every value from the current GET /capabilities response.

Templates and Expression Styles

template_id chooses a use case and starting content structure, such as employee training, software tutorial, or research summary.
expression_style_id chooses how the video communicates visually, such as whiteboard explanation, clean infographic, or cinematic documentary.
They are independent. A template does not lock its recommended visual style.
Omit optional selections to let KPainter design them from the content.

Duration, Language, and Voice

duration_seconds accepts advertised target values, not arbitrary seconds. The public video aspect ratio is currently fixed at 16:9. Choose language and voice_id from current capabilities or omit optional fields when the user has no preference.

Webpages and Uploaded Sources

A URL may appear directly in prompt because Explainer Video supports URL Context.
Upload PDFs, presentations, documents, spreadsheets, and images through POST /files, then pass input_file_ids.
Attachments are source material and are never copied from another user's creation or remix.
State the audience, facts that must remain exact, and what viewers should understand.

Review and Progress

Poll GET /creations/{id}:

planning means KPainter is analyzing sources and designing the explanation.
producing means delivery work is underway.
review, when present, is a safe outline and scene summary.
estimated_remaining_seconds appears only when reliable.
estimated_credits may appear after planning fixes the production scope.
ready means outputs are available.

Refine the Video

After the first version, send a natural-language message such as:

Make the third scene more concise.
Keep the structure and use a more professional tone.
Update only the selected scene's data explanation.

The edit stays attached to the same creation and follows the same asynchronous status flow.