یو POST render په کتار کې اچوي. ریکارډ poll کړئ یا مستقیم حالت stream ته غوږ ونیسئ، بیا MP4 او د هغه بشپړ د سمون وړ scene graph ترلاسه کړئ. له Plus څخه پورته شامل، د پلان دقیقو 2x کې اندازه کیږي. هیڅ لږترلږه نشته.
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"
} جوړول ناهمغږي دي. API سمدلاسه د 202 Accepted او په کتار کې د یوه ریکارډ سره ځواب ورکوي.
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
} تر هغه چې ریکارډ ready شي GET /v1/explainer/:id راوباسئ، یا د مستقیم حالت تازه معلوماتو لپاره GET /v1/explainer/events ته ګډون وکړئ. چمتو ریکارډ د MP4 URL او 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 تاسو ته یوازې فایل نه درکوي. تاسو ته یو سند درکوي. د خپور شوي سمون endpoint له لارې په ساده ژبه یو سمون واستوئ:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } څو ثانیې وروسته تاسو یو نوی ویډیو لرئ چې یو صحنه یې بدله شوې او پاتې هرڅه نه لمس شوي. نوې نسخه د ورته تشریح په تاریخ کې پاتې کیږي، نو تاسو یې د API له لارې کتلی یا بیرته راوستلی شئ.
Sketchie یو MCP سرور وړاندې کوي، نو هر MCP-وړ اجنټ کولی شي تشریحي ویډیوګانې د اصلي وسیلو په توګه جوړ او سم کړي: له سند څخه جوړ کړئ، scene graph وګورئ، د سمون غوښتنه وکړئ، بیا render کړئ. که تاسو داسې اجنټان جوړوئ چې باید د متن د دیوال پر ځای په ویډیو ځواب ورکړي، نو دا شته ترټولو لنډ لار ده.
له GET /v1/voices څخه Nora، Miles، Dean، Clara، Piper یا Wren وټاکئ. Nora ګرم اصلي داستان ویونکې ده، او د کاتالوګ هر غږ کولی شي هره ملاتړ شوې ژبه وغږوي. د غږ مخکتنې د کاتالوګ په ځواب کې شاملې دي.