Нэг POST нь render-ийг дараалалд оруулна. Бичлэгийг poll хийх эсвэл шууд төлөвийн урсгалыг сонсоод, дараа нь 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
} Бичлэг ready болтол GET /v1/explainer/:id-ийг авах, эсвэл шууд төлөвийн шинэчлэлтэд GET /v1/explainer/events-д бүртгүүлнэ үү. Бэлэн бичлэг нь MP4 URL болон 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 танд зөвхөн файл өгдөггүй. Танд баримт бичиг өгдөг. Гаргасан засварын endpoint-оор энгийн хэлээр засвар илгээнэ үү:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Хэдэн секундын дараа танд нэг дүр өөрчлөгдсөн, бусад бүх зүйл хөндөгдөөгүй шинэ видео байна. Шинэ хувилбар нь ижил тайлбарын түүхэнд үлддэг тул та үүнийг API-аар шалгах эсвэл буцаах боломжтой.
Sketchie нь MCP сервер гаргадаг тул MCP дэмждэг аливаа агент тайлбар видеог native хэрэгсэл болгон үүсгэж, засварлаж чадна: баримтаас үүсгэх, scene graph шалгах, засвар хүсэх, дахин render хийх. Хэрэв та текстийн ханын оронд видеогоор хариулах ёстой агентуудыг бүтээж байгаа бол энэ бол оршин байгаа хамгийн богино зам юм.
GET /v1/voices-аас Nora, Miles, Dean, Clara, Piper эсвэл Wren-ийг сонгоно уу. Nora бол дулаахан өгөгдмөл өгүүлэгч бөгөөд каталогийн дуу хоолой бүр дэмжигдсэн хэл бүрээр ярьж чадна. Дуу хоолойн урьдчилсан сонсголыг каталогийн хариултад багтаасан.