Ee POST setzt de render an d'Schlaang. Poll de Rekord oder lauschtert dem live Statusstroum, a kritt dann d'MP4 a säin voll editéierbaren scene graph. Abegraff vu Plus erop, gemooss op 2x Planminutten. Kee 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"
} D'Erstellung ass asynchron. D'API äntwert direkt mat 202 Accepted an engem Rekord an der Schlaang.
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
} Rufft GET /v1/explainer/:id of bis de Rekord ready ass, oder abonnéiert GET /v1/explainer/events fir live Statusaktualiséierungen. Den fäerdege Rekord dréit d'MP4-URL an 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": [ ... ] }
} D'API iwwerreecht der net just eng Datei. Si iwwerreecht der en Dokument. Schéckt eng Ännerung a klorer Sprooch iwwer den ausgeliwwerten Ännerungs-endpoint:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Sekonne méi spéit hutt der en neit Video mat enger geännerter Szen an allem aneren onberéiert. Déi nei Versioun bleift an der Geschicht vum selwechten Erklärungsvideo, sou datt der se iwwer d'API inspizéieren oder zrécksetzen kënnt.
Sketchie liwwert en MCP-Server, sou datt all MCP-fäegen Agent Erklärungsvideoen als native Tools generéiere an änneren kann: generéiert aus engem Dokument, inspizéiert de scene graph, freet eng Ännerung un, rendert nei. Wann der Agenten baut déi mat Video amplaz enger Textmauer äntwere sollten, ass dat de kierzste Wee dee existéiert.
Wielt Nora, Miles, Dean, Clara, Piper oder Wren aus GET /v1/voices. Nora ass déi waarm Standard-Erzielerin, an all Katalogstëmm ka jiddwer ënnerstëtzt Sprooch schwätzen. Stëmmvirschauen si am Katalogäntwert abegraff.