Едно 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 е топлият разказвач по подразбиране, а всеки глас от каталога може да говори всеки поддържан език. Визуализациите на гласовете са включени в отговора на каталога.