Un POST pon a renderización na cola. Sondea o rexistro ou escoita o fluxo de estado en directo, e despois recibe o MP4 e o seu scene graph totalmente editable. Incluído desde Plus, medido a 2x os minutos do plan. Sen 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"
} A creación é asíncrona. A API responde de inmediato con 202 Accepted e un rexistro na 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
} Obtén GET /v1/explainer/:id ata que o rexistro estea ready, ou subscríbete a GET /v1/explainer/events para actualizacións de estado en directo. O rexistro listo leva o URL do MP4 e o 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": [ ... ] }
} A API non che entrega só un ficheiro. Entrégache un documento. Envía unha edición en linguaxe sinxela a través do endpoint de edición dispoñible:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Segundos despois tes un novo vídeo cunha escena cambiada e todo o demais intacto. A nova versión queda no historial do mesmo explicativo, así que podes inspeccionala ou revertela a través da API.
Sketchie inclúe un servidor MCP, así que calquera axente compatible con MCP pode xerar e editar vídeos explicativos como ferramentas nativas: xerar desde un documento, inspeccionar o scene graph, pedir unha edición, renderizar de novo. Se estás a construír axentes que deberían responder con vídeo en vez dun muro de texto, este é o camiño máis curto que existe.
Escolle Nora, Miles, Dean, Clara, Piper ou Wren desde GET /v1/voices. Nora é a narradora cálida predeterminada, e cada voz do catálogo pode falar todos os idiomas admitidos. As previsualizacións de voz veñen na resposta do catálogo.