Eén POST zet de render in de wachtrij. Poll het record of luister naar de live statusstream, en ontvang dan de MP4 en de volledige bewerkbare scene graph. Inbegrepen vanaf Plus, gemeten op 2x planminuten. Geen minimum.
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"
} Het aanmaken is asynchroon. De API antwoordt onmiddellijk met 202 Accepted en een record in de wachtrij.
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
} Haal GET /v1/explainer/:id op tot het record ready is, of abonneer je op GET /v1/explainer/events voor live statusupdates. Het gerede record draagt de MP4-URL en de 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": [ ... ] }
} De API geeft je niet zomaar een bestand. Ze geeft je een document. Stuur een bewerking in gewone taal via het uitgebrachte bewerkingsendpoint:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Seconden later heb je een nieuwe video met één gewijzigde scène en al het andere ongemoeid. De nieuwe versie blijft in de geschiedenis van dezelfde uitlegvideo, dus je kunt die via de API inspecteren of terugdraaien.
Sketchie levert een MCP-server, dus elke MCP-capabele agent kan uitlegvideo's genereren en bewerken als native tools: genereer uit een document, inspecteer de scene graph, vraag een bewerking aan, render opnieuw. Als je agenten bouwt die met video moeten antwoorden in plaats van met een muur van tekst, is dit de kortste weg die bestaat.
Kies Nora, Miles, Dean, Clara, Piper of Wren uit GET /v1/voices. Nora is de warme standaardverteller, en elke catalogusstem kan elke ondersteunde taal spreken. Stemvoorbeelden zijn opgenomen in het catalogusantwoord.