Ét POST sætter renderingen i kø. Poll posten eller lyt til live-statusstrømmen, og modtag derefter MP4-filen og dens fuldt redigerbare scene graph. Inkluderet fra Plus og opefter, målt til 2x planminutter. Intet 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"
} Oprettelsen er asynkron. API-et svarer straks med 202 Accepted og en post i kø.
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
} Hent GET /v1/explainer/:id, indtil posten er ready, eller abonnér på GET /v1/explainer/events for live-statusopdateringer. Den færdige post bærer MP4-URL og 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": [ ... ] }
} API-et rækker dig ikke bare en fil. Det rækker dig et dokument. Send en redigering i almindeligt sprog via det leverede redigeringsendpoint:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Sekunder senere har du en ny video med én scene ændret og alt andet urørt. Den nye version bliver i den samme forklarings historik, så du kan inspicere eller tilbageføre den via API-et.
Sketchie leverer en MCP-server, så enhver MCP-kapabel agent kan generere og redigere forklaringsvideoer som native værktøjer: generér fra et dokument, inspicér scene graph, anmod om en redigering, rendér igen. Hvis du bygger agenter, der bør svare med video i stedet for en mur af tekst, er dette den korteste vej, der findes.
Vælg Nora, Miles, Dean, Clara, Piper eller Wren fra GET /v1/voices. Nora er den varme standardfortæller, og hver katalogstemme kan tale hvert understøttet sprog. Stemmeforhåndsvisninger er inkluderet i katalogsvaret.