एक POST रेंडर को कतार में डालता है। रिकॉर्ड को पोल करें या लाइव स्थिति स्ट्रीम सुनें, फिर 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 आपको सिर्फ एक फ़ाइल नहीं देता। यह आपको एक दस्तावेज़ देता है। शिप किए गए एडिट एंडपॉइंट के माध्यम से एक सरल-भाषा संपादन भेजें:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } कुछ सेकंड बाद आपके पास एक नया वीडियो होता है जिसमें एक दृश्य बदला हुआ और बाकी सब अछूता होता है। नया संस्करण उसी व्याख्यात्मक के इतिहास में रहता है, इसलिए आप इसे API के माध्यम से जांच या वापस कर सकते हैं।
Sketchie एक MCP सर्वर शिप करता है, इसलिए कोई भी MCP-सक्षम एजेंट व्याख्यात्मक वीडियो को नेटिव टूल के रूप में बना और संपादित कर सकता है: दस्तावेज़ से बनाएं, scene graph जांचें, संपादन का अनुरोध करें, फिर से रेंडर करें। यदि आप ऐसे एजेंट बना रहे हैं जिन्हें टेक्स्ट की दीवार के बजाय वीडियो से जवाब देना चाहिए, तो यह मौजूद सबसे छोटा रास्ता है।
GET /v1/voices से Nora, Miles, Dean, Clara, Piper, या Wren चुनें। Nora गर्म डिफ़ॉल्ट वाचक है, और कैटलॉग की हर आवाज़ हर समर्थित भाषा बोल सकती है। आवाज़ पूर्वावलोकन कैटलॉग प्रतिक्रिया में शामिल हैं।