Viens POST ievieto renderēšanu rindā. Aptaujājiet ierakstu vai klausieties tiešraides statusa straumi, pēc tam saņemiet MP4 un tā pilnībā rediģējamo scene graph. Iekļauts no Plus uz augšu, mērīts pie 2x plāna minūtēm. Bez minimuma.
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"
} Izveide ir asinhrona. API nekavējoties atbild ar 202 Accepted un ierakstu rindā.
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
} Iegūstiet GET /v1/explainer/:id, līdz ieraksts ir ready, vai abonējiet GET /v1/explainer/events tiešraides statusa atjauninājumiem. Gatavais ieraksts nes MP4 URL un 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 nepasniedz jums tikai failu. Tas pasniedz jums dokumentu. Nosūtiet rediģējumu vienkāršā valodā caur piegādāto rediģēšanas galapunktu:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Sekundes vēlāk jums ir jauns video ar vienu mainītu ainu un visu pārējo neskartu. Jaunā versija paliek tā paša skaidrojuma vēsturē, tāpēc jūs varat to pārbaudīt vai atgriezt caur API.
Sketchie piegādā MCP serveri, tāpēc jebkurš MCP spējīgs aģents var ģenerēt un rediģēt skaidrojošus video kā vietējos rīkus: ģenerējiet no dokumenta, pārbaudiet scene graph, pieprasiet rediģējumu, renderējiet vēlreiz. Ja jūs veidojat aģentus, kuriem vajadzētu atbildēt ar video, nevis teksta sienu, šis ir īsākais ceļš, kāds pastāv.
Izvēlieties Nora, Miles, Dean, Clara, Piper vai Wren no GET /v1/voices. Nora ir siltais noklusējuma stāstītājs, un katra kataloga balss var runāt katrā atbalstītajā valodā. Balsu priekšskatījumi ir iekļauti kataloga atbildē.