Egy POST sorba állítja a renderelést. Kérdezd le a rekordot vagy figyeld az élő állapotfolyamot, majd fogadd az MP4-et és a teljes szerkeszthető scene graph-ját. A Plustól felfelé benne van, a terv perceinek 2x-én mérve. Nincs minimum.
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"
} A létrehozás aszinkron. Az API azonnal 202 Accepted választ ad egy sorba állított rekorddal.
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
} Kérd le a GET /v1/explainer/:id-t, amíg a rekord ready nem lesz, vagy iratkozz fel a GET /v1/explainer/events-re az élő állapotfrissítésekért. A kész rekord hordozza az MP4 URL-t és a scene graph-ot.
GET /v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b
{
"id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
"status": "ready",
"videoUrl": "https://media.sketchie.ai/....mp4",
"sceneGraph": { "scenes": [ ... ] }
} Az API nem csak egy fájlt ad a kezedbe. Egy dokumentumot ad. Küldj egy egyszerű nyelvű szerkesztést a kiadott szerkesztési végponton keresztül:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Másodpercekkel később van egy új videód, amelyben egy jelenet megváltozott, minden más érintetlen. Az új verzió ugyanannak a magyarázónak az előzményeiben marad, így megvizsgálhatod vagy visszaállíthatod az API-n keresztül.
A Sketchie egy MCP szervert szállít, így bármely MCP-képes ügynök natív eszközként generálhat és szerkeszthet magyarázó videókat: generálás dokumentumból, a scene graph megvizsgálása, szerkesztés kérése, újrarenderelés. Ha olyan ügynököket építesz, amelyeknek videóval kellene válaszolniuk egy szövegfal helyett, ez a létező legrövidebb út.
Válaszd a Nora, Miles, Dean, Clara, Piper vagy Wren egyikét a GET /v1/voices-ból. A Nora a meleg alapértelmezett narrátor, és a katalógus minden hangja beszéli az összes támogatott nyelvet. A hangelőnézetek benne vannak a katalógus válaszában.