Jeden POST zaradí render do frontu. Dopytujte sa na záznam alebo počúvajte živý stream stavu a potom dostanete MP4 a jeho plne upraviteľný scene graph. Zahrnuté od Plus vyššie, merané na 2x minút 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"
} Vytvorenie je asynchrónne. API okamžite odpovedá 202 Accepted a záznamom vo fronte.
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čítavajte GET /v1/explainer/:id, kým záznam nie je ready, alebo sa prihláste na odber GET /v1/explainer/events pre živé aktualizácie stavu. Hotový záznam nesie 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 neodovzdáva len súbor. Odovzdáva vám dokument. Pošlite úpravu v jednoduchom jazyku cez vydaný editačný endpoint:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } O pár sekúnd máte nové video s jednou zmenenou scénou a všetkým ostatným nedotknutým. Nová verzia zostáva v histórii toho istého vysvetlenia, takže ju môžete skontrolovať alebo vrátiť cez API.
Sketchie dodáva server MCP, takže akýkoľvek agent podporujúci MCP môže generovať a upravovať vysvetľujúce videá ako natívne nástroje: generovať z dokumentu, skontrolovať scene graph, požiadať o úpravu, znova vyrenderovať. Ak staviate agentov, ktorí by mali odpovedať videom namiesto steny textu, je to najkratšia existujúca cesta.
Vyberte Nora, Miles, Dean, Clara, Piper alebo Wren z GET /v1/voices. Nora je vrelý predvolený rozprávač a každý hlas z katalógu vie hovoriť každým podporovaným jazykom. Náhľady hlasov sú zahrnuté v odpovedi katalógu.