En POST postavi upodabljanje v čakalno vrsto. Poizvedujte po zapisu ali poslušajte tok stanja v živo, nato prejmite MP4 in njegov popolnoma urejljivi scene graph. Vključeno od Plus navzgor, merjeno pri 2x minut paketa. Brez 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"
} Ustvarjanje je asinhrono. API se takoj odzove z 202 Accepted in zapisom v čakalni vrsti.
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
} Pridobivajte GET /v1/explainer/:id, dokler zapis ni ready, ali se naročite na GET /v1/explainer/events za posodobitve stanja v živo. Pripravljen zapis nosi URL MP4 in 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 izroči le datoteke. Izroči vam dokument. Pošljite urejanje v preprostem jeziku prek izdanega urejevalnega endpointa:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Nekaj sekund pozneje imate nov video z eno spremenjeno sceno in vsem ostalim nedotaknjenim. Nova različica ostane v zgodovini iste razlage, tako da jo lahko pregledate ali povrnete prek API.
Sketchie zagotavlja strežnik MCP, tako da lahko kateri koli agent, ki podpira MCP, ustvarja in ureja razlagalne videe kot izvirna orodja: ustvarite iz dokumenta, preglejte scene graph, zahtevajte urejanje, ponovno upodobite. Če gradite agente, ki bi morali odgovarjati z videom namesto z zidom besedila, je to najkrajša obstoječa pot.
Izberite Nora, Miles, Dean, Clara, Piper ali Wren iz GET /v1/voices. Nora je topel privzeti pripovedovalec, vsak glas iz kataloga pa lahko govori vsak podprti jezik. Predogledi glasov so vključeni v odgovor kataloga.