Një POST e vendos renderimin në radhë. Kërkoni regjistrimin ose dëgjoni transmetimin e statusit të drejtpërdrejtë, pastaj merrni MP4-in dhe scene graph-un e tij plotësisht të redaktueshëm. I përfshirë nga Plus e lart, matur në 2x minuta plani. Pa 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"
} Krijimi është asinkron. API përgjigjet menjëherë me 202 Accepted dhe një regjistrim në radhë.
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
} Merrni GET /v1/explainer/:id derisa regjistrimi të jetë ready, ose abonohuni te GET /v1/explainer/events për përditësime statusi të drejtpërdrejta. Regjistrimi i gatshëm mban URL-në e MP4-it dhe scene graph-un.
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 nuk ju jep thjesht një skedar. Ju jep një dokument. Dërgoni një redaktim në gjuhë të thjeshtë përmes endpoint-it të redaktimit të dërguar:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Sekonda më vonë keni një video të re me një skenë të ndryshuar dhe gjithçka tjetër të paprekur. Versioni i ri qëndron në historikun e të njëjtit shpjegues, kështu që mund ta inspektoni ose ta riktheni përmes API-t.
Sketchie dërgon një server MCP, kështu që çdo agjent i aftë për MCP mund të gjenerojë dhe redaktojë video shpjeguese si mjete vendase: gjeneroni nga një dokument, inspektoni scene graph-un, kërkoni një redaktim, renderoni sërish. Nëse ndërtoni agjentë që duhet të përgjigjen me video në vend të një muri teksti, ky është rruga më e shkurtër që ekziston.
Zgjidhni Nora, Miles, Dean, Clara, Piper ose Wren nga GET /v1/voices. Nora është tregimtari i ngrohtë i parazgjedhur, dhe çdo zë i katalogut mund të flasë çdo gjuhë të mbështetur. Pamjet paraprake të zërave përfshihen në përgjigjen e katalogut.