Vienas POST įstato atvaizdavimą į eilę. Apklauskite įrašą arba klausykitės tiesioginio būsenos srauto, tada gaukite MP4 ir jo visiškai redaguojamą scene graph. Įtraukta nuo Plus aukštyn, matuojama 2x plano minučių. Jokio minimumo.
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"
} Kūrimas yra asinchroninis. API iškart atsako 202 Accepted ir įrašu eilėje.
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
} Gaukite GET /v1/explainer/:id, kol įrašas bus ready, arba užsiprenumeruokite GET /v1/explainer/events, kad gautumėte tiesioginius būsenos atnaujinimus. Paruoštas įrašas neša MP4 URL ir 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 neįteikia jums vien failo. Jis įteikia jums dokumentą. Siųskite redagavimą paprasta kalba per pristatytą redagavimo galinį tašką:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Po kelių sekundžių turite naują vaizdo įrašą su viena pakeista scena ir viskuo kitu nepaliestu. Nauja versija lieka to paties aiškinimo istorijoje, todėl galite ją apžiūrėti arba atkurti per API.
Sketchie pristato MCP serverį, todėl bet kuris MCP palaikantis agentas gali generuoti ir redaguoti aiškinamuosius vaizdo įrašus kaip savuosius įrankius: generuokite iš dokumento, apžiūrėkite scene graph, paprašykite redagavimo, atvaizduokite iš naujo. Jei kuriate agentus, kurie turėtų atsakyti vaizdo įrašu, o ne teksto siena, tai yra trumpiausias egzistuojantis kelias.
Pasirinkite Nora, Miles, Dean, Clara, Piper arba Wren iš GET /v1/voices. Nora yra šiltas numatytasis pasakotojas, ir kiekvienas katalogo balsas gali kalbėti kiekviena palaikoma kalba. Balsų peržiūros įtrauktos į katalogo atsaką.