Jeden POST zařadí render do fronty. Dotazujte se na záznam nebo poslouchejte živý stream stavu a poté obdržíte MP4 a jeho plně upravitelný scene graph. Zahrnuto od Plus výše, měřeno na 2x minut plánu. Bez minima.
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"
} Vytvoření je asynchronní. API okamžitě odpovídá 202 Accepted a záznamem ve frontě.
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
} Načítejte GET /v1/explainer/:id, dokud záznam není ready, nebo se přihlaste k odběru GET /v1/explainer/events pro živé aktualizace stavu. Hotový záznam nese URL MP4 a 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 vám nepředává jen soubor. Předává vám dokument. Pošlete úpravu v prostém jazyce přes vydaný editační endpoint:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } O pár sekund později máte nové video s jednou změněnou scénou a vším ostatním nedotčeným. Nová verze zůstává v historii téhož vysvětlení, takže ji můžete zkontrolovat nebo vrátit přes API.
Sketchie dodává server MCP, takže jakýkoli agent podporující MCP může generovat a upravovat vysvětlující videa jako nativní nástroje: generovat z dokumentu, zkontrolovat scene graph, požádat o úpravu, znovu vyrenderovat. Pokud stavíte agenty, kteří by měli odpovídat videem místo zdi textu, je to nejkratší existující cesta.
Vyberte Nora, Miles, Dean, Clara, Piper nebo Wren z GET /v1/voices. Nora je vřelý výchozí vypravěč a každý hlas z katalogu umí mluvit každým podporovaným jazykem. Náhledy hlasů jsou zahrnuty v odpovědi katalogu.