Eitt POST set renderinga i kø. Poll posten eller lytt til den live statusstraumen, og motta deretter MP4-en og den fullt redigerbare scene graph-en hennar. Inkludert frå Plus og oppover, målt til 2x planminutt. Ingen 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"
} Oppretting er asynkron. API-et svarar med ein gong med 202 Accepted og ein post i kø.
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
} Hent GET /v1/explainer/:id til posten er ready, eller abonner på GET /v1/explainer/events for live statusoppdateringar. Den ferdige posten ber MP4-URL-en og 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 gjev deg ikkje berre ei fil. Det gjev deg eit dokument. Send ei redigering på vanleg språk via det leverte redigeringsendepunktet:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Sekund seinare har du ein ny video med éin scene endra og alt anna urørt. Den nye versjonen blir verande i historikken til same forklaring, så du kan inspisere eller tilbakestille henne via API-et.
Sketchie leverer ein MCP-tenar, så kvar MCP-kapabel agent kan generere og redigere forklaringsvideoar som innebygde verktøy: generer frå eit dokument, inspiser scene graph, be om ei redigering, render på nytt. Om du byggjer agentar som burde svare med video i staden for ein vegg av tekst, er dette den kortaste vegen som finst.
Vel Nora, Miles, Dean, Clara, Piper eller Wren frå GET /v1/voices. Nora er den varme standardforteljaren, og kvar katalogstemme kan snakke kvart støtta språk. Stemmeførehandsvisingar er inkluderte i katalogsvaret.