एकटा 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 गरम डिफॉल्ट वाचक अछि, आ कैटलॉगक हर आवाज हर समर्थित भाषा बाजि सकैत अछि। आवाज पूर्वावलोकन कैटलॉग जवाबमे शामिल अछि।