Адзін POST ставіць рэндэрынг у чаргу. Апытвайце запіс або слухайце жывы паток статусу, а потым атрымайце MP4 і яго поўны рэдагуемы scene graph. Уключана з Plus і вышэй, тарыфікуецца па 2x хвілін плана. Без мінімуму.
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"
} Стварэнне асінхроннае. API адразу адказвае 202 Accepted і запісам у чарзе.
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
} Запытвайце GET /v1/explainer/:id, пакуль запіс не стане ready, або падпішыцеся на GET /v1/explainer/events для абнаўленняў статусу ў рэальным часе. Гатовы запіс нясе URL MP4 і 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 не проста выдае вам файл. Ён выдае вам дакумент. Дашліце праўку простай мовай праз выпушчаны эндпоінт праўак:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Праз секунды ў вас новае відэа з адной змененай сцэнай і ўсім астатнім некранутым. Новая версія застаецца ў гісторыі таго ж тлумачэння, таму вы можаце праверыць або адкаціць яе праз API.
Sketchie пастаўляецца з серверам MCP, таму любы агент з падтрымкай MCP можа генераваць і рэдагаваць тлумачальныя відэа як натыўныя інструменты: згенераваць з дакумента, праверыць scene graph, запытаць праўку, перарэндэрыць. Калі вы будуеце агентаў, якія павінны адказваць відэа замест сцяны тэксту, гэта самы кароткі існуючы шлях.
Выберыце Nora, Miles, Dean, Clara, Piper або Wren з GET /v1/voices. Nora — цёплы апавядальнік па змаўчанні, і кожны голас каталога можа гаварыць на любой падтрымліванай мове. Папярэднія праслухоўванні галасоў уключаны ў адказ каталога.