Een POST plaas die render in die tou. Poll die rekord of luister na die lewendige statusstroom, en ontvang dan die MP4 en sy volledig redigeerbare scene graph. Ingesluit vanaf Plus opwaarts, gemeet teen 2x planminute. Geen minimum nie.
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"
} Skepping is asinchroon. Die API antwoord onmiddellik met 202 Accepted en 'n rekord in die tou.
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 totdat die rekord ready is, of teken in op GET /v1/explainer/events vir lewendige statusopdaterings. Die gereed rekord dra die MP4-URL en 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": [ ... ] }
} Die API gee jou nie net 'n lêer nie. Dit gee jou 'n dokument. Stuur 'n redigering in gewone taal via die gestuurde redigeringsendpoint:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Sekondes later het jy 'n nuwe video met een toneel verander en alles anders onaangeraak. Die nuwe weergawe bly in dieselfde verduideliking se geskiedenis, sodat jy dit via die API kan inspekteer of terugrol.
Sketchie stuur 'n MCP-bediener, so enige MCP-vaardige agent kan verduidelikingsvideo's as inheemse gereedskap genereer en redigeer: genereer vanaf 'n dokument, inspekteer die scene graph, versoek 'n redigering, render weer. As jy agente bou wat met video moet antwoord in plaas van 'n muur van teks, is dit die kortste pad wat bestaan.
Kies Nora, Miles, Dean, Clara, Piper of Wren uit GET /v1/voices. Nora is die warm verstek-verteller, en elke katalogusstem kan elke ondersteunde taal praat. Stemvoorskoue is ingesluit in die katalogusantwoord.