Explainer Video

Explainer Video

Explainer Video uses explainer_video and creates continuous animated scenes with narration.

{  "type": "explainer_video",  "prompt": "Explain MCP with continuous animated scenes",  "language": "en",  "aspect_ratio": "16:9",  "duration_seconds": 30}

duration_seconds belongs only to Explainer Video and must follow the current catalog limits. After generation, use update_scene_narration or regenerate_scene for a selected scene.

Best-fit requests

Use Explainer Video for one continuous, narrated explanation: a product walkthrough, a course concept, a process, or a technical mechanism. Name the audience, the knowledge that must stay accurate, and the takeaway the viewer should have. A prompt becomes more reliable when it gives an ordered explanation rather than only a topic label.

Create and retrieve the result

Read /catalog first and select a supported language, ratio, duration, voice, style, and output quality. Submit the request to POST /creations, retain the returned job_id, and poll GET /creations/jobs/{job_id}. Once the job succeeds, retrieve GET /creations/{creation_id} to read the actual main_url, artifacts[], scenes[], and editable_actions.

If a scene needs a correction, verify the returned editable actions before using update_scene_narration or regenerate_scene. If the job fails, fix the reported validation, entitlement, or prompt problem before creating a new result.

Related guides

• Quickstart for a full request example
• Creations & Jobs for status polling
• Editing & Errors for a supported scene revision