Один 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 — теплий оповідач за замовчуванням, і кожен голос каталогу може говорити будь-якою підтримуваною мовою. Попередні прослуховування голосів включені у відповідь каталогу.