Üks POST paneb renderdamise järjekorda. Küsitle kirjet või kuula reaalajas olekuvoogu, seejärel võta vastu MP4 ja selle täielikult redigeeritav scene graph. Kaasas alates Plusist ülespoole, mõõdetud 2x paketiminutites. Miinimumi pole.
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"
} Loomine on asünkroonne. API vastab kohe 202 Accepted ja järjekorras oleva kirjega.
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
} Hangi GET /v1/explainer/:id, kuni kirje on ready, või telli GET /v1/explainer/events reaalajas olekuvärskenduste jaoks. Valmis kirje kannab MP4 URL-i ja scene graph-i.
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 ei ulata sulle lihtsalt faili. See ulatab sulle dokumendi. Saada lihtsas keeles redigeerimine tarnitud redigeerimise lõpp-punkti kaudu:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Sekundeid hiljem on sul uus video, kus üks stseen on muutunud ja kõik muu puutumata. Uus versioon jääb sama selgituse ajalukku, nii et saad seda API kaudu üle vaadata või taastada.
Sketchie tarnib MCP-serveri, nii et iga MCP-võimeline agent saab genereerida ja redigeerida selgitusvideoid natiivsete tööriistadena: genereeri dokumendist, vaata üle scene graph, taotle redigeerimist, renderda uuesti. Kui ehitad agente, kes peaksid vastama videoga tekstimüüri asemel, on see lühim olemasolev tee.
Vali Nora, Miles, Dean, Clara, Piper või Wren kohast GET /v1/voices. Nora on soe vaikimisi jutustaja, ja iga kataloogi hääl oskab rääkida iga toetatud keelt. Häälte eelvaated on kaasas kataloogi vastuses.