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