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