Un POST pone el render en cola. Sondea el registro o escucha el stream de estado en vivo, y luego recibe el MP4 y su scene graph completo y editable. Incluido desde Plus, medido a 2x los minutos del plan. Sin mínimo.
POST /v1/explainer
{
"input": "Explain how recurring billing works",
"length": "1:00", // optional, in 30-second steps up to "6:00"
"aspect": "16:9", // 16:9, 9:16, 1:1
"voice": "sketchie:sulafat", // Nora, the default narrator
"language": "en"
} La creación es asíncrona. La API responde de inmediato con 202 Accepted y un registro en cola.
HTTP/1.1 202 Accepted
{
"id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
"status": "queued",
"prompt": "Explain how recurring billing works",
"lengthSeconds": 60,
"voice": "sketchie:sulafat",
"language": "en",
"aspect": "16:9",
"videoUrl": null,
"sceneGraph": null
} Consulta GET /v1/explainer/:id hasta que el registro esté ready, o suscríbete a GET /v1/explainer/events para actualizaciones de estado en vivo. El registro listo lleva la URL del MP4 y el scene graph.
GET /v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b
{
"id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
"status": "ready",
"videoUrl": "https://media.sketchie.ai/....mp4",
"sceneGraph": { "scenes": [ ... ] }
} La API no solo te entrega un archivo. Te entrega un documento. Envía una edición en lenguaje natural a través del endpoint de edición ya disponible:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Segundos después tienes un vídeo nuevo con una escena cambiada y todo lo demás intacto. La nueva versión queda en el historial del mismo explicativo, así que puedes inspeccionarla o revertirla a través de la API.
Sketchie incluye un servidor MCP, así que cualquier agente con soporte MCP puede generar y editar vídeos explicativos como herramientas nativas: generar desde un documento, inspeccionar el scene graph, pedir una edición, volver a renderizar. Si construyes agentes que deberían responder con vídeo en lugar de un muro de texto, este es el camino más corto que existe.
Elige Nora, Miles, Dean, Clara, Piper o Wren desde GET /v1/voices. Nora es la narradora cálida por defecto, y cada voz del catálogo puede hablar todos los idiomas admitidos. Las vistas previas de voz vienen en la respuesta del catálogo.