Jedan POST stavlja renderiranje u red. Pratite zapis pollingom ili slušajte stream statusa uživo, a zatim primite MP4 i njegov potpuno uredivi scene graph. Uključeno od Plus naviše, mjereno na 2x minuta plana. 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"
} Stvaranje je asinkrono. API odmah odgovara s 202 Accepted i zapisom u redu.
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
} Dohvaćajte GET /v1/explainer/:id dok zapis ne bude ready, ili se pretplatite na GET /v1/explainer/events za ažuriranja statusa uživo. Gotovi zapis nosi URL MP4-a i 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 vam ne pruža samo datoteku. Pruža vam dokument. Pošaljite uređivanje na jednostavnom jeziku putem isporučenog endpointa za uređivanje:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Sekunde kasnije imate novi videozapis s jednom promijenjenom scenom i svime ostalim netaknutim. Nova verzija ostaje u povijesti istog objašnjenja, pa je možete pregledati ili vratiti putem API-ja.
Sketchie isporučuje MCP poslužitelj, tako da bilo koji agent koji podržava MCP može generirati i uređivati videozapise objašnjenja kao izvorne alate: generirajte iz dokumenta, pregledajte scene graph, zatražite uređivanje, ponovno renderirajte. Ako gradite agente koji bi trebali odgovarati videom umjesto zidom teksta, ovo je najkraći put koji postoji.
Odaberite Nora, Miles, Dean, Clara, Piper ili Wren iz GET /v1/voices. Nora je topli zadani pripovjedač, a svaki glas iz kataloga može govoriti svaki podržani jezik. Pregledi glasova uključeni su u odgovor kataloga.