Un POST mette il render in coda. Interroga il record o ascolta lo stream di stato dal vivo, poi ricevi l’MP4 e il suo scene graph completo e modificabile. Incluso da Plus in su, conteggiato a 2x i minuti del piano. Nessun minimo.
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 creazione è asincrona. L’API risponde subito con 202 Accepted e un record in coda.
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
} Interroga GET /v1/explainer/:id finché il record è ready, oppure iscriviti a GET /v1/explainer/events per aggiornamenti di stato dal vivo. Il record pronto porta l’URL dell’MP4 e lo 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": [ ... ] }
} L’API non ti consegna solo un file. Ti consegna un documento. Invia una modifica in linguaggio naturale tramite l’endpoint di modifica già disponibile:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Pochi secondi dopo hai un nuovo video con una scena cambiata e tutto il resto intatto. La nuova versione resta nella cronologia dello stesso esplicativo, così puoi ispezionarla o ripristinarla tramite l’API.
Sketchie include un server MCP, così qualsiasi agente compatibile MCP può generare e modificare video esplicativi come strumenti nativi: generare da un documento, ispezionare lo scene graph, richiedere una modifica, ri-renderizzare. Se costruisci agenti che dovrebbero rispondere con un video invece di un muro di testo, questo è il percorso più breve che esista.
Scegli Nora, Miles, Dean, Clara, Piper o Wren da GET /v1/voices. Nora è la narratrice calda predefinita, e ogni voce del catalogo può parlare tutte le lingue supportate. Le anteprime delle voci sono incluse nella risposta del catalogo.