Un POST posa la renderització a la cua. Sondegeu el registre o escolteu el flux d'estat en directe, i després rebeu el MP4 i el seu scene graph totalment editable. Inclòs des de Plus, mesurat a 2x els minuts del pla. Sense mínim.
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 creació és asíncrona. L'API respon de seguida amb 202 Accepted i un registre a la cua.
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
} Obteniu GET /v1/explainer/:id fins que el registre estigui ready, o subscriviu-vos a GET /v1/explainer/events per a actualitzacions d'estat en directe. El registre a punt porta l'URL del MP4 i el 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 no us lliura només un fitxer. Us lliura un document. Envieu una edició en llenguatge planer mitjançant l'endpoint d'edició lliurat:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Segons després teniu un vídeo nou amb una escena canviada i tota la resta intacta. La nova versió es queda a l'historial del mateix explicatiu, així que la podeu inspeccionar o revertir mitjançant l'API.
Sketchie inclou un servidor MCP, així que qualsevol agent compatible amb MCP pot generar i editar vídeos explicatius com a eines natives: generar des d'un document, inspeccionar el scene graph, demanar una edició, tornar a renderitzar. Si construïu agents que haurien de respondre amb vídeo en lloc d'una paret de text, aquest és el camí més curt que existeix.
Trieu Nora, Miles, Dean, Clara, Piper o Wren des de GET /v1/voices. Nora és la narradora càlida per defecte, i cada veu del catàleg pot parlar tots els idiomes admesos. Les previsualitzacions de veu vénen a la resposta del catàleg.