En POST köar renderingen. Polla posten eller lyssna på live-statusströmmen, och ta sedan emot MP4:en och dess fullt redigerbara scene graph. Ingår från Plus och uppåt, mätt till 2x planminuter. Inget minimum.
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"
} Skapandet är asynkront. API:et svarar omedelbart med 202 Accepted och en köad post.
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
} Hämta GET /v1/explainer/:id tills posten är ready, eller prenumerera på GET /v1/explainer/events för live-statusuppdateringar. Den färdiga posten bär MP4-URL:en och scene graph-en.
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:et räcker dig inte bara en fil. Det räcker dig ett dokument. Skicka en redigering i vardagligt språk via det levererade redigeringsendpointet:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Sekunder senare har du en ny video med en scen ändrad och allt annat orört. Den nya versionen stannar i samma förklarings historik, så du kan inspektera eller återställa den via API:et.
Sketchie levererar en MCP-server, så vilken MCP-kapabel agent som helst kan generera och redigera förklaringsvideor som inbyggda verktyg: generera från ett dokument, inspektera scene graph-en, begära en redigering, rendera om. Om du bygger agenter som borde svara med video istället för en vägg av text är detta den kortaste vägen som finns.
Välj Nora, Miles, Dean, Clara, Piper eller Wren från GET /v1/voices. Nora är den varma standardberättaren, och varje katalogröst kan tala varje språk som stöds. Röstförhandsvisningar ingår i katalogsvaret.