Un POST pune randarea în coadă. Interogați înregistrarea sau ascultați fluxul de stare live, apoi primiți MP4-ul și scene graph-ul său complet editabil. Inclus de la Plus în sus, contorizat la 2x minutele planului. Fără minim.
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"
} Crearea este asincronă. API-ul răspunde imediat cu 202 Accepted și o înregistrare în coadă.
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
} Preluați GET /v1/explainer/:id până când înregistrarea este ready, sau abonați-vă la GET /v1/explainer/events pentru actualizări de stare live. Înregistrarea gata poartă URL-ul MP4 și scene graph-ul.
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-ul nu vă înmânează doar un fișier. Vă înmânează un document. Trimiteți o editare în limbaj simplu prin endpoint-ul de editare livrat:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Câteva secunde mai târziu aveți un videoclip nou cu o scenă schimbată și tot restul neatins. Noua versiune rămâne în istoricul aceluiași explicativ, așa că o puteți inspecta sau reveni la ea prin API.
Sketchie livrează un server MCP, astfel încât orice agent capabil de MCP poate genera și edita videoclipuri explicative ca instrumente native: generați dintr-un document, inspectați scene graph-ul, cereți o editare, randați din nou. Dacă construiți agenți care ar trebui să răspundă cu video în loc de un zid de text, aceasta este cea mai scurtă cale care există.
Alegeți Nora, Miles, Dean, Clara, Piper sau Wren din GET /v1/voices. Nora este naratorul implicit cald, iar fiecare voce din catalog poate vorbi fiecare limbă acceptată. Previzualizările vocilor sunt incluse în răspunsul catalogului.